@get-asset/sdk

Documents

Headless compound that fetches a business's uploaded documents and exposes a slot for every cell — description, file name, date, source, status, and type. Built-in interactions: a drag-and-drop upload zone with per-file queue chips, inline delete confirmation, a per-row actions menu with preview/download/delete actions, and a full-screen lightbox. All four states (loading, error, empty, success) are covered by state-gate wrappers; compose the parts you need and use asChild to hand rendering to your own elements.

Anatomy

Import the primitive and compose the parts you need.

<Documents.Root documentType={type} onDelete={handleDelete} onDownload={handleDownload}>
  <Documents.Success>
    {/* Drag-and-drop upload + per-file queue chips */}
    <Documents.UploadDropzone />
    <Documents.UploadItems>
      <Documents.UploadItem>
        <Documents.UploadItemName />
        <Documents.UploadItemMeta />
        <Documents.UploadItemUploading>…</Documents.UploadItemUploading>
        <Documents.UploadItemSuccess>…</Documents.UploadItemSuccess>
        <Documents.UploadItemError>
          <Documents.UploadItemErrorMessage />
          <Documents.UploadItemDismiss />
        </Documents.UploadItemError>
      </Documents.UploadItem>
    </Documents.UploadItems>

    <Documents.Rows>
      <Documents.Row>
        <Documents.Description />
        <Documents.FileName />
        <Documents.Date />
        <Documents.Source />
        <Documents.Status />
        <Documents.Type />
        <Documents.RowActions />
        <Documents.PreviewAction />
        <Documents.DownloadAction />
        <Documents.DeleteAction />

        {/* Inline delete confirm */}
        <Documents.DeleteConfirm>
          <Documents.DeleteTitle />
          <Documents.DeleteBody />
          <Documents.ConfirmDelete />
          <Documents.CancelDelete />
        </Documents.DeleteConfirm>

        {/* Full-screen lightbox */}
        <Documents.Lightbox>
          <Documents.PreviewImage>
            <Documents.LightboxImage />
          </Documents.PreviewImage>
          <Documents.PreviewPdf>
            <Documents.LightboxFrame />
          </Documents.PreviewPdf>
          <Documents.LightboxClose />
        </Documents.Lightbox>
      </Documents.Row>
    </Documents.Rows>
  </Documents.Success>

  <Documents.Loading>…</Documents.Loading>
  <Documents.Empty>No documents yet.</Documents.Empty>
  <Documents.Error>
    <Documents.ErrorMessage />
    <Documents.Retry>Try Again</Documents.Retry>
  </Documents.Error>
</Documents.Root>

Required scopes

The access token used by AssetProvider must include these scopes for this primitive to fetch data successfully:

• document:read
• document:create
• document:delete

API reference

Root props

Parts