@plurnk/plurnk-schedule 1.19.0

package/dist/rules.js

@@ -0,0 +1,130 @@
+// {§schedule-rule} — a rule is RFC 5545 text: an optional DTSTART line and one RRULE line (bare
+// `FREQ=…` parts are the RRULE line), with EXDATE/RDATE lines admitted. The recurrence library
+// owns the grammar and the expansion; this module owns what the library is lenient about — unknown
+// RRULE parts, extra lines, a DTSTART the effective zone must stamp ({§schedule-zone}) — and the
+// bound a workspace rule must carry ({§schedule-bound}).
+import { RRuleTemporal } from "rrule-temporal";
+import { toText } from "rrule-temporal/totext";
+import { zoned } from "./temporal.js";
+const RRULE_PARTS = new Set([
+    "FREQ", "UNTIL", "COUNT", "INTERVAL", "BYSECOND", "BYMINUTE", "BYHOUR", "BYDAY",
+    "BYMONTHDAY", "BYYEARDAY", "BYWEEKNO", "BYMONTH", "BYSETPOS", "WKST",
+]);
+const DTSTART = /^DTSTART(?:;TZID=([^:]+))?:(\d{8}T\d{6})(Z?)$/u;
+const RRULE = /^(?:RRULE:)?([A-Z]+=[^;=]+(?:;[A-Z]+=[^;=]+)*)$/u;
+const DATE_LIST = /^(?:EXDATE|RDATE)(?:;[^:]+)?:.+$/u;
+export class ScheduleRuleError extends Error {
+    code;
+    constructor(code, detail, cause) {
+        super(detail, cause === undefined ? undefined : { cause });
+        this.name = "ScheduleRuleError";
+        this.code = code;
+    }
+}
+const messageOf = (cause) => cause instanceof Error ? cause.message : String(cause);
+const invalid = (detail, cause) => new ScheduleRuleError("rule-invalid", `The rule is not a readable RFC 5545 recurrence: ${detail}.`, cause);
+// The rule's lines, checked by name: the library drops unknown RRULE parts and extra RRULE lines
+// silently, and the DTSTART form decides how the zone applies.
+const readLines = (text) => {
+    let dtstart = null;
+    let rrule = null;
+    const dateLists = [];
+    for (const line of text.split(/\r?\n/u).map((raw) => raw.trim()).filter((raw) => raw.length > 0)) {
+        const start = DTSTART.exec(line);
+        if (start !== null) {
+            if (dtstart !== null)
+                throw invalid("it carries more than one DTSTART");
+            dtstart = start;
+            continue;
+        }
+        if (DATE_LIST.test(line)) {
+            dateLists.push(line);
+            continue;
+        }
+        const match = RRULE.exec(line);
+        if (match === null)
+            throw invalid(`the line '${line}' is neither DTSTART, RRULE, EXDATE nor RDATE`);
+        if (rrule !== null)
+            throw invalid("it carries more than one RRULE");
+        const unknown = match[1].split(";").map((part) => part.split("=")[0]).filter((name) => !RRULE_PARTS.has(name));
+        if (unknown.length > 0)
+            throw invalid(`RRULE has no part named ${unknown.join(", ")}`);
+        rrule = match[1];
+    }
+    if (rrule === null)
+        throw invalid("it has no RRULE line");
+    return { dtstart, rrule, dateLists };
+};
+export const assertZone = (zone) => {
+    try {
+        zoned(0, zone);
+    }
+    catch (cause) {
+        throw new ScheduleRuleError("zone-unknown", `'${zone}' is not a time zone the runtime knows; use an IANA name.`, cause);
+    }
+};
+const fromRule = (rule) => {
+    const options = rule.options();
+    if (options.tzid === undefined)
+        throw new Error("the recurrence library resolved a rule without a zone");
+    return {
+        text: rule.toString(),
+        zone: options.tzid,
+        bounded: options.count !== undefined || options.until !== undefined,
+        rule,
+    };
+};
+// Canonical text back into a rule; the text is the family's own, so a failure is a defect.
+export const parseRule = (text) => {
+    try {
+        return fromRule(new RRuleTemporal({ rruleString: text, strict: true }));
+    }
+    catch (cause) {
+        throw invalid(messageOf(cause), cause);
+    }
+};
+// Authored text into a canonical rule. Without a DTSTART the rule starts at the next whole second
+// in the effective zone, so its first occurrence is still ahead; a floating DTSTART is read in that
+// zone; a zoned or UTC DTSTART keeps its own.
+export const normalizeRule = (text, zone, nowMs) => {
+    assertZone(zone);
+    const { dtstart, rrule, dateLists } = readLines(text);
+    if (dtstart?.[1] !== undefined)
+        assertZone(dtstart[1]);
+    let rule;
+    try {
+        if (dtstart === null) {
+            const start = zoned(nowMs, zone).round({ smallestUnit: "second", roundingMode: "floor" }).add({ seconds: 1 });
+            rule = new RRuleTemporal({ rruleString: [`RRULE:${rrule}`, ...dateLists].join("\n"), dtstart: start, strict: true });
+        }
+        else {
+            const floating = dtstart[1] === undefined && dtstart[3] === "";
+            rule = new RRuleTemporal({
+                rruleString: [dtstart[0], `RRULE:${rrule}`, ...dateLists].join("\n"),
+                ...(floating ? { tzid: zone } : {}),
+                strict: true,
+            });
+        }
+    }
+    catch (cause) {
+        throw invalid(messageOf(cause), cause);
+    }
+    return parseRule(rule.toString());
+};
+// The first occurrence strictly after an instant; null once the rule is exhausted.
+export const nextOccurrence = (parsed, afterMs) => parsed.rule.next(zoned(afterMs, parsed.zone)) ?? null;
+export const upcoming = (parsed, afterMs, limit) => {
+    const occurrences = [];
+    let cursor = zoned(afterMs, parsed.zone);
+    while (occurrences.length < limit) {
+        const next = parsed.rule.next(cursor);
+        if (next === null || next === undefined)
+            break;
+        occurrences.push(next);
+        cursor = next;
+    }
+    return occurrences;
+};
+// The rule in words; the zone abbreviation is left out because the zone is named beside it.
+export const describeRule = (parsed) => toText(parsed.rule, undefined, { excludeTzAbbreviation: true });
+//# sourceMappingURL=rules.js.map

package/dist/rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.js","sourceRoot":"","sources":["../src/rules.ts"],"names":[],"mappings":"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"}

package/dist/temporal.d.ts

@@ -0,0 +1,13 @@
+import type { TemporalImplementation, TemporalZonedDateTime } from "rrule-temporal";
+export interface TemporalRuntime extends TemporalImplementation<TemporalZonedDateTime> {
+    readonly Instant: {
+        fromEpochMilliseconds(epochMilliseconds: number): {
+            toZonedDateTimeISO(timeZone: string): TemporalZonedDateTime;
+        };
+    };
+}
+declare const runtime: TemporalRuntime | undefined;
+export default runtime;
+export declare const zoned: (epochMilliseconds: number, zone: string) => TemporalZonedDateTime;
+export declare const isoString: (moment: TemporalZonedDateTime) => string;
+//# sourceMappingURL=temporal.d.ts.map

package/dist/temporal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal.d.ts","sourceRoot":"","sources":["../src/temporal.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEpF,MAAM,WAAW,eAAgB,SAAQ,sBAAsB,CAAC,qBAAqB,CAAC;IAClF,QAAQ,CAAC,OAAO,EAAE;QACd,qBAAqB,CAAC,iBAAiB,EAAE,MAAM,GAAG;YAC9C,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,qBAAqB,CAAC;SAC/D,CAAC;KACL,CAAC;CACL;AAED,QAAA,MAAM,OAAO,6BAAqE,CAAC;eAGpE,OAAO;AAGtB,eAAO,MAAM,KAAK,sBAAuB,MAAM,QAAQ,MAAM,KAAG,qBACqB,CAAC;AAGtF,eAAO,MAAM,SAAS,WAAY,qBAAqB,KAAG,MAAqD,CAAC"}

package/dist/temporal.js

@@ -0,0 +1,9 @@
+const runtime = globalThis.Temporal;
+if (runtime === undefined)
+    throw new Error("@plurnk/plurnk-schedule requires a runtime with Temporal (Node 26 or later).");
+export default runtime;
+// One instant read in one IANA zone; an unknown zone is the runtime's RangeError.
+export const zoned = (epochMilliseconds, zone) => runtime.Instant.fromEpochMilliseconds(epochMilliseconds).toZonedDateTimeISO(zone);
+// The wire form of an occurrence: RFC 9557 with the zone name, to the second.
+export const isoString = (moment) => moment.toString({ smallestUnit: "second" });
+//# sourceMappingURL=temporal.js.map

package/dist/temporal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal.js","sourceRoot":"","sources":["../src/temporal.ts"],"names":[],"mappings":"AAaA,MAAM,OAAO,GAAI,UAAwD,CAAC,QAAQ,CAAC;AACnF,IAAI,OAAO,KAAK,SAAS;IAAE,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;AAE3H,eAAe,OAAO,CAAC;AAEvB,kFAAkF;AAClF,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,iBAAyB,EAAE,IAAY,EAAyB,EAAE,CACpF,OAAO,CAAC,OAAO,CAAC,qBAAqB,CAAC,iBAAiB,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;AAEtF,8EAA8E;AAC9E,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,MAA6B,EAAU,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,CAAC"}

package/docs/schedule.md

@@ -0,0 +1,62 @@
+# schedule
+
+A schedule delivers a message to a worker at each occurrence of a recurrence
+rule. The rule is RFC 5545 text, the `RRULE` grammar calendars use, and the
+message arrives like any other, from `schedule://<alias>`, joining the
+worker's live loop or starting one. Your packet carries no clock: `discover`
+tells the time when you ask.
+
+## When to reach for a schedule
+
+- Work that recurs on the calendar: a daily summary, an hourly check, one
+  reminder at a set time.
+- Something external to wait for that sends no signal: schedule the check
+  instead of polling from inside a loop.
+- Not for a child worker or a task you started: those wake you when they
+  conclude.
+
+## discover: read the time, preview a rule
+
+`discover` takes `{"source": "<rule text>"}` and returns one inert candidate.
+Its summary opens with the current time in the effective zone and previews
+the first occurrences; its definition carries the rule as it would be stored.
+Nothing is persisted.
+
+````schedule (discover) <!-- what time is it, and when would this fire -->
+{"source": "FREQ=DAILY;BYHOUR=9;BYMINUTE=0;BYSECOND=0;COUNT=20"}
+````
+
+## add
+
+`add` persists the rule for this workspace and arms it. It is a host
+effect: it proposes and runs only on acceptance.
+
+````schedule (add)
+{"alias": "standup", "definition": {"rule": "FREQ=DAILY;BYHOUR=9;BYMINUTE=0;BYSECOND=0;COUNT=20", "target": "worker://scribe", "prompt": "Summarize yesterday's log entries for the team."}}
+````
+
+- `rule`: bare `FREQ=…` parts, or a `DTSTART` line and an `RRULE` line. A
+  workspace rule ends: give it `COUNT` or `UNTIL`. Without a `DTSTART` the
+  rule starts at the next whole second when added; `BYHOUR`, `BYMINUTE`,
+  `BYSECOND` and `BYDAY` place it.
+- `target`: the worker that receives the message, `worker://<name>`; any
+  worker in this workspace, yourself included.
+- `prompt`: the message delivered at each occurrence.
+- `policy`: `{"proposals": "accept"}` when the delivery starts a loop no one
+  is watching and it must act on its own proposals; absent, the worker's
+  default holds.
+
+Times are read in `TZ`: the workspace's `env` family sets it for every rule
+and every command; UTC otherwise.
+
+## list, enable, disable, remove
+
+`list` shows each rule with its zone, its wording, and its next occurrence,
+or `exhausted` once it has run out. A rule that could not deliver, because its
+worker is gone, is `unavailable` with the exact Problem; `enable` retries it.
+`disable` disarms without forgetting; `remove` forgets.
+
+## Receiving a scheduled message
+
+It arrives as an open message from `schedule://<alias>`, in the loop you are
+in or in a new one. Answer it as you would any message.

package/package.json

@@ -0,0 +1,62 @@
+{
+    "name": "@plurnk/plurnk-schedule",
+    "version": "1.19.0",
+    "description": "Scheduled messages for Plurnk workers, on RFC 5545 recurrence rules",
+    "type": "module",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/plurnk/plurnk-service.git",
+        "directory": "plurnk-schedule"
+    },
+    "exports": {
+        ".": {
+            "plurnk-dev": "./src/index.ts",
+            "types": "./dist/index.d.ts",
+            "default": "./dist/index.js"
+        },
+        "./package.json": "./package.json"
+    },
+    "files": [
+        ".env.defaults",
+        "dist/**/*",
+        "docs/**/*",
+        "README.md",
+        "SPEC.md"
+    ],
+    "engines": {
+        "node": ">=26"
+    },
+    "scripts": {
+        "test": "npm run test:lint && npm run test:unit && npm run test:intg",
+        "test:lint": "tsc --noEmit",
+        "test:unit": "node --conditions=plurnk-dev --env-file=.env.defaults --test src/*.test.ts",
+        "test:intg": "PLURNK_TEST_RUN=$(date -u +%Y%m%dT%H%M%SZ) node --conditions=plurnk-dev --env-file=.env.defaults --test test/intg/*.test.ts",
+        "build:clean": "rm -rf dist",
+        "build:dist": "tsc -p tsconfig.build.json",
+        "build": "npm run build:clean && npm run build:dist",
+        "prepack": "npm run build",
+        "prepublishOnly": "npm audit --audit-level=moderate && npm test"
+    },
+    "dependencies": {
+        "rrule-temporal": "2.2.6"
+    },
+    "peerDependencies": {
+        "@plurnk/plurnk-contracts": "^1.19.0",
+        "@plurnk/plurnk-schemes": "^1.19.0"
+    },
+    "keywords": [
+        "plurnk",
+        "schedule",
+        "rrule",
+        "recurrence"
+    ],
+    "homepage": "https://github.com/plurnk/plurnk-service/tree/main/plurnk-schedule#readme",
+    "bugs": {
+        "url": "https://repo.possumtech.com/plurnk/plurnk-service/issues"
+    },
+    "author": "@wikitopian",
+    "publishConfig": {
+        "access": "public"
+    }
+}