#ctx.dataSource

dataSource: DataSource;

class DataSource {
  constructor(options?: Record<string, any>);

  // Read-only properties
  get flowEngine(): FlowEngine;   // current FlowEngine instance
  get displayName(): string;      // display name (i18n supported)
  get key(): string;              // data source key, e.g. 'main'

  // Collection methods
  getCollections(): Collection[];                      // list all collections
  getCollection(name: string): Collection | undefined;  // get by name
  getAssociation(associationName: string): CollectionField | undefined; // get association field (hasMany / belongsTo)

  // Collection management
  addCollection(collection: Collection | CollectionOptions): void;
  updateCollection(newOptions: CollectionOptions): void;
  upsertCollection(options: CollectionOptions): Collection | undefined;
  upsertCollections(collections: CollectionOptions[], options?: { clearFields?: boolean }): void;
  removeCollection(name: string): void;
  clearCollections(): void;

  // Field metadata
  getCollectionField(fieldPath: string): CollectionField | undefined;
}

ctx.dataSource.key;         // data source key, e.g. 'main'
ctx.dataSource.displayName; // display name (i18n supported)

// List all collections
const collections = ctx.dataSource.getCollections();

// Get collection by name
const users = ctx.dataSource.getCollection('users');

// Get field definition by collection.field path
const field = ctx.dataSource.getCollectionField('users.profile.avatar');