@plurnk/plurnk-schedule 1.19.0

package/dist/ScheduleResources.d.ts

@@ -0,0 +1,14 @@
+import { type RepresentationPreparationRequest, type RepresentationPreparationResult, type SchemeCtx } from "@plurnk/plurnk-schemes";
+type RuleList = (workspaceId: number) => Promise<readonly {
+    alias: string;
+    state: string;
+    [key: string]: unknown;
+}[]>;
+export default class ScheduleResources {
+    #private;
+    constructor(list: RuleList);
+    claims(pathname: string): boolean;
+    prepareRepresentation(request: RepresentationPreparationRequest, ctx: SchemeCtx): Promise<RepresentationPreparationResult>;
+}
+export {};
+//# sourceMappingURL=ScheduleResources.d.ts.map

package/dist/ScheduleResources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScheduleResources.d.ts","sourceRoot":"","sources":["../src/ScheduleResources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,gCAAgC,EAAE,KAAK,+BAA+B,EAAE,KAAK,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAE9I,KAAK,QAAQ,GAAG,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,EAAE,CAAC,CAAC;AAGtH,MAAM,CAAC,OAAO,OAAO,iBAAiB;;IAGlC,YAAY,IAAI,EAAE,QAAQ,EAEzB;IAED,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEhC;IAEK,qBAAqB,CAAC,OAAO,EAAE,gCAAgC,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,+BAA+B,CAAC,CAO/H;CACJ"}

package/dist/ScheduleResources.js

@@ -0,0 +1,22 @@
+import { Results } from "@plurnk/plurnk-schemes";
+// The readable rule resources, `schedule:///rules/<alias>`; an occurrence is a message, never a wait.
+export default class ScheduleResources {
+    #list;
+    constructor(list) {
+        this.#list = list;
+    }
+    claims(pathname) {
+        return /^\/rules(?:\/|$)/u.test(pathname);
+    }
+    async prepareRepresentation(request, ctx) {
+        if (request.authority !== "")
+            return Results.failure("schedule:resource", "authority-invalid", 400, "Schedule resources use an empty authority.");
+        const { pathname } = request;
+        const content = (await this.#list(ctx.workspaceId)).find((rule) => pathname === `/rules/${encodeURIComponent(rule.alias)}`);
+        if (content === undefined)
+            return Results.failure("schedule:resource", "not-found", 404, "The schedule resource does not exist.");
+        const result = await ctx.entries.write(pathname, { channels: { results: { content: JSON.stringify(content, null, 2), mimetype: "application/json" } } });
+        return result.status >= 400 ? { status: result.status, problem: result.problem } : { status: 200 };
+    }
+}
+//# sourceMappingURL=ScheduleResources.js.map

package/dist/ScheduleResources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScheduleResources.js","sourceRoot":"","sources":["../src/ScheduleResources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAA+F,MAAM,wBAAwB,CAAC;AAI9I,sGAAsG;AACtG,MAAM,CAAC,OAAO,OAAO,iBAAiB;IACzB,KAAK,CAAW;IAEzB,YAAY,IAAc;QACtB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACtB,CAAC;IAED,MAAM,CAAC,QAAgB;QACnB,OAAO,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,qBAAqB,CAAC,OAAyC,EAAE,GAAc;QACjF,IAAI,OAAO,CAAC,SAAS,KAAK,EAAE;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,mBAAmB,EAAE,mBAAmB,EAAE,GAAG,EAAE,4CAA4C,CAAC,CAAC;QAClJ,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;QAC7B,MAAM,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,KAAK,UAAU,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC5H,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,mBAAmB,EAAE,WAAW,EAAE,GAAG,EAAE,uCAAuC,CAAC,CAAC;QAClI,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,kBAAkB,EAAE,EAAE,EAAE,CAAC,CAAC;QACzJ,OAAO,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IACvG,CAAC;CACJ"}

package/dist/Scheduler.d.ts

@@ -0,0 +1,51 @@
+import { type LoopPolicyRequest, type ProblemDetails } from "@plurnk/plurnk-contracts";
+import { type ScheduleDefinition } from "./definition.ts";
+import { type ParsedRule } from "./rules.ts";
+export interface ScheduledRule {
+    readonly alias: string;
+    readonly definition: ScheduleDefinition;
+    readonly parsed: ParsedRule;
+}
+export interface DeliveryPort {
+    listWorkers(workspaceId: number): Promise<readonly {
+        readonly id: number;
+        readonly name: string;
+    }[]>;
+    runLoop(args: {
+        readonly workspaceId: number;
+        readonly workerId: number;
+        readonly prompt: string;
+        readonly source: string;
+        readonly policy?: LoopPolicyRequest;
+    }): Promise<unknown>;
+}
+export interface SchedulerTimers {
+    set(callback: () => void, delayMs: number): unknown;
+    clear(handle: unknown): void;
+}
+export interface SchedulerOptions {
+    readonly clock?: () => number;
+    readonly timers?: SchedulerTimers;
+    readonly report?: (message: string, cause: unknown) => void;
+    readonly settled?: (workspaceId: number, alias: string) => void;
+}
+export interface ScheduleFailure {
+    readonly text: string;
+    readonly problem: ProblemDetails;
+}
+export declare class ScheduleDeliveryError extends Error {
+    readonly problem: ProblemDetails;
+    constructor(problem: ProblemDetails, cause?: unknown);
+}
+export default class Scheduler {
+    #private;
+    constructor(options?: SchedulerOptions);
+    now(): number;
+    start(port: DeliveryPort): void;
+    close(): Promise<void>;
+    sync(workspaceId: number, rules: ReadonlyMap<string, ScheduledRule>): Promise<void>;
+    failure(workspaceId: number, alias: string): ScheduleFailure | undefined;
+    forgive(workspaceId: number, alias: string): void;
+    armed(workspaceId: number): readonly string[];
+}
+//# sourceMappingURL=Scheduler.d.ts.map

package/dist/Scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Scheduler.d.ts","sourceRoot":"","sources":["../src/Scheduler.ts"],"names":[],"mappings":"AAKA,OAAO,EAAY,KAAK,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAGjG,OAAO,EAAoB,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC5E,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7D,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IACzB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAAC;IACrG,OAAO,CAAC,IAAI,EAAE;QACV,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC;KACvC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC5B,GAAG,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IACpD,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAE5D,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnE;AAED,MAAM,WAAW,eAAe;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;CACpC;AAWD,qBAAa,qBAAsB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAEjC,YAAY,OAAO,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,OAAO,EAInD;CACJ;AAoBD,MAAM,CAAC,OAAO,OAAO,SAAS;;IAa1B,YAAY,OAAO,GAAE,gBAAqB,EAKzC;IAED,GAAG,IAAI,MAAM,CAEZ;IAED,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAI9B;IAQK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAQ3B;IAID,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBlF;IAED,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAEvE;IAED,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAEhD;IAED,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAE5C;CAqFJ"}

package/dist/Scheduler.js

@@ -0,0 +1,205 @@
+// {§schedule-delivery} — the timers. One armed occurrence per (workspace, alias); at its instant
+// the message is delivered to the target worker through the application port as an arrival with
+// the source `schedule://<alias>`, joining the worker's live loop or starting one. Then the next
+// occurrence arms from now: a late fire delivers once and skips what it missed, never a backlog.
+// A delivery failure disarms the rule and holds its Problem for the outcome; `enable` retries.
+import { Problems } from "@plurnk/plurnk-contracts";
+import { createHash } from "node:crypto";
+import { targetWorkerName } from "./definition.js";
+import { nextOccurrence } from "./rules.js";
+export class ScheduleDeliveryError extends Error {
+    problem;
+    constructor(problem, cause) {
+        super(problem.detail, cause === undefined ? undefined : { cause });
+        this.name = "ScheduleDeliveryError";
+        this.problem = problem;
+    }
+}
+// setTimeout's ceiling; a farther occurrence arms in hops.
+const MAX_DELAY_MS = 2_147_483_647;
+const DIAGNOSTIC_LIMIT = 512;
+const key = (workspaceId, alias) => `${workspaceId}:${alias}`;
+const SYSTEM_TIMERS = Object.freeze({
+    set: (callback, delayMs) => setTimeout(callback, delayMs).unref(),
+    clear: (handle) => { clearTimeout(handle); },
+});
+const problem = (code, status, detail, extensions = {}) => Problems.create("schedule:delivery", code, status, detail, { stage: "schedule-delivery", ...extensions });
+const problemOf = (alias, cause) => Problems.fromError(cause) ?? problem("delivery-failed", 502, `Delivering the scheduled message '${alias}' failed.`, { alias, diagnostic: (cause instanceof Error ? cause.message : String(cause)).slice(0, DIAGNOSTIC_LIMIT), retryable: true });
+export default class Scheduler {
+    #clock;
+    #timers;
+    #report;
+    #settled;
+    #armed = new Map();
+    #failures = new Map();
+    #pending = new Set();
+    #port = null;
+    #serial = Promise.resolve();
+    #closing = false;
+    #settlementErrors = [];
+    constructor(options = {}) {
+        this.#clock = options.clock ?? Date.now;
+        this.#timers = options.timers ?? SYSTEM_TIMERS;
+        this.#report = options.report ?? ((message, cause) => { console.error(`${message}:`, cause); });
+        this.#settled = options.settled ?? (() => { });
+    }
+    now() {
+        return this.#clock();
+    }
+    start(port) {
+        if (this.#port !== null)
+            throw new Error("schedule Scheduler already started");
+        this.#port = port;
+        this.#closing = false;
+    }
+    #exclusive(run) {
+        const result = this.#serial.then(run);
+        this.#serial = result.then(() => { }, () => { });
+        return result;
+    }
+    async close() {
+        this.#closing = true;
+        await this.#serial;
+        for (const { handle } of this.#armed.values())
+            if (handle !== null)
+                this.#timers.clear(handle);
+        this.#armed.clear();
+        await Promise.all(this.#pending);
+        this.#port = null;
+        if (this.#settlementErrors.length > 0)
+            throw new AggregateError(this.#settlementErrors, "Scheduled occurrence settlement failed.");
+    }
+    // {§schedule-residency} — a workspace's rule set as published: aliases absent from it disarm,
+    // unchanged occurrences retain identity. A held failure clears when its rule leaves the set or changes.
+    sync(workspaceId, rules) {
+        return this.#exclusive(async () => {
+            for (const [entryKey, armed] of this.#armed) {
+                if (armed.workspaceId !== workspaceId)
+                    continue;
+                const replacement = rules.get(armed.rule.alias);
+                if (replacement !== undefined && JSON.stringify(replacement.definition) === JSON.stringify(armed.rule.definition))
+                    continue;
+                if (armed.handle !== null)
+                    this.#timers.clear(armed.handle);
+                this.#armed.delete(entryKey);
+            }
+            for (const [entryKey, failed] of this.#failures) {
+                if (!entryKey.startsWith(`${workspaceId}:`))
+                    continue;
+                const rule = rules.get(entryKey.slice(entryKey.indexOf(":") + 1));
+                if (rule === undefined || rule.parsed.text !== failed.text)
+                    this.#failures.delete(entryKey);
+            }
+            for (const rule of rules.values()) {
+                if (this.#failures.has(key(workspaceId, rule.alias)))
+                    continue;
+                if (this.#armed.has(key(workspaceId, rule.alias)))
+                    continue;
+                this.#arm(workspaceId, rule);
+            }
+        });
+    }
+    failure(workspaceId, alias) {
+        return this.#failures.get(key(workspaceId, alias));
+    }
+    forgive(workspaceId, alias) {
+        this.#failures.delete(key(workspaceId, alias));
+    }
+    armed(workspaceId) {
+        return [...this.#armed.values()].filter((armed) => armed.workspaceId === workspaceId).map((armed) => armed.rule.alias).toSorted();
+    }
+    #arm(workspaceId, rule) {
+        if (this.#closing)
+            return;
+        const entryKey = key(workspaceId, rule.alias);
+        const existing = this.#armed.get(entryKey);
+        if (existing !== undefined) {
+            if (existing.handle !== null)
+                this.#timers.clear(existing.handle);
+            this.#armed.delete(entryKey);
+        }
+        const now = this.#clock();
+        const due = nextOccurrence(rule.parsed, now);
+        if (due === null)
+            return;
+        const dueMs = due.epochMilliseconds;
+        const fingerprint = createHash("sha256").update(JSON.stringify(rule.definition)).digest("hex");
+        const armed = { workspaceId, rule, dueMs, event: `${rule.alias}/${fingerprint}/${dueMs}`, handle: null, delivering: false };
+        this.#armed.set(entryKey, armed);
+        this.#setTimer(armed);
+    }
+    #setTimer(armed) {
+        armed.handle = this.#timers.set(() => { this.#fire(armed); }, Math.max(0, Math.min(armed.dueMs - this.#clock(), MAX_DELAY_MS)));
+    }
+    #fire(armed) {
+        const { workspaceId, rule } = armed;
+        const entryKey = key(workspaceId, rule.alias);
+        const delivery = (async () => {
+            const admitted = await this.#exclusive(async () => {
+                if (this.#closing || this.#armed.get(entryKey) !== armed || armed.delivering)
+                    return false;
+                if (this.#clock() < armed.dueMs) {
+                    this.#setTimer(armed);
+                    return false;
+                }
+                armed.handle = null;
+                armed.delivering = true;
+                return true;
+            });
+            if (!admitted)
+                return;
+            // Admission may demand workspace capabilities. Never hold the producer's
+            // mutation queue across that exterior call ({§schedule-delivery}).
+            let result;
+            try {
+                await this.#deliver(workspaceId, rule);
+                result = { status: 200 };
+            }
+            catch (cause) {
+                const failed = problemOf(rule.alias, cause);
+                result = { status: failed.status, problem: failed };
+                this.#report(`scheduled message '${rule.alias}' was not delivered in workspace ${workspaceId}`, cause);
+            }
+            await this.#exclusive(async () => {
+                if (this.#armed.get(entryKey) !== armed)
+                    return;
+                this.#armed.delete(entryKey);
+                if (result.status >= 400)
+                    this.#failures.set(entryKey, { text: rule.parsed.text, problem: result.problem });
+                else
+                    this.#arm(workspaceId, rule);
+            });
+        })()
+            .catch((cause) => {
+            this.#settlementErrors.push(cause);
+            this.#report(`scheduled occurrence '${rule.alias}' could not settle in workspace ${workspaceId}`, cause);
+        })
+            .finally(() => {
+            this.#pending.delete(delivery);
+            this.#settled(workspaceId, rule.alias);
+        });
+        this.#pending.add(delivery);
+    }
+    async #deliver(workspaceId, rule) {
+        const port = this.#port;
+        if (port === null)
+            throw new Error("schedule Scheduler is not started");
+        const name = targetWorkerName(rule.definition.target);
+        const worker = (await port.listWorkers(workspaceId)).find((candidate) => candidate.name === name);
+        if (worker === undefined) {
+            throw new ScheduleDeliveryError(problem("target-missing", 404, `No worker named '${name}' exists in this workspace.`, {
+                alias: rule.alias,
+                target: rule.definition.target,
+                retryable: true,
+            }));
+        }
+        await port.runLoop({
+            workspaceId,
+            workerId: worker.id,
+            prompt: rule.definition.prompt,
+            source: `schedule://${encodeURIComponent(rule.alias)}`,
+            ...(rule.definition.policy === undefined ? {} : { policy: rule.definition.policy }),
+        });
+    }
+}
+//# sourceMappingURL=Scheduler.js.map

package/dist/Scheduler.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,7 @@
+import { type ScheduleDefinition } from "./definition.ts";
+export declare const ENABLED = "PLURNK_SCHEDULE_ENABLED";
+export declare const PREVIEW_OCCURRENCES = "PLURNK_SCHEDULE_PREVIEW_OCCURRENCES";
+export declare const previewOccurrences: (env: NodeJS.ProcessEnv) => number;
+export declare const serviceEnabled: (env: NodeJS.ProcessEnv) => ReadonlySet<string>;
+export declare const serviceDefinitions: (env: NodeJS.ProcessEnv) => ReadonlyMap<string, ScheduleDefinition>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,OAAO,EAAmC,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAG3F,eAAO,MAAM,OAAO,4BAAqB,CAAC;AAC1C,eAAO,MAAM,mBAAmB,wCAAiC,CAAC;AA2BlE,eAAO,MAAM,kBAAkB,QAAS,MAAM,CAAC,UAAU,KAAG,MAO3D,CAAC;AAEF,eAAO,MAAM,cAAc,QAAS,MAAM,CAAC,UAAU,KAAG,WAAW,CAAC,MAAM,CASzE,CAAC;AAEF,eAAO,MAAM,kBAAkB,QAAS,MAAM,CAAC,UAAU,KAAG,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAejG,CAAC"}

package/dist/config.js

@@ -0,0 +1,73 @@
+// {§schedule-environment} — the service's own rules: `PLURNK_SCHEDULE_<ALIAS>` holds one
+// definition as JSON, the alias case-folded to the family grammar; `PLURNK_SCHEDULE_ENABLED`
+// names the aliases a workspace starts with. Service rules may be unbounded ({§schedule-bound}).
+import { readDefinition, DefinitionError } from "./definition.js";
+const PREFIX = "PLURNK_SCHEDULE_";
+export const ENABLED = `${PREFIX}ENABLED`;
+export const PREVIEW_OCCURRENCES = `${PREFIX}PREVIEW_OCCURRENCES`;
+// The family's own knobs; every other key under the prefix declares a rule.
+const CONTROLS = new Set([ENABLED, PREVIEW_OCCURRENCES]);
+const ALIAS = /^[a-z][a-z0-9-]*$/u;
+const parseEnvironment = (env) => {
+    const definitions = new Map();
+    for (const [key, value] of Object.entries(env)) {
+        if (value === undefined || !key.startsWith(PREFIX) || CONTROLS.has(key))
+            continue;
+        const alias = key.slice(PREFIX.length).toLowerCase();
+        if (!ALIAS.test(alias))
+            throw new Error(`${key} derives the alias '${alias}', which must match [a-z][a-z0-9-]*.`);
+        const existing = definitions.get(alias);
+        if (existing !== undefined)
+            throw new Error(`${existing.key} and ${key} both derive the schedule alias '${alias}'.`);
+        definitions.set(alias, { key, value });
+    }
+    return definitions;
+};
+const parseJson = (key, value) => {
+    try {
+        return JSON.parse(value);
+    }
+    catch (cause) {
+        throw new Error(`${key} is not JSON.`, { cause });
+    }
+};
+// {§schedule-discovery-preview} — how many upcoming occurrences a reading of rule text shows.
+export const previewOccurrences = (env) => {
+    const raw = env[PREVIEW_OCCURRENCES];
+    const value = Number(raw);
+    if (raw === undefined || raw.trim().length === 0 || !Number.isSafeInteger(value) || value < 1) {
+        throw new Error(`${PREVIEW_OCCURRENCES} must be a positive integer; got ${JSON.stringify(raw)}.`);
+    }
+    return value;
+};
+export const serviceEnabled = (env) => {
+    const raw = env[ENABLED];
+    if (raw === undefined)
+        throw new Error(`${ENABLED} is missing from the assembled environment floor.`);
+    const parsed = parseJson(ENABLED, raw);
+    if (!Array.isArray(parsed) || !parsed.every((entry) => typeof entry === "string")) {
+        throw new Error(`${ENABLED} must be a JSON array of aliases.`);
+    }
+    const definitions = parseEnvironment(env);
+    return new Set(parsed.filter((alias) => definitions.get(alias)?.value !== ""));
+};
+export const serviceDefinitions = (env) => {
+    const definitions = new Map();
+    for (const [alias, { key, value }] of parseEnvironment(env)) {
+        if (value === "")
+            continue;
+        let definition;
+        try {
+            definition = readDefinition(parseJson(key, value));
+        }
+        catch (cause) {
+            if (!(cause instanceof DefinitionError))
+                throw cause;
+            throw new Error(`${key} must be a schedule definition: {"rule", "target", "prompt", "policy"?}.`, { cause });
+        }
+        definitions.set(alias, definition);
+    }
+    return new Map([...definitions]
+        .toSorted(([left], [right]) => left.localeCompare(right)));
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,6FAA6F;AAC7F,iGAAiG;AACjG,OAAO,EAAE,cAAc,EAAE,eAAe,EAA2B,MAAM,iBAAiB,CAAC;AAE3F,MAAM,MAAM,GAAG,kBAAkB,CAAC;AAClC,MAAM,CAAC,MAAM,OAAO,GAAG,GAAG,MAAM,SAAS,CAAC;AAC1C,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,MAAM,qBAAqB,CAAC;AAClE,4EAA4E;AAC5E,MAAM,QAAQ,GAAwB,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC;AAC9E,MAAM,KAAK,GAAG,oBAAoB,CAAC;AAEnC,MAAM,gBAAgB,GAAG,CAAC,GAAsB,EAA+C,EAAE;IAC7F,MAAM,WAAW,GAAG,IAAI,GAAG,EAA0C,CAAC;IACtE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7C,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAClF,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QACrD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,uBAAuB,KAAK,sCAAsC,CAAC,CAAC;QAClH,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,QAAQ,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,CAAC,GAAG,QAAQ,GAAG,oCAAoC,KAAK,IAAI,CAAC,CAAC;QACrH,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,WAAW,CAAC;AACvB,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,CAAC,GAAW,EAAE,KAAa,EAAW,EAAE;IACtD,IAAI,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,eAAe,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACtD,CAAC;AACL,CAAC,CAAC;AAEF,8FAA8F;AAC9F,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,GAAsB,EAAU,EAAE;IACjE,MAAM,GAAG,GAAG,GAAG,CAAC,mBAAmB,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC5F,MAAM,IAAI,KAAK,CAAC,GAAG,mBAAmB,oCAAoC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACtG,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,GAAsB,EAAuB,EAAE;IAC1E,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC;IACzB,IAAI,GAAG,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,mDAAmD,CAAC,CAAC;IACtG,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,EAAE,CAAC;QAChF,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,mCAAmC,CAAC,CAAC;IACnE,CAAC;IACD,MAAM,WAAW,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC1C,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC;AACnF,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,GAAsB,EAA2C,EAAE;IAClG,MAAM,WAAW,GAAG,IAAI,GAAG,EAA8B,CAAC;IAC1D,KAAK,MAAM,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,IAAI,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1D,IAAI,KAAK,KAAK,EAAE;YAAE,SAAS;QAC3B,IAAI,UAA8B,CAAC;QACnC,IAAI,CAAC;YACD,UAAU,GAAG,cAAc,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,CAAC,KAAK,YAAY,eAAe,CAAC;gBAAE,MAAM,KAAK,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,0EAA0E,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACjH,CAAC;QACD,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,IAAI,GAAG,CAAC,CAAC,GAAG,WAAW,CAAC;SAC1B,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnE,CAAC,CAAC"}

package/dist/definition.d.ts

@@ -0,0 +1,41 @@
+import { type LoopPolicyRequest } from "@plurnk/plurnk-contracts";
+export interface ScheduleDefinition {
+    readonly rule: string;
+    readonly target: string;
+    readonly prompt: string;
+    readonly policy?: LoopPolicyRequest;
+}
+export declare const TARGET: RegExp;
+export declare const DEFINITION_SCHEMA: Readonly<{
+    type: "object";
+    additionalProperties: false;
+    required: string[];
+    properties: {
+        rule: {
+            type: string;
+            minLength: number;
+            description: string;
+        };
+        target: {
+            type: string;
+            pattern: string;
+            description: string;
+        };
+        prompt: {
+            type: string;
+            minLength: number;
+            description: string;
+        };
+        policy: {
+            $ref: string;
+            description: string;
+        };
+    };
+}>;
+export declare class DefinitionError extends TypeError {
+    readonly errors: readonly unknown[];
+    constructor(errors: readonly unknown[]);
+}
+export declare const readDefinition: (value: unknown) => ScheduleDefinition;
+export declare const targetWorkerName: (target: string) => string;
+//# sourceMappingURL=definition.d.ts.map

package/dist/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../src/definition.ts"],"names":[],"mappings":"AAGA,OAAO,EAA2C,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE3G,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAED,eAAO,MAAM,MAAM,QAAqE,CAAC;AAEzF,eAAO,MAAM,iBAAiB;;;;;QAKtB,IAAI;YACA,IAAI;YACJ,SAAS;YACT,WAAW;;QAEf,MAAM;YACF,IAAI;YACJ,OAAO;YACP,WAAW;;QAEf,MAAM;YACF,IAAI;YACJ,SAAS;YACT,WAAW;;QAEf,MAAM;YACF,IAAI;YACJ,WAAW;;;EAGA,CAAC;AAExB,qBAAa,eAAgB,SAAQ,SAAS;IAC1C,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;IAEpC,YAAY,MAAM,EAAE,SAAS,OAAO,EAAE,EAIrC;CACJ;AAED,eAAO,MAAM,cAAc,UAAW,OAAO,KAAG,kBAI/C,CAAC;AAEF,eAAO,MAAM,gBAAgB,WAAY,MAAM,KAAG,MAIjD,CAAC"}

package/dist/definition.js

@@ -0,0 +1,52 @@
+// {§schedule-family} — the one definition `add` accepts and the coordinator persists: the rule
+// text ({§schedule-rule}), the worker the message is delivered to, the message, and optionally
+// what the delivery states about the policy of a loop it starts ({§schedule-delivery}).
+import { Validator, WORKER_NAME } from "@plurnk/plurnk-contracts";
+export const TARGET = new RegExp(`^worker://(${WORKER_NAME.source.slice(1, -1)})$`, "u");
+export const DEFINITION_SCHEMA = Object.freeze({
+    type: "object",
+    additionalProperties: false,
+    required: ["rule", "target", "prompt"],
+    properties: {
+        rule: {
+            type: "string",
+            minLength: 1,
+            description: "RFC 5545 text: an optional DTSTART line and one RRULE line, or bare FREQ=… parts. A workspace rule ends: COUNT or UNTIL.",
+        },
+        target: {
+            type: "string",
+            pattern: TARGET.source,
+            description: "The worker the message is delivered to.",
+        },
+        prompt: {
+            type: "string",
+            minLength: 1,
+            description: "The message delivered at each occurrence.",
+        },
+        policy: {
+            $ref: "https://schemas.plurnk.xyz/v0/LoopPolicyRequest.json",
+            description: "What the delivery states about the policy of a loop it starts; every field left out is the daemon's to supply.",
+        },
+    },
+});
+export class DefinitionError extends TypeError {
+    errors;
+    constructor(errors) {
+        super("The schedule definition does not match its schema.");
+        this.name = "DefinitionError";
+        this.errors = errors;
+    }
+}
+export const readDefinition = (value) => {
+    const validation = Validator.validateJsonSchemaInstance(DEFINITION_SCHEMA, value);
+    if (!validation.valid)
+        throw new DefinitionError(validation.errors);
+    return structuredClone(value);
+};
+export const targetWorkerName = (target) => {
+    const match = TARGET.exec(target);
+    if (match === null)
+        throw new TypeError(`'${target}' is not a worker:// target.`);
+    return match[1];
+};
+//# sourceMappingURL=definition.js.map

package/dist/definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../src/definition.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,+FAA+F;AAC/F,wFAAwF;AACxF,OAAO,EAAE,SAAS,EAAE,WAAW,EAA2C,MAAM,0BAA0B,CAAC;AAS3G,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,cAAc,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AAEzF,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,QAAQ;IACd,oBAAoB,EAAE,KAAK;IAC3B,QAAQ,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC;IACtC,UAAU,EAAE;QACR,IAAI,EAAE;YACF,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,CAAC;YACZ,WAAW,EAAE,0HAA0H;SAC1I;QACD,MAAM,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,MAAM,CAAC,MAAM;YACtB,WAAW,EAAE,yCAAyC;SACzD;QACD,MAAM,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,CAAC;YACZ,WAAW,EAAE,2CAA2C;SAC3D;QACD,MAAM,EAAE;YACJ,IAAI,EAAE,sDAAsD;YAC5D,WAAW,EAAE,gHAAgH;SAChI;KACJ;CACJ,CAAsB,CAAC;AAExB,MAAM,OAAO,eAAgB,SAAQ,SAAS;IACjC,MAAM,CAAqB;IAEpC,YAAY,MAA0B;QAClC,KAAK,CAAC,oDAAoD,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;CACJ;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAc,EAAsB,EAAE;IACjE,MAAM,UAAU,GAAG,SAAS,CAAC,0BAA0B,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;IAClF,IAAI,CAAC,UAAU,CAAC,KAAK;QAAE,MAAM,IAAI,eAAe,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACpE,OAAO,eAAe,CAAC,KAA2B,CAAC,CAAC;AACxD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAc,EAAU,EAAE;IACvD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,KAAK,KAAK,IAAI;QAAE,MAAM,IAAI,SAAS,CAAC,IAAI,MAAM,8BAA8B,CAAC,CAAC;IAClF,OAAO,KAAK,CAAC,CAAC,CAAE,CAAC;AACrB,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { default as Module, type ModuleOptions } from "./Module.ts";
+export { default as ScheduleFunctionality, SCHEDULE_FAMILY, SCHEDULE_OWNER, ScheduleFunctionalityError, type FunctionalityFamilyHandle, type ScheduleFunctionalityOptions, } from "./Functionality.ts";
+export { default as Scheduler, ScheduleDeliveryError, type DeliveryPort, type ScheduledRule, type SchedulerOptions, type SchedulerTimers, } from "./Scheduler.ts";
+export { assertZone, describeRule, nextOccurrence, normalizeRule, parseRule, ScheduleRuleError, upcoming, type ParsedRule, type ScheduleRuleCode, } from "./rules.ts";
+export { DEFINITION_SCHEMA, DefinitionError, readDefinition, targetWorkerName, type ScheduleDefinition } from "./definition.ts";
+export { ENABLED, serviceDefinitions, serviceEnabled } from "./config.ts";
+export { isoString, zoned } from "./temporal.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EACH,OAAO,IAAI,qBAAqB,EAChC,eAAe,EACf,cAAc,EACd,0BAA0B,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,4BAA4B,GACpC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACH,OAAO,IAAI,SAAS,EACpB,qBAAqB,EACrB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACH,UAAU,EACV,YAAY,EACZ,cAAc,EACd,aAAa,EACb,SAAS,EACT,iBAAiB,EACjB,QAAQ,EACR,KAAK,UAAU,EACf,KAAK,gBAAgB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAChI,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { default as Module } from "./Module.js";
+export { default as ScheduleFunctionality, SCHEDULE_FAMILY, SCHEDULE_OWNER, ScheduleFunctionalityError, } from "./Functionality.js";
+export { default as Scheduler, ScheduleDeliveryError, } from "./Scheduler.js";
+export { assertZone, describeRule, nextOccurrence, normalizeRule, parseRule, ScheduleRuleError, upcoming, } from "./rules.js";
+export { DEFINITION_SCHEMA, DefinitionError, readDefinition, targetWorkerName } from "./definition.js";
+export { ENABLED, serviceDefinitions, serviceEnabled } from "./config.js";
+export { isoString, zoned } from "./temporal.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,MAAM,EAAsB,MAAM,aAAa,CAAC;AACpE,OAAO,EACH,OAAO,IAAI,qBAAqB,EAChC,eAAe,EACf,cAAc,EACd,0BAA0B,GAG7B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACH,OAAO,IAAI,SAAS,EACpB,qBAAqB,GAKxB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACH,UAAU,EACV,YAAY,EACZ,cAAc,EACd,aAAa,EACb,SAAS,EACT,iBAAiB,EACjB,QAAQ,GAGX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,gBAAgB,EAA2B,MAAM,iBAAiB,CAAC;AAChI,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC"}

package/dist/rules.d.ts

@@ -0,0 +1,19 @@
+import { RRuleTemporal, type TemporalZonedDateTime } from "rrule-temporal";
+export type ScheduleRuleCode = "rule-invalid" | "rule-unbounded" | "zone-unknown";
+export declare class ScheduleRuleError extends Error {
+    readonly code: ScheduleRuleCode;
+    constructor(code: ScheduleRuleCode, detail: string, cause?: unknown);
+}
+export interface ParsedRule {
+    readonly text: string;
+    readonly zone: string;
+    readonly bounded: boolean;
+    readonly rule: RRuleTemporal;
+}
+export declare const assertZone: (zone: string) => void;
+export declare const parseRule: (text: string) => ParsedRule;
+export declare const normalizeRule: (text: string, zone: string, nowMs: number) => ParsedRule;
+export declare const nextOccurrence: (parsed: ParsedRule, afterMs: number) => TemporalZonedDateTime | null;
+export declare const upcoming: (parsed: ParsedRule, afterMs: number, limit: number) => TemporalZonedDateTime[];
+export declare const describeRule: (parsed: ParsedRule) => string;
+//# sourceMappingURL=rules.d.ts.map

package/dist/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../src/rules.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,KAAK,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAY3E,MAAM,MAAM,gBAAgB,GAAG,cAAc,GAAG,gBAAgB,GAAG,cAAc,CAAC;AAElF,qBAAa,iBAAkB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAEhC,YAAY,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAIlE;CACJ;AAED,MAAM,WAAW,UAAU;IAEvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;CAChC;AAyCD,eAAO,MAAM,UAAU,SAAU,MAAM,KAAG,IAMzC,CAAC;AAcF,eAAO,MAAM,SAAS,SAAU,MAAM,KAAG,UAMxC,CAAC;AAKF,eAAO,MAAM,aAAa,SAAU,MAAM,QAAQ,MAAM,SAAS,MAAM,KAAG,UAqBzE,CAAC;AAGF,eAAO,MAAM,cAAc,WAAY,UAAU,WAAW,MAAM,KAAG,qBAAqB,GAAG,IACpC,CAAC;AAE1D,eAAO,MAAM,QAAQ,WAAY,UAAU,WAAW,MAAM,SAAS,MAAM,KAAG,qBAAqB,EAUlG,CAAC;AAGF,eAAO,MAAM,YAAY,WAAY,UAAU,KAAG,MAAyE,CAAC"}