@get-asset/sdk

Contacts

Headless compound for the Customers and Vendors directories. Both are the same surface, so one compound serves both and kind picks the endpoints, the scopes and the copy — "customer" or "vendor". It lists the business's contacts (name, email, phone, active/disabled) with cursor pagination behind LoadMore, filters by a name search and by active/disabled, and owns the whole write flow: CreateTrigger opens a blank draft, EditTrigger opens an existing contact in the same draft, and Save POSTs or PATCHes accordingly. Only name is required — a cleared email or phone is sent as null so it actually clears. DisableTrigger flips a contact’s is_disabled and the disabled listing is a separate view.

Anatomy

Import the primitive and compose the parts you need.

<Contacts.Root kind="customer">
  {/* Header controls — always rendered, outside the state gates */}
  <Contacts.Title />
  <Contacts.Search />
  <Contacts.StatusFilter>
    <Select> {/* any Select-Root-shaped child */}
      <Contacts.StatusFilterItems>
        <Contacts.StatusFilterItem />
      </Contacts.StatusFilterItems>
    </Select>
  </Contacts.StatusFilter>
  <Contacts.CreateTrigger />

  {/* The add panel — a brand-new draft, above the table */}
  <Contacts.Create>
    <Contacts.EditorTitle />
    <Contacts.EditorError />
    <Contacts.NameInput />
    <Contacts.EmailInput />
    <Contacts.PhoneInput />
    <Contacts.Cancel />
    <Contacts.Save />
  </Contacts.Create>

  <Contacts.Loading>
    {/* skeleton rows */}
  </Contacts.Loading>

  <Contacts.Error>
    <Contacts.ErrorMessage />
    <Contacts.Retry />
  </Contacts.Error>

  <Contacts.Empty>
    {/* empty copy — plus <Contacts.ClearSearch /> when a search is active */}
  </Contacts.Empty>

  <Contacts.Success>
    <Contacts.Rows>
      <Contacts.Name />
      <Contacts.Email />
      <Contacts.Phone />
      <Contacts.Status />
      <Contacts.EditTrigger />
      <Contacts.DisableTrigger />
      {/* Editing expands from the row it belongs to */}
      <Contacts.RowEditing>
        <Contacts.EditorTitle />
        {/* the same fields as the add panel */}
      </Contacts.RowEditing>
    </Contacts.Rows>
    <Contacts.LoadMore />
  </Contacts.Success>
</Contacts.Root>

Required scopes

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

• customer:read
• customer:create
• customer:update
• vendor:read
• vendor:create
• vendor:update

API reference

Root props

Parts