FirstOrFail extension

Model retrieval helpers that map to Archery ORM "or fail" methods.

These helpers forward to Model.firstOrFail and Model.findOrFail, passing through the current request so the ORM can generate request-aware failure responses.

Example:

final user = await request.firstOrFail<User>(
  field: 'email',
  value: 'jane@example.com',
);
on

Methods

findOrFail<T extends Model>({required dynamic id, DatabaseDisk disk = Model.defaultDisk}) → Future

Available on HttpRequest, provided by the FirstOrFail extension

Retrieves a model by primary identifier or fails.
firstOrFail<T extends Model>({required String field, required dynamic value, String comp = "==", DatabaseDisk disk = Model.defaultDisk}) → Future

Available on HttpRequest, provided by the FirstOrFail extension

Retrieves the first model matching the given field/value pair or fails.