const response = await fetch(`${process.env.HELPPUFF_URL}/api/v1/jobs`, {
  headers: {
    Authorization: `Bearer ${process.env.HELPPUFF_API_KEY}`,
  },
});
if (!response.ok) throw new Error(((await response.json()) as ApiError).error.message);
const data = (await response.json()) as ListJobsResponse;

type ListJobsResponse = {
  items: Array<{
    id: string;
    number: number;
    title: string;
    details: string | null;
    stage: {
      id: string;
      name: string;
      kind: string;
    };
    status: string;
    fields: Record<string, string>;
    contact: Record<string, string> | null;
    conversationId: string | null;
    source: string;
    value: number | null;
    valueCents: number | null;
    currency: string | null;
    dueAt: number | null;
    assignedTo: string | null;
    assignedName: string | null;
    position: number;
    stale: boolean;
    stageChangedAt: number;
    closedAt: number | null;
    lostReason: string | null;
    createdAt: number;
    updatedAt: number;
  }>;
  stages: Array<{
    id: string;
    name: string;
    color: string;
    position: number;
    kind: string;
    rotDays: number;
    count: number;
    valueCents: number | null;
  }>;
};

type CreateJobRequest = {
  /** Up to 160 characters. Left out: made from the fields and the contact. */
  title?: string;
  /** What is needed, up to 10,000 characters. */
  details?: string;
  /**
   * Values by field name, e.g. `{ "service": "Blocked drains" }`. A select
   * field takes one of its options.
   */
  fields?: Record<string, string>;
  /** `{ name, email, phone }`: matched by email, then phone, or created. */
  contact?: Record<string, string>;
  /** An existing contact's id, instead of `contact`. */
  contactId?: string;
  /** The conversation it came from. */
  conversationId?: string;
  /**
   * A callback request to turn into a job (its contact, conversation and
   * reason).
   */
  callbackId?: string;
  /** The stage to start in. */
  stageId?: string;
  /** What it is worth, e.g. `450` (in `currency`). */
  value?: number;
  /** ISO 4217, e.g. `AUD`. */
  currency?: string;
  /** ISO 8601 date, or milliseconds. */
  dueAt?: string;
  /** A team member's email. */
  assignedTo?: string;
};

const response = await fetch(`${process.env.HELPPUFF_URL}/api/v1/jobs`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.HELPPUFF_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    title: 'Blocked kitchen drain',
    details: 'Kitchen sink drains slowly and gurgles.',
    fields: {
      service: 'Blocked drains',
      address: 'Balmain',
      urgency: 'This week'
    },
    contact: {
      name: 'Ada Lovelace',
      email: '[email protected]',
      phone: '0400 111 222'
    },
    value: 450,
    currency: 'AUD'
  } satisfies CreateJobRequest),
});
if (!response.ok) throw new Error(((await response.json()) as ApiError).error.message);
const data = (await response.json()) as CreateJobResponse;

type CreateJobResponse = {
  id: string;
  number: number;
  title: string;
  details: string | null;
  stage: {
    id: string;
    name: string;
    kind: string;
  };
  status: string;
  fields: Record<string, string>;
  contact: Record<string, string> | null;
  conversationId: string | null;
  source: string;
  value: number | null;
  valueCents: number | null;
  currency: string | null;
  dueAt: number | null;
  assignedTo: string | null;
  assignedName: string | null;
  position: number;
  stale: boolean;
  stageChangedAt: number;
  closedAt: number | null;
  lostReason: string | null;
  createdAt: number;
  updatedAt: number;
};

const id = '…';
const response = await fetch(`${process.env.HELPPUFF_URL}/api/v1/jobs/${id}`, {
  headers: {
    Authorization: `Bearer ${process.env.HELPPUFF_API_KEY}`,
  },
});
if (!response.ok) throw new Error(((await response.json()) as ApiError).error.message);
const data = (await response.json()) as GetJobResponse;

type GetJobResponse = {
  id: string;
  number: number;
  title: string;
  details: string | null;
  stage: {
    id: string;
    name: string;
    kind: string;
  };
  status: string;
  fields: Record<string, string>;
  contact: Record<string, string> | null;
  conversationId: string | null;
  source: string;
  value: number | null;
  valueCents: number | null;
  currency: string | null;
  dueAt: number | null;
  assignedTo: string | null;
  assignedName: string | null;
  position: number;
  stale: boolean;
  stageChangedAt: number;
  closedAt: number | null;
  lostReason: string | null;
  createdAt: number;
  updatedAt: number;
  history: Array<{
    id: string;
    at: number;
    actor: string;
    actorName: string;
    kind: string;
    data: {
      source: string;
      stage: string;
    };
  }>;
  notes: Array<{
    id: string;
    author: string;
    authorName: string;
    text: string;
    createdAt: number;
    updatedAt: number;
  }>;
  conversation: {
    id: string;
    firstMessage: string;
    startedAt: number;
  } | null;
};

type ChangeJobRequest = {
  /** Up to 160 characters. */
  title?: string;
  /** Replaces the details. To add to them, use `POST /jobs/:id/updates`. */
  details?: string;
  /** Values by field name; `null` clears one. */
  fields?: Record<string, string>;
  /** A number, or null. */
  value?: number;
  /** ISO 4217. */
  currency?: string;
  /** ISO 8601 date, milliseconds, or null. */
  dueAt?: string;
  /** A team member's email, or null. */
  assignedTo?: string;
};

const id = '…';
const response = await fetch(`${process.env.HELPPUFF_URL}/api/v1/jobs/${id}`, {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.HELPPUFF_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    fields: {
      urgency: 'Emergency'
    },
    value: 520
  } satisfies ChangeJobRequest),
});
if (!response.ok) throw new Error(((await response.json()) as ApiError).error.message);
const data = (await response.json()) as ChangeJobResponse;

type ChangeJobResponse = {
  id: string;
  number: number;
  title: string;
  details: string | null;
  stage: {
    id: string;
    name: string;
    kind: string;
  };
  status: string;
  fields: Record<string, string>;
  contact: Record<string, string> | null;
  conversationId: string | null;
  source: string;
  value: number | null;
  valueCents: number | null;
  currency: string | null;
  dueAt: number | null;
  assignedTo: string | null;
  assignedName: string | null;
  position: number;
  stale: boolean;
  stageChangedAt: number;
  closedAt: number | null;
  lostReason: string | null;
  createdAt: number;
  updatedAt: number;
};

type MoveJobRequest = {
  /** The stage to move it to. */
  stageId?: string;
  /** The id of the job it now sits above, or null for the bottom. */
  before?: string;
  /** Why, when moving to a lost stage. */
  lostReason?: string;
};

const id = '…';
const response = await fetch(`${process.env.HELPPUFF_URL}/api/v1/jobs/${id}/move`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.HELPPUFF_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    stageId: 'stg_8d7c6b5a4f3e2d1c'
  } satisfies MoveJobRequest),
});
if (!response.ok) throw new Error(((await response.json()) as ApiError).error.message);
const data = (await response.json()) as MoveJobResponse;

type MoveJobResponse = {
  id: string;
  number: number;
  title: string;
  details: string | null;
  stage: {
    id: string;
    name: string;
    kind: string;
  };
  status: string;
  fields: Record<string, string>;
  contact: Record<string, string> | null;
  conversationId: string | null;
  source: string;
  value: number | null;
  valueCents: number | null;
  currency: string | null;
  dueAt: number | null;
  assignedTo: string | null;
  assignedName: string | null;
  position: number;
  stale: boolean;
  stageChangedAt: number;
  closedAt: number | null;
  lostReason: string | null;
  createdAt: number;
  updatedAt: number;
};

type AddUpdateRequest = {
  /** Up to 4000 characters. */
  text: string;
};

const id = '…';
const response = await fetch(`${process.env.HELPPUFF_URL}/api/v1/jobs/${id}/updates`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.HELPPUFF_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    text: 'Parts ordered, back Thursday.'
  } satisfies AddUpdateRequest),
});
if (!response.ok) throw new Error(((await response.json()) as ApiError).error.message);
const data = (await response.json()) as AddUpdateResponse;

type AddUpdateResponse = {
  id: string;
  added: boolean;
};

type AddNoteToJobRequest = {
  /** Up to 5000 characters. */
  text: string;
};

const id = '…';
const response = await fetch(`${process.env.HELPPUFF_URL}/api/v1/jobs/${id}/notes`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.HELPPUFF_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    text: 'Gate code 4471.'
  } satisfies AddNoteToJobRequest),
});
if (!response.ok) throw new Error(((await response.json()) as ApiError).error.message);
const data = (await response.json()) as AddNoteToJobResponse;

type AddNoteToJobResponse = {
  id: string;
  jobId: string;
  author: string;
  authorName: string | null;
  text: string;
  createdAt: number;
  updatedAt: number;
};

const id = '…';
const response = await fetch(`${process.env.HELPPUFF_URL}/api/v1/jobs/${id}/files`, {
  headers: {
    Authorization: `Bearer ${process.env.HELPPUFF_API_KEY}`,
  },
});
if (!response.ok) throw new Error(((await response.json()) as ApiError).error.message);
const data = (await response.json()) as JobSFilesResponse;

type JobSFilesResponse = {
  enabled: boolean;
  storage: boolean;
  maxMb: number;
  files: Array<{
    id: string;
    name: string;
    type: string;
    size: number;
    url: string;
    createdAt: number;
    uploadedBy: string;
    uploadedByName: string | null;
  }>;
  fromChat: Array<{
    id: string;
    name: string;
    type: string;
    size: number;
    url: string;
    uploadedBy: string;
    uploadedByName: string | null;
    createdAt: number;
  }>;
};

const id = '…';
import { readFile } from 'node:fs/promises';

const response = await fetch(`${process.env.HELPPUFF_URL}/api/v1/jobs/${id}/files?${new URLSearchParams({ name: 'after-install.jpg' })}`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.HELPPUFF_API_KEY}`,
    'Content-Type': 'application/octet-stream',
  },
  body: await readFile('price-list.pdf'),
});
if (!response.ok) throw new Error(((await response.json()) as ApiError).error.message);
const data = (await response.json()) as AttachFileToJobResponse;

type AttachFileToJobResponse = {
  id: string;
  name: string;
  type: string;
  size: number;
  url: string;
  createdAt: number;
  uploadedBy: string;
  uploadedByName: string | null;
};

const id = '…';
const fileId = '2';
const response = await fetch(`${process.env.HELPPUFF_URL}/api/v1/jobs/${id}/files/FILEID`, {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.HELPPUFF_API_KEY}`,
  },
});
if (!response.ok) throw new Error(((await response.json()) as ApiError).error.message);
const data = (await response.json()) as RemoveFileFromJobResponse;

type RemoveFileFromJobResponse = {
  id: string;
  deleted: boolean;
};

const id = '…';
const response = await fetch(`${process.env.HELPPUFF_URL}/api/v1/jobs/${id}`, {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.HELPPUFF_API_KEY}`,
  },
});
if (!response.ok) throw new Error(((await response.json()) as ApiError).error.message);
const data = (await response.json()) as DeleteJobResponse;

type DeleteJobResponse = {
  id: string;
  deleted: boolean;
};

const response = await fetch(`${process.env.HELPPUFF_URL}/api/v1/jobs/pipeline`, {
  headers: {
    Authorization: `Bearer ${process.env.HELPPUFF_API_KEY}`,
  },
});
if (!response.ok) throw new Error(((await response.json()) as ApiError).error.message);
const data = (await response.json()) as PipelineResponse;

type PipelineResponse = {
  pipeline: {
    siteId: string;
    template: string;
    itemSingular: string;
    itemPlural: string;
    chosenBy: string;
    reason: string | null;
    assistantJobs: boolean;
    quote: {
      enabled: boolean;
      label: string;
      askContact: boolean;
    };
    editedAt: number | null;
    stages: Array<{
      id: string;
      name: string;
      color: string;
      position: number;
      kind: string;
      rotDays: number;
    }>;
    fields: Array<{
      id: string;
      name: string;
      label: string;
      type: string;
      required: boolean;
      options: string[];
      question: string;
      position: number;
      inQuote: boolean;
      quotePosition: number;
      archived: boolean;
    }>;
    quotePreview: Array<{
      field: string;
      ask: string;
      input: string;
      choices: string[];
    }>;
  };
  templates: Array<{
    id: string;
    name: string;
    description: string;
    stages: Array<{
      name: string;
      kind: string;
      color: string;
      rotDays: number;
    }>;
    fields: Array<{
      name: string;
      label: string;
      type: string;
      options: string[];
      question: string;
      quote: boolean;
    }>;
  }>;
};

type ChangePipelineRequest = {
  /** `[{ id?, name, kind: "open"|"won"|"lost", color?, rotDays? }]`. */
  stages?: string;
  /**
   * `[{ id?, label, type:
   * "text"|"textarea"|"number"|"date"|"select"|"email"|"tel", required?,
   * options?, question? }]`.
   */
  fields?: string;
  /** Field names asked by the widget's quote questions, in order (up to 10). */
  quote?: string[];
  /** Offer the quote questions in the widget ("Get a quote"). */
  quoteEnabled?: string;
  /** The button's label. */
  quoteLabel?: string;
  /** Also ask for name, email and phone at the end. */
  quoteContact?: string;
  /** Let the assistant create jobs from the chat. */
  assistantJobs?: string;
  /** What a job is called, e.g. "Ticket". */
  itemSingular?: string;
  /** Its plural. */
  itemPlural?: string;
  /** `{ <removed stage id>: <stage id> }`. */
  moveTo?: string;
};

const response = await fetch(`${process.env.HELPPUFF_URL}/api/v1/jobs/pipeline`, {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.HELPPUFF_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    quote: [
      'service',
      'description',
      'address'
    ],
    quoteLabel: 'Get a free quote'
  } satisfies ChangePipelineRequest),
});
if (!response.ok) throw new Error(((await response.json()) as ApiError).error.message);
const data = (await response.json()) as ChangePipelineResponse;

type ChangePipelineResponse = {
  pipeline: {
    siteId: string;
    template: string;
    itemSingular: string;
    itemPlural: string;
    chosenBy: string;
    reason: string | null;
    assistantJobs: boolean;
    quote: {
      enabled: boolean;
      label: string;
      askContact: boolean;
    };
    editedAt: number | null;
    stages: Array<{
      id: string;
      name: string;
      color: string;
      position: number;
      kind: string;
      rotDays: number;
    }>;
    fields: Array<{
      id: string;
      name: string;
      label: string;
      type: string;
      required: boolean;
      options: string[];
      question: string;
      position: number;
      inQuote: boolean;
      quotePosition: number;
      archived: boolean;
    }>;
    quotePreview: Array<{
      field: string;
      ask: string;
      input: string;
      choices: string[];
    }>;
  };
  templates: Array<{
    id: string;
    name: string;
    description: string;
    stages: Array<{
      name: string;
      kind: string;
      color: string;
      rotDays: number;
    }>;
    fields: Array<{
      name: string;
      label: string;
      type: string;
      options: string[];
      question: string;
      quote: boolean;
    }>;
  }>;
};

type UseAnotherTemplateRequest = {
  /**
   * `service-quote`, `projects`, `support`, `sales-demo`, `bookings`,
   * `custom-orders` or `basic`.
   */
  template: string;
};

const response = await fetch(`${process.env.HELPPUFF_URL}/api/v1/jobs/pipeline/template`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.HELPPUFF_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    template: 'projects'
  } satisfies UseAnotherTemplateRequest),
});
if (!response.ok) throw new Error(((await response.json()) as ApiError).error.message);
const data = (await response.json()) as UseAnotherTemplateResponse;

type UseAnotherTemplateResponse = {
  pipeline: {
    siteId: string;
    template: string;
    itemSingular: string;
    itemPlural: string;
    chosenBy: string;
    reason: string | null;
    assistantJobs: boolean;
    quote: {
      enabled: boolean;
      label: string;
      askContact: boolean;
    };
    editedAt: number | null;
    stages: Array<{
      id: string;
      name: string;
      color: string;
      position: number;
      kind: string;
      rotDays: number;
    }>;
    fields: Array<{
      id: string;
      name: string;
      label: string;
      type: string;
      required: boolean;
      options: string[];
      question: string;
      position: number;
      inQuote: boolean;
      quotePosition: number;
      archived: boolean;
    }>;
    quotePreview: Array<{
      field: string;
      ask: string;
      input: string;
      choices: string[];
    }>;
  };
  templates: Array<{
    id: string;
    name: string;
    description: string;
    stages: Array<{
      name: string;
      kind: string;
      color: string;
      rotDays: number;
    }>;
    fields: Array<{
      name: string;
      label: string;
      type: string;
      options: string[];
      question: string;
      quote: boolean;
    }>;
  }>;
};

type LetAISetPipelineUpRequest = {
  /**
   * Default true: choose again. False: only the first time, never over a
   * pipeline the owner or the AI set up.
   */
  force?: boolean;
};

const response = await fetch(`${process.env.HELPPUFF_URL}/api/v1/jobs/setup`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.HELPPUFF_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    force: true
  } satisfies LetAISetPipelineUpRequest),
});
if (!response.ok) throw new Error(((await response.json()) as ApiError).error.message);
const data = (await response.json()) as LetAISetPipelineUpResponse;

type LetAISetPipelineUpResponse = {
  status: string;
  template: string;
  chosenBy: string;
  reason: string | null;
  applied: boolean;
  pipeline: {
    siteId: string;
    template: string;
    itemSingular: string;
    itemPlural: string;
    chosenBy: string;
    reason: string | null;
    assistantJobs: boolean;
    quote: {
      enabled: boolean;
      label: string;
      askContact: boolean;
    };
    editedAt: number | null;
    stages: Array<{
      id: string;
      name: string;
      color: string;
      position: number;
      kind: string;
      rotDays: number;
    }>;
    fields: Array<{
      id: string;
      name: string;
      label: string;
      type: string;
      required: boolean;
      options: string[];
      question: string;
      position: number;
      inQuote: boolean;
      quotePosition: number;
      archived: boolean;
    }>;
    quotePreview: Array<{
      field: string;
      ask: string;
      input: string;
      choices: string[];
    }>;
  };
};