dsh-scheduled-message 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 intelfabs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,113 @@
+# dsh-scheduled-message
+
+Schedule the message you are already writing in the DSH composer — text, images and files — to be
+delivered later by the **Host**. Because the timer and the store live in the Host, closing the tab or
+the window does not cancel anything, and a message whose time passed while DSH was closed is sent at
+the next start and marked **sent late**.
+
+Normal sending is untouched: Enter, Shift+Enter, Ctrl/Cmd+Enter and the Send button keep exactly
+their current meaning.
+
+![The Schedule message dialog: message preview, quick picks, date and 12-hour time, the "Sends …" summary and the Repeat row](docs/preview.png)
+
+## What you get
+
+| Surface | Behaviour |
+|---|---|
+| **Schedule** button | Orange pill beside Send in the composer tool row. Disabled while the draft is empty or the composer is busy. |
+| **Alt+Enter** (Option+Enter on macOS) | Opens the same dialog. Registered as an editable-region shortcut, editable in Settings › Shortcuts. |
+| **Dialog** | Date, hour 1–12, minute, AM/PM, quick picks, a "Sends …" summary, and an optional **Repeat** row. Backdrop/Escape close, focus returns to the composer. |
+| **Strip** | Above the composer: `2 scheduled · next Fri, 14 Nov, 9:00 am`, expandable to rows with **Send now**, **Change time**, **Cancel**, and **Retry** for a failed delivery. |
+| **Repeat** | Creates a task in DSH's own Automation service and opens its task page. Blocked when the draft has images or files. |
+| **Phone** | Bottom sheet under 640 px, 44 px targets, 16 px inputs (no zoom-on-focus), safe-area padding. |
+| **Theme** | Host tokens for every surface and text colour; the accent orange is the only literal colour. English and Chinese dictionaries ship complete. |
+
+## Install
+
+The package is a normal DSH plugin bundle: a Host half (`index.js`), a browser half
+(`client.js`), and one patch entry.
+
+```sh
+# 1. put the package where the profile can resolve it
+cp -r dsh-scheduled-message ~/.dsh/profiles/desktop/node_modules/dsh-scheduled-message
+
+# 2. add it to the profile's dependencies and bundle list (package.json)
+#    "dsh-scheduled-message": "file:./node_modules/dsh-scheduled-message"
+#    "dsh": { "profile": { "bundles": [ …, "dsh-scheduled-message" ] } }
+
+# 3. restart DSH
+```
+
+With the plugin manager available, `install_bundle` with this directory as the target does the same
+thing and reports `application: applied`.
+
+Registering the row directly, without touching `dsh.profile.bundles`, also works — the bundle ships
+`cordis.patch.yml`:
+
+```yaml
+- insert:
+    - id: dsh-scheduled-message
+      name: dsh-scheduled-message
+```
+
+## Using it
+
+1. Type the message and attach anything you want.
+2. Press **Alt+Enter**, or click **Schedule**.
+3. Pick a date and a time on the 12-hour clock, or use a quick pick.
+4. Press **Schedule**. The draft and its attachments are cleared and the message appears in the strip.
+5. Close the tab whenever you like. Delivery is the Host's job.
+
+Tick **Repeat** instead to create an Automation task: daily, weekdays, weekly on the chosen weekday,
+or monthly on the chosen day. Monthly rules on the 29th–31st skip months that are too short.
+
+## What it does not do
+
+- **No repeating messages with attachments.** The Automation service delivers text only, so the UI
+  and the Host validator both refuse that combination.
+- **No auto-retry.** A failed delivery is reported with its reason; **Retry** is a user action.
+- **No polling.** The strip refreshes on mount, after an action, on window focus, and once shortly
+  after the next due time.
+- **No cross-zone surprise.** The browser's IANA zone is captured at create time and only used for
+  display and for the 12-hour reading; the Host stores one absolute instant.
+- **Disabling the plugin does not delete anything.** Pending records stay in storage and resume when
+  the plugin is enabled again.
+
+## Layout
+
+```
+index.js              Host half: durable store, six /api routes, timer, delivery
+client.js             browser bundle (generated — see scripts/build-client.mjs)
+client.src.js         browser half source (button, dialog, strip, shortcut, styles)
+lib/core.js           dependency-free shared logic: 12-hour clock, zone resolution,
+                      validation, RRULE text, timer chunking, retention
+locale/en.json        English dictionary
+locale/zh.json        Chinese dictionary
+scripts/build-client.mjs   inlines lib/core.js + locale/*.json into client.js
+scripts/check.mjs     static gates (parse, bundle freshness, locale coverage, exports)
+scripts/host-smoke.mjs     end-to-end Host test against in-memory services
+test/*.test.mjs       node --test suites
+docs/DETAIL.md        design notes, API evidence, and what is still unverified
+```
+
+## Development
+
+```sh
+npm run build     # regenerate client.js after editing client.src.js, lib/core.js or locale/*.json
+npm test          # unit + bundle + Host smoke tests
+npm run check     # static gates
+```
+
+## Status
+
+`0.1.1`. 33 automated tests and the static gates pass. 0.1.1 fixes the composer button: it now reads
+the draft through the composer slot's standard `useInput` hook, so it enables as soon as you type
+(0.1.0 read a `props.input` that `conversation.input.right` never passes and stayed disabled).
+
+The plugin was also booted inside an isolated DSH `0.2.2-rc.2` web instance: it loaded, its client
+bundle was served into the page's boot graph, a real scheduled message was created, stored, delivered
+on time and, in a second cycle with the Host stopped past the due instant, delivered at startup and
+marked **sent late**; Repeat created a real Automation task. The dialog itself renders in a live composer —
+the screenshot above is the real thing, not a mock — while Alt+Enter and the strip have not been
+separately observed. See
+[`docs/DETAIL.md`](docs/DETAIL.md#7-verification) for the exact list.