station-broadcast 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 porkytheblack
+
+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/dist/adapters/index.d.ts

@@ -0,0 +1,20 @@
+import type { BroadcastRun, BroadcastRunPatch, BroadcastRunStatus, BroadcastNodeRun, BroadcastNodeRunPatch } from "../types.js";
+export interface BroadcastQueueAdapter {
+    addBroadcastRun(run: BroadcastRun): Promise<void>;
+    getBroadcastRun(id: string): Promise<BroadcastRun | null>;
+    updateBroadcastRun(id: string, patch: BroadcastRunPatch): Promise<void>;
+    getBroadcastRunsDue(): Promise<BroadcastRun[]>;
+    getBroadcastRunsRunning(): Promise<BroadcastRun[]>;
+    listBroadcastRuns(broadcastName: string): Promise<BroadcastRun[]>;
+    hasBroadcastRunWithStatus(broadcastName: string, statuses: BroadcastRunStatus[]): Promise<boolean>;
+    purgeBroadcastRuns(olderThan: Date, statuses: BroadcastRunStatus[]): Promise<number>;
+    addNodeRun(nodeRun: BroadcastNodeRun): Promise<void>;
+    getNodeRun(id: string): Promise<BroadcastNodeRun | null>;
+    updateNodeRun(id: string, patch: BroadcastNodeRunPatch): Promise<void>;
+    getNodeRuns(broadcastRunId: string): Promise<BroadcastNodeRun[]>;
+    generateId(): string;
+    ping(): Promise<boolean>;
+    close?(): Promise<void>;
+}
+export { BroadcastMemoryAdapter } from "./memory.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,qBAAqB;IAEpC,eAAe,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAC1D,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,mBAAmB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAC/C,uBAAuB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IACnD,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAClE,yBAAyB,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnG,kBAAkB,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAGrF,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACzD,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAGjE,UAAU,IAAI,MAAM,CAAC;IACrB,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC"}

package/dist/adapters/index.js

@@ -0,0 +1,2 @@
+export { BroadcastMemoryAdapter } from "./memory.js";
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AA+BA,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC"}

package/dist/adapters/memory.d.ts

@@ -0,0 +1,22 @@
+import type { BroadcastQueueAdapter } from "./index.js";
+import type { BroadcastRun, BroadcastRunPatch, BroadcastRunStatus, BroadcastNodeRun, BroadcastNodeRunPatch } from "../types.js";
+export declare class BroadcastMemoryAdapter implements BroadcastQueueAdapter {
+    private runs;
+    private nodeRuns;
+    addBroadcastRun(run: BroadcastRun): Promise<void>;
+    getBroadcastRun(id: string): Promise<BroadcastRun | null>;
+    updateBroadcastRun(id: string, patch: BroadcastRunPatch): Promise<void>;
+    getBroadcastRunsDue(): Promise<BroadcastRun[]>;
+    getBroadcastRunsRunning(): Promise<BroadcastRun[]>;
+    listBroadcastRuns(broadcastName: string): Promise<BroadcastRun[]>;
+    hasBroadcastRunWithStatus(broadcastName: string, statuses: BroadcastRunStatus[]): Promise<boolean>;
+    purgeBroadcastRuns(olderThan: Date, statuses: BroadcastRunStatus[]): Promise<number>;
+    addNodeRun(nodeRun: BroadcastNodeRun): Promise<void>;
+    getNodeRun(id: string): Promise<BroadcastNodeRun | null>;
+    updateNodeRun(id: string, patch: BroadcastNodeRunPatch): Promise<void>;
+    getNodeRuns(broadcastRunId: string): Promise<BroadcastNodeRun[]>;
+    generateId(): string;
+    ping(): Promise<boolean>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/adapters/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/adapters/memory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAErB,qBAAa,sBAAuB,YAAW,qBAAqB;IAClE,OAAO,CAAC,IAAI,CAAmC;IAC/C,OAAO,CAAC,QAAQ,CAAuC;IAEjD,eAAe,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAIzD,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAcvE,mBAAmB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAW9C,uBAAuB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAMlD,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAMjE,yBAAyB,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAQlG,kBAAkB,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAuBpF,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAIxD,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IActE,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAMtE,UAAU,IAAI,MAAM;IAId,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAIxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B"}

package/dist/adapters/memory.js

@@ -0,0 +1,108 @@
+import { randomUUID } from "node:crypto";
+export class BroadcastMemoryAdapter {
+    runs = new Map();
+    nodeRuns = new Map();
+    async addBroadcastRun(run) {
+        this.runs.set(run.id, run);
+    }
+    async getBroadcastRun(id) {
+        return this.runs.get(id) ?? null;
+    }
+    async updateBroadcastRun(id, patch) {
+        const run = this.runs.get(id);
+        if (run) {
+            const rec = run;
+            for (const [key, value] of Object.entries(patch)) {
+                if (value === undefined) {
+                    delete rec[key];
+                }
+                else {
+                    rec[key] = value;
+                }
+            }
+        }
+    }
+    async getBroadcastRunsDue() {
+        const now = new Date();
+        return Array.from(this.runs.values())
+            .filter((run) => {
+            if (run.status !== "pending")
+                return false;
+            if (!run.nextRunAt)
+                return true;
+            return run.nextRunAt <= now;
+        })
+            .sort((a, b) => a.createdAt.getTime() - b.createdAt.getTime());
+    }
+    async getBroadcastRunsRunning() {
+        return Array.from(this.runs.values()).filter((run) => run.status === "running");
+    }
+    async listBroadcastRuns(broadcastName) {
+        return Array.from(this.runs.values()).filter((run) => run.broadcastName === broadcastName);
+    }
+    async hasBroadcastRunWithStatus(broadcastName, statuses) {
+        const statusSet = new Set(statuses);
+        for (const run of this.runs.values()) {
+            if (run.broadcastName === broadcastName && statusSet.has(run.status))
+                return true;
+        }
+        return false;
+    }
+    async purgeBroadcastRuns(olderThan, statuses) {
+        const statusSet = new Set(statuses);
+        // M4: Collect IDs first, then delete — avoids mutating Map during iteration
+        const toPurge = [];
+        for (const [id, run] of this.runs) {
+            if (statusSet.has(run.status) && run.completedAt && run.completedAt < olderThan) {
+                toPurge.push(id);
+            }
+        }
+        for (const id of toPurge) {
+            this.runs.delete(id);
+            // Collect node run IDs to delete
+            const nodeRunIds = [];
+            for (const [nrId, nr] of this.nodeRuns) {
+                if (nr.broadcastRunId === id)
+                    nodeRunIds.push(nrId);
+            }
+            for (const nrId of nodeRunIds) {
+                this.nodeRuns.delete(nrId);
+            }
+        }
+        return toPurge.length;
+    }
+    async addNodeRun(nodeRun) {
+        this.nodeRuns.set(nodeRun.id, nodeRun);
+    }
+    async getNodeRun(id) {
+        return this.nodeRuns.get(id) ?? null;
+    }
+    async updateNodeRun(id, patch) {
+        const nodeRun = this.nodeRuns.get(id);
+        if (nodeRun) {
+            const rec = nodeRun;
+            for (const [key, value] of Object.entries(patch)) {
+                if (value === undefined) {
+                    delete rec[key];
+                }
+                else {
+                    rec[key] = value;
+                }
+            }
+        }
+    }
+    async getNodeRuns(broadcastRunId) {
+        return Array.from(this.nodeRuns.values()).filter((nr) => nr.broadcastRunId === broadcastRunId);
+    }
+    generateId() {
+        return randomUUID();
+    }
+    async ping() {
+        return true;
+    }
+    async close() {
+        this.runs.clear();
+        this.nodeRuns.clear();
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/adapters/memory.js.map

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

package/dist/broadcast-runner.d.ts

@@ -0,0 +1,78 @@
+import type { SignalRunner } from "station-signal";
+import type { BroadcastDefinition } from "./broadcast.js";
+import type { BroadcastQueueAdapter } from "./adapters/index.js";
+import type { BroadcastSubscriber } from "./subscribers/index.js";
+import type { BroadcastRun, BroadcastNodeRun, FailurePolicy } from "./types.js";
+export interface BroadcastRunnerOptions {
+    signalRunner: SignalRunner;
+    broadcastsDir?: string;
+    adapter?: BroadcastQueueAdapter;
+    pollIntervalMs?: number;
+    subscribers?: BroadcastSubscriber[];
+}
+export declare class BroadcastRunner {
+    private signalRunner;
+    private signalAdapter;
+    private adapter;
+    private broadcastsDir?;
+    private pollIntervalMs;
+    private subscribers;
+    private registry;
+    private recurringSchedules;
+    private running;
+    private stopping;
+    private ticking;
+    private pollTimer;
+    constructor(options: BroadcastRunnerOptions);
+    /** List all registered broadcast definitions with metadata. */
+    listRegistered(): Array<{
+        name: string;
+        nodeCount: number;
+        failurePolicy: FailurePolicy;
+        timeout?: number;
+        interval?: string;
+    }>;
+    /** Check whether a broadcast is registered by name. */
+    hasBroadcast(name: string): boolean;
+    /** Register a broadcast definition explicitly (alternative to auto-discovery). */
+    register(definition: BroadcastDefinition): this;
+    subscribe(subscriber: BroadcastSubscriber): this;
+    getBroadcastRun(id: string): Promise<BroadcastRun | null>;
+    getNodeRuns(broadcastRunId: string): Promise<BroadcastNodeRun[]>;
+    waitForBroadcastRun(id: string, opts?: {
+        pollMs?: number;
+        timeoutMs?: number;
+    }): Promise<BroadcastRun | null>;
+    cancel(broadcastRunId: string): Promise<boolean>;
+    /**
+     * Trigger a broadcast by name. Prefer this over `definition.trigger()` as it
+     * writes directly to this runner's adapter instead of the global singleton.
+     */
+    trigger(broadcastName: string, input: unknown): Promise<string>;
+    start(): Promise<void>;
+    stop(options?: {
+        graceful?: boolean;
+        timeoutMs?: number;
+    }): Promise<void>;
+    private emit;
+    private sleep;
+    private discover;
+    private scheduleRecurring;
+    private tick;
+    private tickRecurring;
+    private initBroadcast;
+    private advanceBroadcast;
+    /**
+     * Apply the failure policy. Returns true if the broadcast was terminated
+     * (fail-fast), false if processing should continue.
+     */
+    private handleFailure;
+    /**
+     * Transitively skip pending nodes that have ANY upstream dependency that is
+     * failed or was skipped due to an upstream failure (skipReason === "upstream-failed").
+     * Guard-skipped nodes (skipReason === "guard") do NOT propagate failure downstream.
+     */
+    private skipDownstream;
+    private triggerReadyNodes;
+}
+//# sourceMappingURL=broadcast-runner.d.ts.map

package/dist/broadcast-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcast-runner.d.ts","sourceRoot":"","sources":["../src/broadcast-runner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAsB,MAAM,gBAAgB,CAAC;AAEvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACd,MAAM,YAAY,CAAC;AAYpB,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,YAAY,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,mBAAmB,EAAE,CAAC;CACrC;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,aAAa,CAAC,CAAS;IAC/B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,WAAW,CAAwB;IAC3C,OAAO,CAAC,QAAQ,CAA0C;IAC1D,OAAO,CAAC,kBAAkB,CAAiD;IAC3E,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAA8C;gBAEnD,OAAO,EAAE,sBAAsB;IAW3C,+DAA+D;IAC/D,cAAc,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,aAAa,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAU/H,uDAAuD;IACvD,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAInC,kFAAkF;IAClF,QAAQ,CAAC,UAAU,EAAE,mBAAmB,GAAG,IAAI;IAa/C,SAAS,CAAC,UAAU,EAAE,mBAAmB,GAAG,IAAI;IAK1C,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAIzD,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAIhE,mBAAmB,CACvB,EAAE,EAAE,MAAM,EACV,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAC7C,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAgBzB,MAAM,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiCtD;;;OAGG;IACG,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAoB/D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgCtB,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B/E,OAAO,CAAC,IAAI;IAcZ,OAAO,CAAC,KAAK;YAMC,QAAQ;IA8BtB,OAAO,CAAC,iBAAiB;YAcX,IAAI;YAsBJ,aAAa;YAkCb,aAAa;YAkDb,gBAAgB;IAiH9B;;;OAGG;YACW,aAAa;IAgD3B;;;;OAIG;YACW,cAAc;YA6Cd,iBAAiB;CA8HhC"}