Example: Contact Directory

A searchable contact directory demonstrating case-insensitive text search with contains, filtering an enum field with in, and indexing the field the list filters on.

Schema

Entity: Contacts — key: contacts

Field	Type	Notes
`name`	text
`email`	email
`phone`	phone
`company`	text
`role`	text
`website`	text
`relationship`	enum	client / vendor / partner / internal — `indexed: true`
`notes`	multiline

Key Patterns

Text Search with Debounce

let searchTimer;
document.getElementById('search').addEventListener('input', () => {
  clearTimeout(searchTimer);
  searchTimer = setTimeout(loadContacts, 300);
});

Debouncing prevents a request on every keystroke. 300 ms is a good default.

Filter by Relationship

const result = await sdk.listRecords('contacts', {
  filter: { relationship: { in: ['client', 'partner'] } },
  sort: 'name:asc',
});

relationship is declared indexed: true, so this filter is served by an index rather than a scan of every contact. See Indexing fields.

Combined Search + Relationship Filter

const filter = {};
if (query) filter.name = { contains: query };
if (relationship) filter.relationship = relationship;

const result = await sdk.listRecords('contacts', {
  filter: Object.keys(filter).length ? filter : undefined,
  sort: 'name:asc',
});

Multiple filter conditions use AND logic — both must match.

Null-Safe HTML Escaping

Always guard escapeHtml against null/undefined values — optional fields may be absent on older records:

function escapeHtml(str) {
  if (str == null) return '';
  const div = document.createElement('div');
  div.textContent = String(str);
  return div.innerHTML;
}

AI Studio

Platform

AI API

Data API

App Builder SDK

Example: Contact Directory

Schema

Key Patterns

Text Search with Debounce

Filter by Relationship

Combined Search + Relationship Filter

Null-Safe HTML Escaping

​Schema

​Key Patterns

​Text Search with Debounce

​Filter by Relationship

​Combined Search + Relationship Filter

​Null-Safe HTML Escaping

Schema

Key Patterns

Text Search with Debounce

Filter by Relationship

Combined Search + Relationship Filter

Null-Safe HTML Escaping