API

app.get('/health', async (c) => {
  try {
    const status = await c.env.CHASKI.ready();
    const healthy = status.templates > 0 && status.problems.length === 0;
    return c.json({ chaski: status }, healthy ? 200 : 503);
  } catch (error) {
    return c.json({ chaski: String(error) }, 503);
  }
});

type SendRequest = {
  type: string;
  recipient: Recipient;
  payload?: Record<string, unknown>;
  channels?: Array<'email' | 'in_app' | 'push'>;
  transactional?: boolean;
  email?: { fromName?: string; replyTo?: string; attachments?: AttachmentInput[] };
  // silent shows the push without a sound, on Apple devices, on Windows and in browsers;
  // collapseId replaces a push already shown with the same id and becomes its tag.
  push?: { silent?: boolean; collapseId?: string };
  // For your clients, as is: the feed item and every push carry it. Strings only, since FCM
  // data and WNS launch arguments hold nothing else; up to 20 keys.
  data?: Record<string, string>;
  // The language of this send alone, ahead of recipient.locale; a BCP 47 tag. One that isn't
  // counts as absent.
  locale?: string;
  idempotencyKey?: string;
  // Delivers the one transactional email before send() returns; see Sending.
  inline?: boolean;
};

type ScheduleRequest = Omit<SendRequest, 'inline'> & {
  // ISO 8601 with an explicit offset: Z or ±hh:mm.
  scheduledAt: string;
  groupKey?: string;
};

type Recipient = {
  id: string;
  email?: string;
  name?: string;
  phone?: string;
  timezone?: string;
  locale?: string;
};

type AttachmentInput = {
  filename: string;
  contentType: string;
  // Exactly one of content (base64) or url.
  content?: string;
  url?: string;
  disposition?: 'attachment' | 'inline';
  contentId?: string;
};

type FeedItem = {
  id: string;
  // The notification it came from; its pushes carry the same id as their tag, unless the send
  // named a collapseId.
  notificationId: string;
  type: string;
  title: string;
  body: string;
  href?: string;
  // The send's data, or null.
  data: Record<string, string> | null;
  readAt: string | null;
  createdAt: string;
};

type FeedPage = { items: FeedItem[]; nextCursor: string | null };