station-kit 1.0.7 → 1.0.9

package/src/server/index.ts

@@ -4,10 +4,15 @@ import { serve } from "@hono/node-server";
 import { resolve } from "node:path";
 import { existsSync } from "node:fs";
 import type { Server } from "node:http";
-import { SignalRunner, MemoryAdapter } from "station-signal";
+import { SignalRunner, MemoryAdapter, parseInterval } from "station-signal";
 import { BroadcastRunner, BroadcastMemoryAdapter } from "station-broadcast";
 import type { SignalQueueAdapter } from "station-signal";
 import type { BroadcastQueueAdapter } from "station-broadcast";
+import {
+  ScheduleReconciler,
+  type Schedule,
+  type ScheduleAdapter,
+} from "station-schedules";
 import type { StationConfig } from "../config/schema.js";
 import { ensureStationDir } from "../station-dir.js";
 import { WebSocketHub } from "./ws.js";
@@ -19,7 +24,7 @@ import { healthRoutes } from "./routes/health.js";
 import { signalRoutes } from "./routes/signals.js";
 import { runRoutes } from "./routes/runs.js";
 import { broadcastRoutes } from "./routes/broadcasts.js";
-import { KeyStore } from "./auth/keys.js";
+import { KeyStore, SqliteKeyStorage } from "./auth/keys.js";
 import { verifySessionToken, verifyCredentials, createSessionToken, type SessionConfig } from "./auth/session.js";
 import { authResolver } from "./middleware/auth.js";
 import { requireScope } from "./middleware/scope-guard.js";
@@ -32,10 +37,29 @@ import { v1TriggerRoutes } from "./routes/v1/trigger.js";
 import { v1KeyRoutes } from "./routes/v1/keys.js";
 import { v1AuthRoutes } from "./routes/v1/auth.js";
 import { v1EventRoutes } from "./routes/v1/events.js";
+import { v1DefinitionRoutes, v1DefinitionReadRoutes } from "./routes/v1/definitions.js";
+import { v1ScheduleRoutes, v1ScheduleReadRoutes } from "./routes/v1/schedules.js";
+import { v1ExpressionRoutes } from "./routes/v1/expressions.js";
+
+export {
+  KeyStore,
+  SqliteKeyStorage,
+  MemoryKeyStorage,
+} from "./auth/keys.js";
+export type {
+  ApiKey,
+  ApiKeyPublic,
+  ApiKeyStorageAdapter,
+  SqliteKeyStorageOptions,
+} from "./auth/keys.js";
 
 export interface StationInstance {
   start(): Promise<void>;
   stop(): Promise<void>;
+  /** The KeyStore instance (available when auth is configured). */
+  keyStore?: KeyStore;
+  /** The resolved data directory path. */
+  dataDir: string;
 }
 
 export async function createStation(config: StationConfig, cwd: string, nextPort?: number): Promise<StationInstance> {
@@ -55,7 +79,9 @@ export async function createStation(config: StationConfig, cwd: string, nextPort
   let sessionConfig: SessionConfig | undefined;
 
   if (config.auth) {
-    keyStore = new KeyStore(resolve(dataDir, "station-keys.db"));
+    const storage = config.auth.keyStorage
+      ?? new SqliteKeyStorage({ dbPath: resolve(dataDir, "station-keys.db") });
+    keyStore = new KeyStore(storage);
     sessionConfig = {
       username: config.auth.username,
       password: config.auth.password,
@@ -87,8 +113,23 @@ export async function createStation(config: StationConfig, cwd: string, nextPort
   // Create runners if enabled
   let signalRunner: SignalRunner | undefined;
   let broadcastRunner: BroadcastRunner | undefined;
+  const scheduleAdapter: ScheduleAdapter | undefined = config.scheduleAdapter;
 
   if (config.runRunners) {
+    // Build schedule reconcilers up front. Each reconciler handles only the
+    // kinds it's responsible for; the runner ticks it once per loop.
+    const signalScheduleReconciler = scheduleAdapter
+      ? new ScheduleReconciler({
+          adapter: scheduleAdapter,
+          kinds: ["signal"],
+          parseInterval,
+          triggerFn: (s: Schedule) => signalRunner!.triggerSignal(s.target, s.input ?? {}),
+          hasPendingOrRunning: (s: Schedule) =>
+            signalRunner!.hasPendingOrRunningForSignal(s.target),
+          onError: (err) => console.error("[station] Signal schedule reconciler:", err),
+        })
+      : undefined;
+
     signalRunner = new SignalRunner({
       signalsDir,
       adapter: signalAdapter,
@@ -97,15 +138,29 @@ export async function createStation(config: StationConfig, cwd: string, nextPort
       maxAttempts: config.runner.maxAttempts,
       retryBackoffMs: config.runner.retryBackoffMs,
       subscribers: [stationSignalSub],
+      scheduleReconciler: signalScheduleReconciler,
     });
 
     if (broadcastsDir || broadcastAdapter) {
+      const broadcastScheduleReconciler = scheduleAdapter
+        ? new ScheduleReconciler({
+            adapter: scheduleAdapter,
+            kinds: ["broadcast-static", "broadcast-dynamic"],
+            parseInterval,
+            triggerFn: (s: Schedule) => broadcastRunner!.trigger(s.target, s.input ?? {}),
+            hasPendingOrRunning: (s: Schedule) =>
+              broadcastRunner!.hasPendingOrRunningForBroadcast(s.target),
+            onError: (err) => console.error("[station] Broadcast schedule reconciler:", err),
+          })
+        : undefined;
+
       broadcastRunner = new BroadcastRunner({
         signalRunner,
         broadcastsDir,
         adapter: broadcastAdapter ?? new BroadcastMemoryAdapter(),
         pollIntervalMs: config.broadcastRunner.pollIntervalMs,
         subscribers: [stationBroadcastSub],
+        scheduleReconciler: broadcastScheduleReconciler,
       });
     }
   }
@@ -197,6 +252,15 @@ export async function createStation(config: StationConfig, cwd: string, nextPort
   readRoutes.route("/", v1RunRoutes({ signalRunner, signalAdapter, logBuffer, logStore }));
   readRoutes.route("/", v1BroadcastRoutes({ broadcastRunner, broadcastAdapter, broadcastSubscriber: stationBroadcastSub }));
   readRoutes.route("/", v1EventRoutes({ sseHub }));
+  readRoutes.route("/", v1ExpressionRoutes());
+  // Schedule GET + preview are read-scoped; mutating routes are mounted under admin below.
+  readRoutes.route("/", v1ScheduleReadRoutes({ scheduleAdapter }));
+  readRoutes.route("/", v1DefinitionReadRoutes({
+    broadcastRunner,
+    broadcastAdapter,
+    signalRunner,
+    signalSubscriber: stationSignalSub,
+  }));
   v1.route("/", readRoutes);
 
   // Trigger-scope routes
@@ -232,10 +296,17 @@ export async function createStation(config: StationConfig, cwd: string, nextPort
   });
   v1.route("/", cancelRoutes);
 
-  // Admin-scope routes
+  // Admin-scope routes — destructive / mutating endpoints
   const adminRoutes = new Hono();
   adminRoutes.use("/*", requireScope("admin"));
   adminRoutes.route("/", v1KeyRoutes({ keyStore }));
+  adminRoutes.route("/", v1DefinitionRoutes({
+    broadcastRunner,
+    broadcastAdapter,
+    signalRunner,
+    signalSubscriber: stationSignalSub,
+  }));
+  adminRoutes.route("/", v1ScheduleRoutes({ scheduleAdapter }));
   v1.route("/", adminRoutes);
 
   app.route("/api/v1", v1);
@@ -291,6 +362,8 @@ export async function createStation(config: StationConfig, cwd: string, nextPort
   let httpServer: Server | null = null;
 
   return {
+    keyStore,
+    dataDir,
     async start() {
       // Start runners (non-blocking — they have internal poll loops)
       if (config.runRunners) {
@@ -329,7 +402,7 @@ export async function createStation(config: StationConfig, cwd: string, nextPort
       wsHub.close();
       sseHub.close();
       logStore.close();
-      keyStore?.close();
+      await keyStore?.close();
       if (httpServer) {
         httpServer.close();
       }

package/src/server/middleware/auth.ts

@@ -15,7 +15,7 @@ export function authResolver(deps: AuthDeps) {
     if (authHeader?.startsWith("Bearer ") && deps.keyStore) {
       const token = authHeader.slice(7);
       if (token.startsWith("sk_")) {
-        const key = deps.keyStore.verify(token);
+        const key = await deps.keyStore.verify(token);
         if (key) {
           c.set("authType", "api-key");
           c.set("apiKeyId", key.id);

package/src/server/routes/v1/definitions.ts

@@ -0,0 +1,164 @@
+import { Hono } from "hono";
+import type {
+  BroadcastRunner,
+  BroadcastQueueAdapter,
+  DynamicBroadcastSpec,
+} from "station-broadcast";
+import { validateDynamicSpec, type DynamicValidationContext } from "station-broadcast";
+import type { SignalRunner } from "station-signal";
+import type { SchemaField } from "station-expressions";
+import type { StationSignalSubscriber } from "../../subscriber.js";
+
+export interface V1DefinitionDeps {
+  broadcastRunner?: BroadcastRunner;
+  broadcastAdapter?: BroadcastQueueAdapter;
+  signalRunner?: SignalRunner;
+  signalSubscriber?: StationSignalSubscriber;
+}
+
+/**
+ * Read-scope routes for dynamic broadcast definitions: list, get, version
+ * history, get-by-version, plus the read-only `validate` endpoint.
+ */
+export function v1DefinitionReadRoutes(deps: V1DefinitionDeps) {
+  const app = new Hono();
+
+  app.get("/broadcast-definitions", async (c) => {
+    if (!deps.broadcastAdapter?.listDefinitions) return c.json({ data: [] });
+    const list = await deps.broadcastAdapter.listDefinitions();
+    return c.json({ data: list.map(serializeSpec) });
+  });
+
+  app.get("/broadcast-definitions/:name", async (c) => {
+    if (!deps.broadcastAdapter?.getDefinition) return c.json({ error: "unavailable" }, 503);
+    const spec = await deps.broadcastAdapter.getDefinition(c.req.param("name"));
+    if (!spec) return c.json({ error: "not_found" }, 404);
+    return c.json({ data: serializeSpec(spec) });
+  });
+
+  app.get("/broadcast-definitions/:name/versions", async (c) => {
+    if (!deps.broadcastAdapter?.listDefinitionVersions) return c.json({ data: [] });
+    const versions = await deps.broadcastAdapter.listDefinitionVersions(c.req.param("name"));
+    return c.json({ data: versions.map(serializeSpec) });
+  });
+
+  app.get("/broadcast-definitions/:name/versions/:n", async (c) => {
+    if (!deps.broadcastAdapter?.getDefinition) return c.json({ error: "unavailable" }, 503);
+    const version = parseInt(c.req.param("n"), 10);
+    if (Number.isNaN(version)) {
+      return c.json({ error: "bad_request", message: "Version must be a number." }, 400);
+    }
+    const spec = await deps.broadcastAdapter.getDefinition(c.req.param("name"), version);
+    if (!spec) return c.json({ error: "not_found" }, 404);
+    return c.json({ data: serializeSpec(spec) });
+  });
+
+  app.post("/broadcast-definitions/validate", async (c) => {
+    const body = await c.req.json().catch(() => ({}));
+    const spec = body as DynamicBroadcastSpec;
+    if (!spec || typeof spec !== "object" || typeof spec.name !== "string") {
+      return c.json({ error: "bad_request", message: "Spec is missing required fields." }, 400);
+    }
+    const ctx = buildValidationContext(deps);
+    const result = validateDynamicSpec(spec, ctx);
+    return c.json({ data: result });
+  });
+
+  return app;
+}
+
+/**
+ * Admin-scope routes for mutating dynamic broadcast definitions. GETs are
+ * mounted under read scope in server/index.ts.
+ */
+export function v1DefinitionRoutes(deps: V1DefinitionDeps) {
+  const app = new Hono();
+
+  app.post("/broadcast-definitions", async (c) => {
+    if (!deps.broadcastAdapter?.saveDefinition) {
+      return c.json({ error: "unavailable", message: "Broadcast adapter does not support dynamic definitions." }, 503);
+    }
+    const body = await c.req.json().catch(() => ({}));
+    const incoming = body as DynamicBroadcastSpec;
+    if (!incoming?.name || !Array.isArray(incoming.nodes)) {
+      return c.json({ error: "bad_request", message: "Spec is missing required fields." }, 400);
+    }
+
+    const ctx = buildValidationContext(deps);
+    const validation = validateDynamicSpec(incoming, ctx);
+    if (!validation.ok) {
+      return c.json({ error: "validation_failed", data: validation }, 422);
+    }
+
+    const apiKeyId = c.get("apiKeyId" as never) as string | undefined;
+    const now = new Date();
+    const toSave: DynamicBroadcastSpec = {
+      ...incoming,
+      version: 0,
+      createdAt: incoming.createdAt ?? now,
+      updatedAt: now,
+      createdBy: apiKeyId,
+      failurePolicy: incoming.failurePolicy ?? "fail-fast",
+    };
+
+    const saved = await deps.broadcastAdapter.saveDefinition(toSave);
+
+    // Trigger an eager reconciliation so the new version is live immediately.
+    if (deps.broadcastRunner) {
+      void deps.broadcastRunner.reconcileDynamicDefinitions().catch(() => {});
+    }
+
+    return c.json({ data: serializeSpec(saved) }, 201);
+  });
+
+  // GET routes for definitions live in the read-scope mount in server/index.ts;
+  // this router only exposes mutating endpoints under admin scope.
+
+  app.delete("/broadcast-definitions/:name", async (c) => {
+    if (!deps.broadcastAdapter?.deleteDefinition) {
+      return c.json({ error: "unavailable" }, 503);
+    }
+    const success = await deps.broadcastAdapter.deleteDefinition(c.req.param("name"));
+    if (!success) return c.json({ error: "not_found" }, 404);
+    if (deps.broadcastRunner) {
+      void deps.broadcastRunner.reconcileDynamicDefinitions().catch(() => {});
+    }
+    return c.json({ data: { deleted: true } });
+  });
+
+  return app;
+}
+
+function serializeSpec(spec: DynamicBroadcastSpec): Record<string, unknown> {
+  return {
+    ...spec,
+    createdAt: spec.createdAt?.toISOString?.() ?? spec.createdAt,
+    updatedAt: spec.updatedAt?.toISOString?.() ?? spec.updatedAt,
+    deletedAt: spec.deletedAt?.toISOString?.() ?? spec.deletedAt,
+  };
+}
+
+function buildValidationContext(deps: V1DefinitionDeps): DynamicValidationContext {
+  const signalSchemas = new Map<string, { inputSchema: SchemaField; outputSchema: SchemaField }>();
+  // Best-effort schema reflection: we don't know the precise SchemaField for
+  // each signal here without traversing Zod schemas. Use `any` for now — the
+  // structural checks (signal exists, deps exist, no cycles, expression
+  // wellformedness) still run. Zod input validation runs at trigger time.
+  const sigs = deps.signalRunner?.getAllSignals();
+  if (sigs) {
+    for (const name of sigs.keys()) {
+      signalSchemas.set(name, {
+        inputSchema: { type: "any" },
+        outputSchema: { type: "any" },
+      });
+    }
+  } else if (deps.signalSubscriber) {
+    for (const meta of deps.signalSubscriber.getAllSignalMeta()) {
+      signalSchemas.set(meta.name, {
+        inputSchema: { type: "any" },
+        outputSchema: { type: "any" },
+      });
+    }
+  }
+  return { signalSchemas };
+}

package/src/server/routes/v1/expressions.ts

@@ -0,0 +1,76 @@
+import { Hono } from "hono";
+import {
+  evaluate,
+  validate,
+  parse,
+  ExpressionEvalError,
+  ExpressionParseError,
+  type ExprNode,
+  type SchemaField,
+} from "station-expressions";
+
+export function v1ExpressionRoutes() {
+  const app = new Hono();
+
+  app.post("/expressions/evaluate", async (c) => {
+    const body = await c.req.json().catch(() => ({}));
+    const { node, context } = body as {
+      node?: ExprNode;
+      context?: { input?: unknown; upstream?: Record<string, unknown> };
+    };
+    if (!node) {
+      return c.json({ error: "bad_request", message: "Missing `node`." }, 400);
+    }
+    try {
+      const result = evaluate(node, {
+        input: context?.input,
+        upstream: context?.upstream ?? {},
+      });
+      return c.json({ data: { value: result } });
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      const status = err instanceof ExpressionEvalError ? 400 : 500;
+      return c.json({ error: "evaluation_failed", message }, status);
+    }
+  });
+
+  app.post("/expressions/validate", async (c) => {
+    const body = await c.req.json().catch(() => ({}));
+    const { node, schemaContext } = body as {
+      node?: ExprNode;
+      schemaContext?: {
+        inputSchema?: SchemaField;
+        upstreamSchemas?: Record<string, SchemaField>;
+        expectedSchema?: SchemaField;
+      };
+    };
+    if (!node) {
+      return c.json({ error: "bad_request", message: "Missing `node`." }, 400);
+    }
+    const result = validate(node, {
+      inputSchema: schemaContext?.inputSchema ?? { type: "any" },
+      upstreamSchemas: schemaContext?.upstreamSchemas ?? {},
+      expectedSchema: schemaContext?.expectedSchema,
+    });
+    return c.json({ data: result });
+  });
+
+  app.post("/expressions/parse", async (c) => {
+    const body = await c.req.json().catch(() => ({}));
+    const { source } = body as { source?: string };
+    if (typeof source !== "string") {
+      return c.json({ error: "bad_request", message: "Missing `source` string." }, 400);
+    }
+    try {
+      const node = parse(source);
+      return c.json({ data: { node } });
+    } catch (err) {
+      if (err instanceof ExpressionParseError) {
+        return c.json({ error: "parse_error", message: err.message, position: err.position }, 400);
+      }
+      return c.json({ error: "parse_error", message: err instanceof Error ? err.message : String(err) }, 400);
+    }
+  });
+
+  return app;
+}

package/src/server/routes/v1/keys.ts

@@ -17,7 +17,7 @@ export function v1KeyRoutes(deps: V1KeyDeps) {
     const name = body.name || "Unnamed key";
     const scopes = Array.isArray(body.scopes) ? body.scopes : ["trigger", "read"];
 
-    const { key, record } = deps.keyStore.create(name, scopes);
+    const { key, record } = await deps.keyStore.create(name, scopes);
     return c.json(
       {
         data: {
@@ -37,7 +37,7 @@ export function v1KeyRoutes(deps: V1KeyDeps) {
     if (!deps.keyStore) {
       return c.json({ error: "unavailable", message: "Auth not configured." }, 503);
     }
-    const keys = deps.keyStore.list();
+    const keys = await deps.keyStore.list();
     return c.json({ data: keys });
   });
 
@@ -46,7 +46,7 @@ export function v1KeyRoutes(deps: V1KeyDeps) {
       return c.json({ error: "unavailable", message: "Auth not configured." }, 503);
     }
     const id = c.req.param("id");
-    const success = deps.keyStore.revoke(id);
+    const success = await deps.keyStore.revoke(id);
     if (!success) {
       return c.json({ error: "not_found", message: "Key not found." }, 404);
     }

package/src/server/routes/v1/schedules.ts

@@ -0,0 +1,176 @@
+import { Hono } from "hono";
+import { parseInterval } from "station-signal";
+import type { Schedule, ScheduleAdapter, ScheduleKind } from "station-schedules";
+
+export interface V1ScheduleDeps {
+  scheduleAdapter?: ScheduleAdapter;
+}
+
+const KIND_VALUES: ScheduleKind[] = ["signal", "broadcast-static", "broadcast-dynamic"];
+
+/** Read-scope routes: list / get / preview. */
+export function v1ScheduleReadRoutes(deps: V1ScheduleDeps) {
+  const app = new Hono();
+
+  app.get("/schedules", async (c) => {
+    if (!deps.scheduleAdapter) return c.json({ data: [] });
+    const kindParam = c.req.query("kind");
+    const enabledParam = c.req.query("enabled");
+
+    const kind = KIND_VALUES.includes(kindParam as ScheduleKind)
+      ? (kindParam as ScheduleKind)
+      : undefined;
+    const enabled = enabledParam === "true" ? true : enabledParam === "false" ? false : undefined;
+
+    const list = await deps.scheduleAdapter.list({ kind, enabled });
+    return c.json({ data: list.map(serialize) });
+  });
+
+  app.get("/schedules/:id", async (c) => {
+    if (!deps.scheduleAdapter) return c.json({ error: "unavailable" }, 503);
+    const s = await deps.scheduleAdapter.get(c.req.param("id"));
+    if (!s) return c.json({ error: "not_found" }, 404);
+    return c.json({ data: serialize(s) });
+  });
+
+  app.post("/schedules/:id/preview", async (c) => {
+    if (!deps.scheduleAdapter) return c.json({ error: "unavailable" }, 503);
+    const id = c.req.param("id");
+    const s = await deps.scheduleAdapter.get(id);
+    if (!s) return c.json({ error: "not_found" }, 404);
+    const body = await c.req.json().catch(() => ({}));
+    const count = Math.min(20, Math.max(1, Number(body.count) || 5));
+    const ms = parseInterval(s.interval);
+    const fires: string[] = [];
+    let next = s.nextRunAt.getTime();
+    for (let i = 0; i < count; i++) {
+      fires.push(new Date(next).toISOString());
+      next += ms;
+    }
+    return c.json({ data: { fires } });
+  });
+
+  return app;
+}
+
+/** Admin-scope routes: create / update / delete. */
+export function v1ScheduleRoutes(deps: V1ScheduleDeps) {
+  const app = new Hono();
+
+  app.post("/schedules", async (c) => {
+    if (!deps.scheduleAdapter) return c.json({ error: "unavailable" }, 503);
+    const body = await c.req.json().catch(() => ({}));
+    const { kind, target, interval, input, enabled } = body as Partial<Schedule>;
+
+    if (!KIND_VALUES.includes(kind as ScheduleKind)) {
+      return c.json({ error: "bad_request", message: `kind must be one of ${KIND_VALUES.join(", ")}` }, 400);
+    }
+    if (typeof target !== "string" || target.length === 0) {
+      return c.json({ error: "bad_request", message: "target is required" }, 400);
+    }
+    if (typeof interval !== "string") {
+      return c.json({ error: "bad_request", message: "interval is required" }, 400);
+    }
+    let intervalMs: number;
+    try {
+      intervalMs = parseInterval(interval);
+    } catch (err) {
+      return c.json({
+        error: "bad_request",
+        message: `interval invalid: ${err instanceof Error ? err.message : String(err)}`,
+      }, 400);
+    }
+    // Reject circular / non-serializable inputs before they reach the adapter,
+    // which would otherwise surface as a 500 with a stacktrace.
+    if (input !== undefined) {
+      try {
+        JSON.stringify(input);
+      } catch (err) {
+        return c.json({
+          error: "bad_request",
+          message: `input is not JSON-serializable: ${err instanceof Error ? err.message : String(err)}`,
+        }, 400);
+      }
+    }
+
+    const apiKeyId = c.get("apiKeyId" as never) as string | undefined;
+    const now = new Date();
+    const schedule: Schedule = {
+      id: deps.scheduleAdapter.generateId(),
+      kind: kind as ScheduleKind,
+      target,
+      interval,
+      input,
+      enabled: enabled ?? true,
+      nextRunAt: new Date(now.getTime() + intervalMs),
+      createdAt: now,
+      updatedAt: now,
+      createdBy: apiKeyId,
+    };
+    await deps.scheduleAdapter.add(schedule);
+    return c.json({ data: serialize(schedule) }, 201);
+  });
+
+  app.patch("/schedules/:id", async (c) => {
+    if (!deps.scheduleAdapter) return c.json({ error: "unavailable" }, 503);
+    const id = c.req.param("id");
+    const existing = await deps.scheduleAdapter.get(id);
+    if (!existing) return c.json({ error: "not_found" }, 404);
+
+    const body = await c.req.json().catch(() => ({}));
+    const patch: Record<string, unknown> = {};
+    if ("interval" in body) {
+      try {
+        parseInterval(body.interval);
+      } catch (err) {
+        return c.json({
+          error: "bad_request",
+          message: `interval invalid: ${err instanceof Error ? err.message : String(err)}`,
+        }, 400);
+      }
+      patch.interval = body.interval;
+    }
+    if ("input" in body) {
+      try {
+        JSON.stringify(body.input);
+      } catch (err) {
+        return c.json({
+          error: "bad_request",
+          message: `input is not JSON-serializable: ${err instanceof Error ? err.message : String(err)}`,
+        }, 400);
+      }
+      patch.input = body.input;
+    }
+    if ("enabled" in body) patch.enabled = Boolean(body.enabled);
+    if ("nextRunAt" in body) {
+      const parsed = new Date(body.nextRunAt);
+      if (Number.isNaN(parsed.getTime())) {
+        return c.json({ error: "bad_request", message: "nextRunAt must be a valid date" }, 400);
+      }
+      patch.nextRunAt = parsed;
+    }
+
+    await deps.scheduleAdapter.update(id, patch);
+    const updated = await deps.scheduleAdapter.get(id);
+    return c.json({ data: updated ? serialize(updated) : null });
+  });
+
+  app.delete("/schedules/:id", async (c) => {
+    if (!deps.scheduleAdapter) return c.json({ error: "unavailable" }, 503);
+    const ok = await deps.scheduleAdapter.delete(c.req.param("id"));
+    if (!ok) return c.json({ error: "not_found" }, 404);
+    return c.json({ data: { deleted: true } });
+  });
+
+  return app;
+}
+
+function serialize(s: Schedule): Record<string, unknown> {
+  return {
+    ...s,
+    nextRunAt: s.nextRunAt.toISOString(),
+    lastRunAt: s.lastRunAt?.toISOString(),
+    createdAt: s.createdAt.toISOString(),
+    updatedAt: s.updatedAt.toISOString(),
+  };
+}

package/src/server/routes/v1/trigger.ts

@@ -185,6 +185,33 @@ export function v1TriggerRoutes(deps: V1TriggerDeps) {
     }
   });
 
+  app.post("/trigger-dynamic-broadcast", async (c) => {
+    if (!deps.broadcastRunner) {
+      return c.json({ error: "unavailable", message: "Broadcast runner not configured." }, 503);
+    }
+    const body = await c.req.json().catch(() => null);
+    if (!body?.broadcastName) {
+      return c.json({ error: "bad_request", message: "Missing broadcastName." }, 400);
+    }
+    const { broadcastName, input } = body;
+    if (!deps.broadcastRunner.hasDynamicBroadcast(broadcastName)) {
+      return c.json(
+        { error: "not_found", message: `Dynamic broadcast "${broadcastName}" not registered.` },
+        404,
+      );
+    }
+    try {
+      const id = await deps.broadcastRunner.triggerDynamic(broadcastName, input ?? {});
+      return c.json(
+        { data: { id, broadcastName, status: "pending", createdAt: new Date().toISOString() } },
+        201,
+      );
+    } catch (err: unknown) {
+      const message = err instanceof Error ? err.message : String(err);
+      return c.json({ error: "trigger_failed", message }, 400);
+    }
+  });
+
   app.post("/broadcast-runs/:id/rerun", async (c) => {
     if (!deps.broadcastRunner || !deps.broadcastAdapter) {
       return c.json({ error: "unavailable", message: "Broadcast runner not configured." }, 503);

package/.next/standalone/packages/station-kit/.next/static/chunks/580-f007f4d4c050db4e.js

@@ -1 +0,0 @@
-"use strict";(self.webpackChunk_N_E=self.webpackChunk_N_E||[]).push([[580],{706:(e,t)=>{function r(e){let t={};for(let[r,n]of e.entries()){let e=t[r];void 0===e?t[r]=n:Array.isArray(e)?e.push(n):t[r]=[e,n]}return t}function n(e){return"string"==typeof e?e:("number"!=typeof e||isNaN(e))&&"boolean"!=typeof e?"":String(e)}function o(e){let t=new URLSearchParams;for(let[r,o]of Object.entries(e))if(Array.isArray(o))for(let e of o)t.append(r,n(e));else t.set(r,n(o));return t}function u(e){for(var t=arguments.length,r=Array(t>1?t-1:0),n=1;n<t;n++)r[n-1]=arguments[n];for(let t of r){for(let r of t.keys())e.delete(r);for(let[r,n]of t.entries())e.append(r,n)}return e}Object.defineProperty(t,"__esModule",{value:!0}),!function(e,t){for(var r in t)Object.defineProperty(e,r,{enumerable:!0,get:t[r]})}(t,{assign:function(){return u},searchParamsToUrlQuery:function(){return r},urlQueryToSearchParams:function(){return o}})},2823:(e,t,r)=>{Object.defineProperty(t,"__esModule",{value:!0}),Object.defineProperty(t,"useMergedRef",{enumerable:!0,get:function(){return o}});let n=r(5271);function o(e,t){let r=(0,n.useRef)(null),o=(0,n.useRef)(null);return(0,n.useCallback)(n=>{if(null===n){let e=r.current;e&&(r.current=null,e());let t=o.current;t&&(o.current=null,t())}else e&&(r.current=u(e,n)),t&&(o.current=u(t,n))},[e,t])}function u(e,t){if("function"!=typeof e)return e.current=t,()=>{e.current=null};{let r=e(t);return"function"==typeof r?r:()=>e(null)}}("function"==typeof t.default||"object"==typeof t.default&&null!==t.default)&&void 0===t.default.__esModule&&(Object.defineProperty(t.default,"__esModule",{value:!0}),Object.assign(t.default,t),e.exports=t.default)},4736:(e,t,r)=>{var n=r(1504);r.o(n,"useParams")&&r.d(t,{useParams:function(){return n.useParams}}),r.o(n,"usePathname")&&r.d(t,{usePathname:function(){return n.usePathname}}),r.o(n,"useRouter")&&r.d(t,{useRouter:function(){return n.useRouter}})},5073:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),Object.defineProperty(t,"errorOnce",{enumerable:!0,get:function(){return r}});let r=e=>{}},5935:(e,t,r)=>{Object.defineProperty(t,"__esModule",{value:!0}),!function(e,t){for(var r in t)Object.defineProperty(e,r,{enumerable:!0,get:t[r]})}(t,{default:function(){return g},useLinkStatus:function(){return b}});let n=r(4284),o=r(8111),u=n._(r(5271)),a=r(9642),i=r(5911),l=r(2823),f=r(7076),c=r(3790);r(4209);let s=r(7335),p=r(7843),d=r(587);r(5073);let h=r(5564);function y(e){return"string"==typeof e?e:(0,a.formatUrl)(e)}function g(e){var t;let r,n,a,[g,b]=(0,u.useOptimistic)(s.IDLE_LINK_STATUS),P=(0,u.useRef)(null),{href:_,as:v,children:E,prefetch:O=null,passHref:j,replace:S,shallow:C,scroll:N,onClick:T,onMouseEnter:R,onTouchStart:x,legacyBehavior:A=!1,onNavigate:M,ref:L,unstable_dynamicOnHover:k,...I}=e;r=E,A&&("string"==typeof r||"number"==typeof r)&&(r=(0,o.jsx)("a",{children:r}));let U=u.default.useContext(i.AppRouterContext),w=!1!==O,F=!1!==O?null===(t=O)||"auto"===t?h.FetchStrategy.PPR:h.FetchStrategy.Full:h.FetchStrategy.PPR,{href:D,as:K}=u.default.useMemo(()=>{let e=y(_);return{href:e,as:v?y(v):e}},[_,v]);A&&(n=u.default.Children.only(r));let B=A?n&&"object"==typeof n&&n.ref:L,z=u.default.useCallback(e=>(null!==U&&(P.current=(0,s.mountLinkInstance)(e,D,U,F,w,b)),()=>{P.current&&((0,s.unmountLinkForCurrentNavigation)(P.current),P.current=null),(0,s.unmountPrefetchableInstance)(e)}),[w,D,U,F,b]),Q={ref:(0,l.useMergedRef)(z,B),onClick(e){A||"function"!=typeof T||T(e),A&&n.props&&"function"==typeof n.props.onClick&&n.props.onClick(e),U&&(e.defaultPrevented||function(e,t,r,n,o,a,i){let{nodeName:l}=e.currentTarget;if(!("A"===l.toUpperCase()&&function(e){let t=e.currentTarget.getAttribute("target");return t&&"_self"!==t||e.metaKey||e.ctrlKey||e.shiftKey||e.altKey||e.nativeEvent&&2===e.nativeEvent.which}(e)||e.currentTarget.hasAttribute("download"))){if(!(0,p.isLocalURL)(t)){o&&(e.preventDefault(),location.replace(t));return}if(e.preventDefault(),i){let e=!1;if(i({preventDefault:()=>{e=!0}}),e)return}u.default.startTransition(()=>{(0,d.dispatchNavigateAction)(r||t,o?"replace":"push",null==a||a,n.current)})}}(e,D,K,P,S,N,M))},onMouseEnter(e){A||"function"!=typeof R||R(e),A&&n.props&&"function"==typeof n.props.onMouseEnter&&n.props.onMouseEnter(e),U&&w&&(0,s.onNavigationIntent)(e.currentTarget,!0===k)},onTouchStart:function(e){A||"function"!=typeof x||x(e),A&&n.props&&"function"==typeof n.props.onTouchStart&&n.props.onTouchStart(e),U&&w&&(0,s.onNavigationIntent)(e.currentTarget,!0===k)}};return(0,f.isAbsoluteUrl)(K)?Q.href=K:A&&!j&&("a"!==n.type||"href"in n.props)||(Q.href=(0,c.addBasePath)(K)),a=A?u.default.cloneElement(n,Q):(0,o.jsx)("a",{...I,...Q,children:r}),(0,o.jsx)(m.Provider,{value:g,children:a})}let m=(0,u.createContext)(s.IDLE_LINK_STATUS),b=()=>(0,u.useContext)(m);("function"==typeof t.default||"object"==typeof t.default&&null!==t.default)&&void 0===t.default.__esModule&&(Object.defineProperty(t.default,"__esModule",{value:!0}),Object.assign(t.default,t),e.exports=t.default)},7076:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),!function(e,t){for(var r in t)Object.defineProperty(e,r,{enumerable:!0,get:t[r]})}(t,{DecodeError:function(){return h},MiddlewareNotFoundError:function(){return b},MissingStaticPage:function(){return m},NormalizeError:function(){return y},PageNotFoundError:function(){return g},SP:function(){return p},ST:function(){return d},WEB_VITALS:function(){return r},execOnce:function(){return n},getDisplayName:function(){return l},getLocationOrigin:function(){return a},getURL:function(){return i},isAbsoluteUrl:function(){return u},isResSent:function(){return f},loadGetInitialProps:function(){return s},normalizeRepeatedSlashes:function(){return c},stringifyError:function(){return P}});let r=["CLS","FCP","FID","INP","LCP","TTFB"];function n(e){let t,r=!1;return function(){for(var n=arguments.length,o=Array(n),u=0;u<n;u++)o[u]=arguments[u];return r||(r=!0,t=e(...o)),t}}let o=/^[a-zA-Z][a-zA-Z\d+\-.]*?:/,u=e=>o.test(e);function a(){let{protocol:e,hostname:t,port:r}=window.location;return e+"//"+t+(r?":"+r:"")}function i(){let{href:e}=window.location,t=a();return e.substring(t.length)}function l(e){return"string"==typeof e?e:e.displayName||e.name||"Unknown"}function f(e){return e.finished||e.headersSent}function c(e){let t=e.split("?");return t[0].replace(/\\/g,"/").replace(/\/\/+/g,"/")+(t[1]?"?"+t.slice(1).join("?"):"")}async function s(e,t){let r=t.res||t.ctx&&t.ctx.res;if(!e.getInitialProps)return t.ctx&&t.Component?{pageProps:await s(t.Component,t.ctx)}:{};let n=await e.getInitialProps(t);if(r&&f(r))return n;if(!n)throw Object.defineProperty(Error('"'+l(e)+'.getInitialProps()" should resolve to an object. But found "'+n+'" instead.'),"__NEXT_ERROR_CODE",{value:"E394",enumerable:!1,configurable:!0});return n}let p="undefined"!=typeof performance,d=p&&["mark","measure","getEntriesByName"].every(e=>"function"==typeof performance[e]);class h extends Error{}class y extends Error{}class g extends Error{constructor(e){super(),this.code="ENOENT",this.name="PageNotFoundError",this.message="Cannot find module for page: "+e}}class m extends Error{constructor(e,t){super(),this.message="Failed to load static file for page: "+e+" "+t}}class b extends Error{constructor(){super(),this.code="ENOENT",this.message="Cannot find the middleware module"}}function P(e){return JSON.stringify({message:e.message,stack:e.stack})}},7843:(e,t,r)=>{Object.defineProperty(t,"__esModule",{value:!0}),Object.defineProperty(t,"isLocalURL",{enumerable:!0,get:function(){return u}});let n=r(7076),o=r(3506);function u(e){if(!(0,n.isAbsoluteUrl)(e))return!0;try{let t=(0,n.getLocationOrigin)(),r=new URL(e,t);return r.origin===t&&(0,o.hasBasePath)(r.pathname)}catch(e){return!1}}},9642:(e,t,r)=>{Object.defineProperty(t,"__esModule",{value:!0}),!function(e,t){for(var r in t)Object.defineProperty(e,r,{enumerable:!0,get:t[r]})}(t,{formatUrl:function(){return u},formatWithValidation:function(){return i},urlObjectKeys:function(){return a}});let n=r(4284)._(r(706)),o=/https?|ftp|gopher|file/;function u(e){let{auth:t,hostname:r}=e,u=e.protocol||"",a=e.pathname||"",i=e.hash||"",l=e.query||"",f=!1;t=t?encodeURIComponent(t).replace(/%3A/i,":")+"@":"",e.host?f=t+e.host:r&&(f=t+(~r.indexOf(":")?"["+r+"]":r),e.port&&(f+=":"+e.port)),l&&"object"==typeof l&&(l=String(n.urlQueryToSearchParams(l)));let c=e.search||l&&"?"+l||"";return u&&!u.endsWith(":")&&(u+=":"),e.slashes||(!u||o.test(u))&&!1!==f?(f="//"+(f||""),a&&"/"!==a[0]&&(a="/"+a)):f||(f=""),i&&"#"!==i[0]&&(i="#"+i),c&&"?"!==c[0]&&(c="?"+c),""+u+f+(a=a.replace(/[?#]/g,encodeURIComponent))+(c=c.replace("#","%23"))+i}let a=["auth","hash","host","hostname","href","path","pathname","port","protocol","query","search","slashes"];function i(e){return u(e)}}}]);