File Uploads & Downloads

const upload = await sdk.requestFileUpload({
  fieldKey: 'attachment',         // the file field key in your entity schema
  fileName: 'invoice.pdf',
  mimeType: 'application/pdf',    // optional but recommended
  sizeBytes: file.size,
});

// upload.fileId     — the ID to store on the record
// upload.uploadUrl  — presigned PUT URL (expires in ~15 minutes)
// upload.headers    — headers to include in the PUT request

await fetch(upload.uploadUrl, {
  method: 'PUT',
  headers: {
    'Content-Type': file.type,
    ...upload.headers,
  },
  body: file,   // File or Blob
});

await sdk.updateRecord('expenses', recordId, {
  attachment: upload.fileId,
});

async function uploadAttachment(recordId, file) {
  const upload = await sdk.requestFileUpload({
    fieldKey: 'attachment',
    fileName: file.name,
    mimeType: file.type,
    sizeBytes: file.size,
  });

  const uploadResponse = await fetch(upload.uploadUrl, {
    method: 'PUT',
    headers: { 'Content-Type': file.type, ...upload.headers },
    body: file,
  });

  if (!uploadResponse.ok) {
    throw new Error('Upload to storage failed');
  }

  await sdk.updateRecord('expenses', recordId, {
    attachment: upload.fileId,
  });
}

const file = await sdk.getFileUrl(record.attachment);
// file.url         — presigned download URL (valid for ~1 hour)
// file.fileName    — original file name as uploaded
// file.mimeType    — MIME type, or null if not recorded at upload
// file.expiresAt   — ISO 8601 expiry timestamp

const file = await sdk.getFileUrl(record.attachment);
window.open(file.url, '_blank');

const file = await sdk.getFileUrl(record.attachment);
const a = document.createElement('a');
a.href = file.url;
a.download = file.fileName;
a.click();