Types Reference

Overview

All types are exported from the cuey package. This page provides a complete reference of all available types.

Importing Types

import type {
  Cron,
  Event,
  HttpMethod,
  EventStatus,
  RetryConfig,
  CreateCronInput,
  UpdateCronInput,
  CreateEventInput,
  UpdateEventInput,
  CronsQueryParams,
  EventsQueryParams,
  CueyConfig,
} from "cuey";

Core Types

Cron

Represents a recurring cron job.

Cron

interface

Interface representing a cron job.

Show Cron properties

string

required

Unique identifier (UUID).

cron_expression

string

required

Cron expression defining the schedule (e.g., 0 0 * * *).

timezone

string | null

Timezone for the cron schedule (e.g., America/New_York). null for UTC.

webhook_url

string

required

Webhook URL that will be called.

method

HttpMethod

required

HTTP method used for the webhook request.

headers

object | null

Custom headers to include in the webhook request. null if not set.

payload

object | null

Payload to send with the webhook request. null if not set.

retry_config

RetryConfig | null

Retry configuration for failed webhooks. null if not set.

Show RetryConfig properties

maxRetries

number

required

Maximum retry attempts. Range: 1-10.

backoffMs

number

required

Backoff delay in milliseconds. Range: 100-5000.

backoffType

string

required

Backoff strategy. Values: exponential, linear.

is_active

boolean | null

Whether the cron job is active. null defaults to true.

created_at

string | null

ISO 8601 timestamp when the cron job was created.

updated_at

string | null

ISO 8601 timestamp when the cron job was last updated.

team_id

string | null

Team ID associated with the cron job.

Event

Represents a scheduled event.

Event

interface

Interface representing a scheduled event.

Show Event properties

string

required

Unique identifier (UUID).

cron_id

string | null

Parent cron ID if this event was created by a cron job. null if created manually.

retry_of

string | null

Original event ID if this is a retry attempt. null for original events.

scheduled_at

string

required

ISO 8601 timestamp when the event is scheduled to execute.

executed_at

string | null

ISO 8601 timestamp when the event was executed. null if not yet executed.

status

EventStatus

required

Current status of the event. See EventStatus type for possible values.

webhook_url

string

required

Webhook URL that will be called.

method

HttpMethod

required

HTTP method used for the webhook request.

headers

object | null

Custom headers included in the webhook request. null if not set.

payload

object | null

Payload sent with the webhook request. null if not set.

retry_config

RetryConfig | null

Retry configuration for failed webhooks. null if not set.

response_status

number | null

HTTP status code from the webhook response. null if not yet executed.

response_headers

object | null

Response headers from the webhook. null if not yet executed.

response_body

string | null

Response body from the webhook (truncated to 1_KB). null if not yet executed.

response_duration

number | null

Duration of the webhook request in milliseconds. null if not yet executed.

response_error

string | null

Error message if the webhook execution failed. null if successful or not yet executed.

created_at

string | null

ISO 8601 timestamp when the event was created.

updated_at

string | null

ISO 8601 timestamp when the event was last updated.

team_id

string | null

Team ID associated with the event.

HttpMethod

Supported HTTP methods for webhook requests.

HttpMethod

union

Union type of supported HTTP methods.

Show HttpMethod values

GET

string

GET request method.

POST

string

POST request method (default).

PUT

string

PUT request method.

PATCH

string

PATCH request method.

DELETE

string

DELETE request method.

HEAD

string

HEAD request method.

OPTIONS

string

OPTIONS request method.

EventStatus

Status values for event execution.

EventStatus

union

Union type of event status values.

Show EventStatus values

pending

string

Event is scheduled but not yet executed.

processing

string

Event is currently being executed.

success

string

Event executed successfully.

failed

string

Event execution failed (after all retries).

RetryConfig

Retry configuration for webhooks.

RetryConfig

interface

Interface for retry configuration.

Show RetryConfig properties

maxRetries

number

required

Maximum retry attempts. Range: 1-10.

backoffMs

number

required

Backoff delay in milliseconds. Range: 100-5000.

backoffType

string

required

Backoff strategy. Values: exponential, linear.

Json

JSON type for API payloads.

Json

union

Recursive union type representing any JSON-serializable value.

Show Json values

string

String value.

number

Number value.

boolean

Boolean value.

null

Null value.

object

Object with string keys and Json values.

array

Array of Json values.

Input Types

CreateCronInput

Input for creating a cron job.

CreateCronInput

interface

Interface for creating a cron job.

Show CreateCronInput properties

webhook_url

string

required

Full URL or relative path of the webhook endpoint.

method

HttpMethod

HTTP method to use. Defaults to POST.

cron_expression

string

required

Cron expression defining the schedule.

timezone

string | null

Timezone for the cron schedule. null for UTC.

headers

Record<string, string> | null

Custom headers to include in the webhook request.

payload

Json | null

Payload to send with the webhook request.

retry_config

RetryConfig | null

Retry configuration for failed webhooks.

is_active

boolean

Whether the cron job should be active immediately. Defaults to true.

UpdateCronInput

Input for updating a cron job (same structure as CreateCronInput).

UpdateCronInput

interface

Interface for updating a cron job. Same structure as CreateCronInput.

CreateEventInput

Input for creating an event.

CreateEventInput

interface

Interface for creating an event.

Show CreateEventInput properties

webhook_url

string

required

Full URL or relative path of the webhook endpoint.

method

HttpMethod

HTTP method to use. Defaults to POST.

scheduled_at

string

required

ISO 8601 timestamp when the event should execute. Must be in the future.

headers

Record<string, string> | null

Custom headers to include in the webhook request.

payload

Json | null

Payload to send with the webhook request.

retry_config

RetryConfig | null

Retry configuration for failed webhooks.

UpdateEventInput

Input for updating an event (same structure as CreateEventInput).

UpdateEventInput

interface

Interface for updating an event. Same structure as CreateEventInput.

Query Parameter Types

CronsQueryParams

Query parameters for listing crons.

CronsQueryParams

interface

Interface for query parameters when listing crons.

Show CronsQueryParams properties

page

number

default:"0"

Page number (0-indexed). Defaults to 0.

limit

number

default:"100"

Number of items per page. Range: 1-1000. Defaults to 100.

is_active

boolean

Filter by active status. true for active crons, false for inactive crons.

EventsQueryParams

Query parameters for listing events.

EventsQueryParams

interface

Interface for query parameters when listing events.

Show EventsQueryParams properties

page

number

default:"0"

Page number (0-indexed). Defaults to 0.

limit

number

default:"100"

Number of items per page. Range: 1-1000. Defaults to 100.

status

EventStatus

Filter events by status.

cron_id

string

Filter events by the cron job that created them.

Configuration Types

CueyConfig

Configuration options for the Cuey client.

CueyConfig

interface

Interface for Cuey client configuration.

Show CueyConfig properties

baseUrl

string

Base URL for resolving relative webhook URLs.

apiKey

string

API key for authentication.

API Response Types

ApiSuccess

Standard API success response.

ApiSuccess

interface

Generic interface for API success responses.

Show ApiSuccess properties

data

required

The response data. Type parameter T represents the data type.

ApiSuccessWithPagination

Paginated API success response.

ApiSuccessWithPagination

interface

Generic interface for paginated API success responses.

Show ApiSuccessWithPagination properties

data

T[]

required

Array of response items. Type parameter T represents the item type.

pagination

object

required

Pagination information.

Show Pagination properties

Error Types

See the Error Handling page for complete error type documentation.

CueyError

class

Base error class for all Cuey API errors. Extends JavaScript’s Error.

CueyErrorCode

union

Union type of all possible error codes.

Show CueyErrorCode values

UNAUTHORIZED

string

Authentication failed or API key is invalid/missing.

NOT_FOUND

string

Requested resource does not exist.

BAD_REQUEST

string

Request is invalid.

VALIDATION_ERROR

string

Request validation failed.

INTERNAL_SERVER_ERROR

string

Server error occurred.

Type Guards and Utilities

Checking Event Status

function isPending(event: Event): boolean {
  return event.status === "pending";
}

function isSuccess(event: Event): boolean {
  return event.status === "success";
}

function isFailed(event: Event): boolean {
  return event.status === "failed";
}

Type Narrowing

function handleEvent(event: Event) {
  switch (event.status) {
    case "pending":
      // TypeScript knows event.status is "pending"
      console.log("Scheduled for:", event.scheduled_at);
      break;
    case "success":
      // TypeScript knows event.status is "success"
      console.log("Response:", event.response_status);
      break;
    case "failed":
      // TypeScript knows event.status is "failed"
      console.log("Error:", event.response_error);
      break;
  }
}

Type-Safe Payload Handling

interface MyPayload {
  action: string;
  userId: string;
  data: Record<string, unknown>;
}

const cron = await cuey.crons.create({
  webhook_url: "https://api.example.com/webhook",
  cron_expression: "0 0 * * *",
  payload: {
    action: "daily_report",
    userId: "123",
    data: {},
  } satisfies MyPayload,
});

Error Handling

Learn about error types and handling.

Advanced Configuration

Learn about configuration options.

Events

See events resource methods.

Crons

See crons resource methods.

TypeScript SDK

Advanced

​Overview

​Importing Types

​Core Types

​Cron

​Event

​HttpMethod

​EventStatus

​RetryConfig

​Json

​Input Types

​CreateCronInput

​UpdateCronInput

​CreateEventInput

​UpdateEventInput

​Query Parameter Types

​CronsQueryParams

​EventsQueryParams

​Configuration Types

​CueyConfig

​API Response Types

​ApiSuccess

​ApiSuccessWithPagination

​Error Types

​Type Guards and Utilities

​Checking Event Status

​Type Narrowing

​Type-Safe Payload Handling

​Related Resources

Error Handling

Advanced Configuration

Events

Crons

Overview

Importing Types

Core Types

Cron

Event

HttpMethod

EventStatus

RetryConfig

Json

Input Types

CreateCronInput

UpdateCronInput

CreateEventInput

UpdateEventInput

Query Parameter Types

CronsQueryParams

EventsQueryParams

Configuration Types

CueyConfig

API Response Types

ApiSuccess

ApiSuccessWithPagination

Error Types

Type Guards and Utilities

Checking Event Status

Type Narrowing

Type-Safe Payload Handling

Related Resources