SDK client

sayless.tickets
sayless.conversations
sayless.messages
sayless.companies
sayless.teams
sayless.attachments
sayless.webhooks
sayless.workspace

await sayless.tickets.create(body, {
  idempotencyKey: crypto.randomUUID(), // sets Idempotency-Key
  headers: { 'X-Request-Id': '…' },     // this request only
});

const created = await sayless.tickets.create({ /* … */ });
created.success; // true
created.ticketId; // from data._id
created.ticket; // presented entity
created.lastSyncId;

const deleted = await sayless.tickets.delete({ /* … */ });
deleted.entityId;

const page = await sayless.tickets.list({ workspaceId, limit: 50 });
page.nodes;
page.hasNextPage;
const next = await page.fetchNext();

const teams = await sayless.teams.list({ workspaceId, limit: 50 });
const team = await sayless.teams.info({ workspaceId, _id: teams.nodes[0]!._id });

import {
  SaylessError,
  RateLimitedError,
  IdempotencyConflictError,
} from '@sayless/sdk';

try {
  await sayless.tickets.create(body, { idempotencyKey });
} catch (err) {
  if (err instanceof IdempotencyConflictError) {
    // wait and retry the same key, or poll
  } else if (err instanceof RateLimitedError) {
    // wait err.retryAfterSeconds
  } else if (err instanceof SaylessError) {
    console.error(err.type, err.message);
  }
}

import { SaylessWebhooks } from '@sayless/sdk';

SaylessWebhooks.assert({
  payload: rawBody,
  signature: req.headers['sayless-signature'],
  timestamp: req.headers['sayless-timestamp'],
  secret: process.env.SAYLESS_WEBHOOK_SECRET!,
});