const dsm = editor.DataSources;

dsm.add({
  id: 'categories',
  records: [
    { id: 'cat1', uid: 'cat1-uid', name: 'Category 1' },
    { id: 'cat2', uid: 'cat2-uid', name: 'Category 2' },
    { id: 'cat3', uid: 'cat3-uid', name: 'Category 3' },
  ],
});

dsm.add({
 id: 'users',
 records: [
    { id: 'user1', username: 'user_one' },
    { id: 'user2', username: 'user_two' },
    { id: 'user3', username: 'user_three' },
  ],
});

const blogsDS  = dsm.add({
  id: 'blogs',
  records: [
    { id: 'blog1', title: 'First Blog', author: 'user1', categories: ['cat1-uid'] },
    { id: 'blog2', title: 'Second Blog', author: 'user2' },
    { id: 'blog3', title: 'Third Blog', categories: ['cat1-uid', 'cat3-uid'] },
  ],
  schema: {
    author: { type: DataFieldPrimitiveType.relation, target: 'users' },
    categories: { 
      type: DataFieldPrimitiveType.relation, 
      target: 'categories',  // Target data source
      targetField: 'uid',      // Field to match (defaults to 'id')
      isMany: true,          // One-to-many relation
    },
  },
});

// Get resolved records with populated relations
const blogs = blogsDS.getResolvedRecords();
// Result:
[
  { 
    id: 'blog1',
    title: 'First Blog',
    author: { id: 'user1', name: 'user_one' },
    categories: [
      { id: 'cat1', uid: 'cat1-uid', name: 'Category 1' }    
    ]
  },
 // ...
]

dsm.add({
  id: 'blogs',
  name: 'My blogs',
  provider: { get:'https://api.example.com/data' },
});

// The provider API is expected to receive this JSON (schema is optional)
{
  records: [
    { id: 'blog1', title: 'Blog post 1', ... }
  ],
  schema: {
    author: {
      type: 'relation',
      target: 'users'
    }
  }
}