runlater-js 0.1.1 → 0.2.0

package/README.md

@@ -113,6 +113,12 @@ const { data, has_more } = await rl.tasks.list({ limit: 20 })
 // Get a specific task
 const task = await rl.tasks.get("task-id")
 
+// Update a task
+await rl.tasks.update("task-id", {
+  cron_expression: "0 7 * * *",
+  enabled: false,
+})
+
 // Trigger a task manually
 await rl.tasks.trigger("task-id")
 
@@ -133,8 +139,16 @@ const monitor = await rl.monitors.create({
   grace: 600,  // 10 min grace period
 })
 
-// Ping it from your cron job
-await fetch(monitor.ping_url)
+// Update a monitor
+await rl.monitors.update("monitor-id", {
+  grace_period_seconds: 1800,
+})
+
+// List pings
+const pings = await rl.monitors.pings("monitor-id", 20)
+
+// Ping from code (no API key needed — uses the token)
+await rl.monitors.ping("pm_your_token_here")
 ```
 
 ### Declarative sync

package/dist/index.d.mts

@@ -58,11 +58,12 @@ interface Task {
     cron_expression: string | null;
     scheduled_at: string | null;
     enabled: boolean;
-    muted: boolean;
     timeout_ms: number;
     retry_attempts: number;
     callback_url: string | null;
     queue: string | null;
+    notify_on_failure: boolean | null;
+    notify_on_recovery: boolean | null;
     next_run_at: string | null;
     inserted_at: string;
     updated_at: string;
@@ -105,19 +106,56 @@ interface Monitor {
     grace_period_seconds: number;
     status: "new" | "up" | "down" | "paused";
     enabled: boolean;
-    muted: boolean;
+    notify_on_failure: boolean | null;
+    notify_on_recovery: boolean | null;
     last_ping_at: string | null;
     next_expected_at: string | null;
     inserted_at: string;
     updated_at: string;
 }
+interface UpdateTaskOptions {
+    name?: string;
+    url?: string;
+    method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    headers?: Record<string, string>;
+    body?: string;
+    cron_expression?: string;
+    scheduled_at?: string;
+    timeout_ms?: number;
+    retry_attempts?: number;
+    callback_url?: string;
+    queue?: string;
+    enabled?: boolean;
+    notify_on_failure?: boolean | null;
+    notify_on_recovery?: boolean | null;
+    expected_status_codes?: string;
+    expected_body_pattern?: string;
+}
 interface CreateMonitorOptions {
     name: string;
-    schedule: string;
+    schedule?: string;
     interval?: number;
     grace?: number;
     enabled?: boolean;
 }
+interface UpdateMonitorOptions {
+    name?: string;
+    schedule_type?: "cron" | "interval";
+    cron_expression?: string;
+    interval_seconds?: number;
+    grace_period_seconds?: number;
+    enabled?: boolean;
+    notify_on_failure?: boolean | null;
+    notify_on_recovery?: boolean | null;
+}
+interface Ping {
+    id: string;
+    received_at: string;
+}
+interface PingResponse {
+    status: string;
+    monitor: string;
+}
 interface SyncOptions {
     tasks?: CronOptions[];
     monitors?: CreateMonitorOptions[];
@@ -211,6 +249,8 @@ declare class Runlater {
      * ```
      */
     sync(options: SyncOptions): Promise<SyncResponse>;
+    /** @internal */
+    getBaseUrl(): string;
     private buildTaskBody;
     /** @internal */
     request<T>(method: string, path: string, options?: {
@@ -225,6 +265,7 @@ declare class Tasks {
     get(id: string): Promise<Task>;
     delete(id: string): Promise<void>;
     trigger(id: string): Promise<TriggerResponse>;
+    update(id: string, options: UpdateTaskOptions): Promise<Task>;
     executions(id: string, limit?: number): Promise<Execution[]>;
 }
 declare class Monitors {
@@ -233,7 +274,10 @@ declare class Monitors {
     list(): Promise<Monitor[]>;
     get(id: string): Promise<Monitor>;
     create(options: CreateMonitorOptions): Promise<Monitor>;
+    update(id: string, options: UpdateMonitorOptions): Promise<Monitor>;
     delete(id: string): Promise<void>;
+    pings(id: string, limit?: number): Promise<Ping[]>;
+    ping(token: string): Promise<PingResponse>;
 }
 
-export { type CreateMonitorOptions, type CronOptions, type CronResponse, type DelayOptions, type Execution, type ListOptions, type ListResponse, type Monitor, Runlater, RunlaterError, type RunlaterOptions, type ScheduleOptions, type SendOptions, type SyncOptions, type SyncResponse, type Task, type TaskResponse, type TriggerResponse };
+export { type CreateMonitorOptions, type CronOptions, type CronResponse, type DelayOptions, type Execution, type ListOptions, type ListResponse, type Monitor, type Ping, type PingResponse, Runlater, RunlaterError, type RunlaterOptions, type ScheduleOptions, type SendOptions, type SyncOptions, type SyncResponse, type Task, type TaskResponse, type TriggerResponse, type UpdateMonitorOptions, type UpdateTaskOptions };

package/dist/index.d.ts

@@ -58,11 +58,12 @@ interface Task {
     cron_expression: string | null;
     scheduled_at: string | null;
     enabled: boolean;
-    muted: boolean;
     timeout_ms: number;
     retry_attempts: number;
     callback_url: string | null;
     queue: string | null;
+    notify_on_failure: boolean | null;
+    notify_on_recovery: boolean | null;
     next_run_at: string | null;
     inserted_at: string;
     updated_at: string;
@@ -105,19 +106,56 @@ interface Monitor {
     grace_period_seconds: number;
     status: "new" | "up" | "down" | "paused";
     enabled: boolean;
-    muted: boolean;
+    notify_on_failure: boolean | null;
+    notify_on_recovery: boolean | null;
     last_ping_at: string | null;
     next_expected_at: string | null;
     inserted_at: string;
     updated_at: string;
 }
+interface UpdateTaskOptions {
+    name?: string;
+    url?: string;
+    method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    headers?: Record<string, string>;
+    body?: string;
+    cron_expression?: string;
+    scheduled_at?: string;
+    timeout_ms?: number;
+    retry_attempts?: number;
+    callback_url?: string;
+    queue?: string;
+    enabled?: boolean;
+    notify_on_failure?: boolean | null;
+    notify_on_recovery?: boolean | null;
+    expected_status_codes?: string;
+    expected_body_pattern?: string;
+}
 interface CreateMonitorOptions {
     name: string;
-    schedule: string;
+    schedule?: string;
     interval?: number;
     grace?: number;
     enabled?: boolean;
 }
+interface UpdateMonitorOptions {
+    name?: string;
+    schedule_type?: "cron" | "interval";
+    cron_expression?: string;
+    interval_seconds?: number;
+    grace_period_seconds?: number;
+    enabled?: boolean;
+    notify_on_failure?: boolean | null;
+    notify_on_recovery?: boolean | null;
+}
+interface Ping {
+    id: string;
+    received_at: string;
+}
+interface PingResponse {
+    status: string;
+    monitor: string;
+}
 interface SyncOptions {
     tasks?: CronOptions[];
     monitors?: CreateMonitorOptions[];
@@ -211,6 +249,8 @@ declare class Runlater {
      * ```
      */
     sync(options: SyncOptions): Promise<SyncResponse>;
+    /** @internal */
+    getBaseUrl(): string;
     private buildTaskBody;
     /** @internal */
     request<T>(method: string, path: string, options?: {
@@ -225,6 +265,7 @@ declare class Tasks {
     get(id: string): Promise<Task>;
     delete(id: string): Promise<void>;
     trigger(id: string): Promise<TriggerResponse>;
+    update(id: string, options: UpdateTaskOptions): Promise<Task>;
     executions(id: string, limit?: number): Promise<Execution[]>;
 }
 declare class Monitors {
@@ -233,7 +274,10 @@ declare class Monitors {
     list(): Promise<Monitor[]>;
     get(id: string): Promise<Monitor>;
     create(options: CreateMonitorOptions): Promise<Monitor>;
+    update(id: string, options: UpdateMonitorOptions): Promise<Monitor>;
     delete(id: string): Promise<void>;
+    pings(id: string, limit?: number): Promise<Ping[]>;
+    ping(token: string): Promise<PingResponse>;
 }
 
-export { type CreateMonitorOptions, type CronOptions, type CronResponse, type DelayOptions, type Execution, type ListOptions, type ListResponse, type Monitor, Runlater, RunlaterError, type RunlaterOptions, type ScheduleOptions, type SendOptions, type SyncOptions, type SyncResponse, type Task, type TaskResponse, type TriggerResponse };
+export { type CreateMonitorOptions, type CronOptions, type CronResponse, type DelayOptions, type Execution, type ListOptions, type ListResponse, type Monitor, type Ping, type PingResponse, Runlater, RunlaterError, type RunlaterOptions, type ScheduleOptions, type SendOptions, type SyncOptions, type SyncResponse, type Task, type TaskResponse, type TriggerResponse, type UpdateMonitorOptions, type UpdateTaskOptions };

package/dist/index.js

@@ -192,6 +192,10 @@ var Runlater = class {
     const res = await this.request("PUT", "/sync", { body });
     return res.data;
   }
+  /** @internal */
+  getBaseUrl() {
+    return this.baseUrl;
+  }
   // --- Internal ---
   buildTaskBody(url, options) {
     return {
@@ -261,6 +265,12 @@ var Tasks = class {
     );
     return res.data;
   }
+  async update(id, options) {
+    const res = await this.client.request("PUT", `/tasks/${id}`, {
+      body: options
+    });
+    return res.data;
+  }
   async executions(id, limit = 50) {
     const res = await this.client.request(
       "GET",
@@ -294,9 +304,29 @@ var Monitors = class {
     });
     return res.data;
   }
+  async update(id, options) {
+    const res = await this.client.request("PUT", `/monitors/${id}`, {
+      body: options
+    });
+    return res.data;
+  }
   async delete(id) {
     await this.client.request("DELETE", `/monitors/${id}`);
   }
+  async pings(id, limit = 50) {
+    const res = await this.client.request(
+      "GET",
+      `/monitors/${id}/pings?limit=${limit}`
+    );
+    return res.data;
+  }
+  async ping(token) {
+    const response = await fetch(`${this.client.getBaseUrl()}/ping/${token}`);
+    if (!response.ok) {
+      throw new RunlaterError(response.status, "ping_failed", `HTTP ${response.status}`);
+    }
+    return await response.json();
+  }
 };
 function formatDelay(delay) {
   if (typeof delay === "number") return `${delay}s`;

package/dist/index.mjs

@@ -165,6 +165,10 @@ var Runlater = class {
     const res = await this.request("PUT", "/sync", { body });
     return res.data;
   }
+  /** @internal */
+  getBaseUrl() {
+    return this.baseUrl;
+  }
   // --- Internal ---
   buildTaskBody(url, options) {
     return {
@@ -234,6 +238,12 @@ var Tasks = class {
     );
     return res.data;
   }
+  async update(id, options) {
+    const res = await this.client.request("PUT", `/tasks/${id}`, {
+      body: options
+    });
+    return res.data;
+  }
   async executions(id, limit = 50) {
     const res = await this.client.request(
       "GET",
@@ -267,9 +277,29 @@ var Monitors = class {
     });
     return res.data;
   }
+  async update(id, options) {
+    const res = await this.client.request("PUT", `/monitors/${id}`, {
+      body: options
+    });
+    return res.data;
+  }
   async delete(id) {
     await this.client.request("DELETE", `/monitors/${id}`);
   }
+  async pings(id, limit = 50) {
+    const res = await this.client.request(
+      "GET",
+      `/monitors/${id}/pings?limit=${limit}`
+    );
+    return res.data;
+  }
+  async ping(token) {
+    const response = await fetch(`${this.client.getBaseUrl()}/ping/${token}`);
+    if (!response.ok) {
+      throw new RunlaterError(response.status, "ping_failed", `HTTP ${response.status}`);
+    }
+    return await response.json();
+  }
 };
 function formatDelay(delay) {
   if (typeof delay === "number") return `${delay}s`;

package/dist/types.d.ts

@@ -0,0 +1,179 @@
+export interface RunlaterOptions {
+    apiKey: string;
+    baseUrl?: string;
+}
+export interface SendOptions {
+    method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    headers?: Record<string, string>;
+    body?: unknown;
+    retries?: number;
+    timeout?: number;
+    queue?: string;
+    callback?: string;
+    idempotencyKey?: string;
+}
+export interface DelayOptions extends SendOptions {
+    delay: string | number;
+}
+export interface ScheduleOptions extends SendOptions {
+    at: string | Date;
+}
+export interface CronOptions {
+    url: string;
+    schedule: string;
+    method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    headers?: Record<string, string>;
+    body?: unknown;
+    timeout?: number;
+    retries?: number;
+    queue?: string;
+    callback?: string;
+    enabled?: boolean;
+}
+export interface TaskResponse {
+    task_id: string;
+    execution_id: string;
+    status: string;
+    scheduled_for: string;
+}
+export interface CronResponse {
+    id: string;
+    name: string;
+    url: string;
+    method: string;
+    cron_expression: string;
+    enabled: boolean;
+    next_run_at: string | null;
+    inserted_at: string;
+    updated_at: string;
+}
+export interface Task {
+    id: string;
+    name: string;
+    url: string;
+    method: string;
+    headers: Record<string, string>;
+    body: string | null;
+    schedule_type: string;
+    cron_expression: string | null;
+    scheduled_at: string | null;
+    enabled: boolean;
+    muted: boolean;
+    timeout_ms: number;
+    retry_attempts: number;
+    callback_url: string | null;
+    queue: string | null;
+    next_run_at: string | null;
+    inserted_at: string;
+    updated_at: string;
+}
+export interface Execution {
+    id: string;
+    status: "pending" | "running" | "success" | "failed" | "timeout";
+    scheduled_for: string;
+    started_at: string | null;
+    finished_at: string | null;
+    status_code: number | null;
+    duration_ms: number | null;
+    error_message: string | null;
+    attempt: number;
+}
+export interface ListOptions {
+    queue?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface ListResponse<T> {
+    data: T[];
+    has_more: boolean;
+    limit: number;
+    offset: number;
+}
+export interface TriggerResponse {
+    execution_id: string;
+    status: string;
+    scheduled_for: string;
+}
+export interface Monitor {
+    id: string;
+    name: string;
+    ping_token: string;
+    ping_url: string;
+    schedule_type: "cron" | "interval";
+    cron_expression: string | null;
+    interval_seconds: number | null;
+    grace_period_seconds: number;
+    status: "new" | "up" | "down" | "paused";
+    enabled: boolean;
+    muted: boolean;
+    last_ping_at: string | null;
+    next_expected_at: string | null;
+    inserted_at: string;
+    updated_at: string;
+}
+export interface UpdateTaskOptions {
+    name?: string;
+    url?: string;
+    method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    headers?: Record<string, string>;
+    body?: string;
+    cron_expression?: string;
+    scheduled_at?: string;
+    timeout_ms?: number;
+    retry_attempts?: number;
+    callback_url?: string;
+    queue?: string;
+    enabled?: boolean;
+    muted?: boolean;
+    expected_status_codes?: string;
+    expected_body_pattern?: string;
+}
+export interface CreateMonitorOptions {
+    name: string;
+    schedule?: string;
+    interval?: number;
+    grace?: number;
+    enabled?: boolean;
+}
+export interface UpdateMonitorOptions {
+    name?: string;
+    schedule_type?: "cron" | "interval";
+    cron_expression?: string;
+    interval_seconds?: number;
+    grace_period_seconds?: number;
+    enabled?: boolean;
+    muted?: boolean;
+}
+export interface Ping {
+    id: string;
+    received_at: string;
+}
+export interface PingResponse {
+    status: string;
+    monitor: string;
+}
+export interface SyncOptions {
+    tasks?: CronOptions[];
+    monitors?: CreateMonitorOptions[];
+    deleteRemoved?: boolean;
+}
+export interface SyncResponse {
+    tasks: {
+        created: string[];
+        updated: string[];
+        deleted: string[];
+    };
+    monitors: {
+        created: string[];
+        updated: string[];
+        deleted: string[];
+    };
+    created_count: number;
+    updated_count: number;
+    deleted_count: number;
+}
+export declare class RunlaterError extends Error {
+    status: number;
+    code: string;
+    constructor(status: number, code: string, message: string);
+}

package/dist/types.js

@@ -0,0 +1,10 @@
+export class RunlaterError extends Error {
+    status;
+    code;
+    constructor(status, code, message) {
+        super(message);
+        this.name = "RunlaterError";
+        this.status = status;
+        this.code = code;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "runlater-js",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Delayed tasks, cron jobs, and reliable webhooks. No infrastructure required.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",