simple_query 0.3.0

Cross-platform typed query API for device data (contacts, media, files, calendar, messages, calls).

simple_query

Cross-platform query facade with typed filters, capability discovery, unified observe events, and binary content handles.

Core API

• getCapabilities()
• query(QueryRequest)
• mutate(MutationRequest)
• batch(BatchRequest)
• observe(ObserveRequest)
• openBinary(BinaryRequest) / closeBinary(handleId)
• callExtension(namespace, method, args)

Example

await SimpleQuery.initialize();

final capabilities = await SimpleQuery.instance.getCapabilities();

final result = await SimpleQuery.instance.query(
  const QueryRequest(
    domain: QueryDomain.contacts,
    page: QueryPage(limit: 50, offset: 0),
  ),
);

Use getCapabilities() before domain operations and handle SimpleQueryError with SimpleQueryErrorCode.notSupported for restricted domains.