coregen-cli 3.1.6__py3-none-any.whl

generators/static/templates/core/model/value_objects_template.jinja

@@ -0,0 +1,135 @@
+/*
+ * Core value objects for domain-driven design
+ * Provides base classes for type-safe value objects:
+ * - ValueObject<T>: Abstract base for all value objects
+ * - Concrete implementations for common types (strings, emails, etc.)
+ * - Validation integration with Either types
+ * - Immutability and equality built-in
+ * 
+ * Value objects ensure data integrity and type safety
+ * throughout the domain layer by encapsulating validation logic
+ */
+
+import 'package:dartz/dartz.dart';
+import 'package:meta/meta.dart';
+import 'package:uuid/uuid.dart';
+import 'package:[[project_name]]/core/model/common_interfaces.dart';
+import 'package:[[project_name]]/core/model/errors.dart';
+import 'package:[[project_name]]/core/model/failures.dart';
+import 'package:[[project_name]]/core/model/value_validators.dart';
+
+// Used for attributes within the domain. Each attribute is a ValueObject<T>
+// Example:
+//
+// Note({required Description description})
+//
+// Description extends a ValueObject<String> and has a validator that ensures, for example, that the string is not empty
+//
+// NOTE:  All domain ValueObjects extend ValueObject<T>
+//        Each domain ValueObject has a validator specified in core/value_validators.dart
+//        Validators return an Either<ValueFailure<T>, T> representing the result of the validation
+//        If validation fails, a ValueFailure<T> is returned with the reason for the failure
+//        If validation succeeds, the valid value of type T is returned
+//
+//        The Failures defined in the domain folder (e.g. note_failure.dart) are instead used to represent specific errors
+//        that can occur during the execution of operations in the domain (e.g. error while saving a note)
+//        These Failures are used to handle errors at the application level and not for data validation
+
+@immutable
+abstract class ValueObject<T> implements IValidatable {
+  const ValueObject();
+  Either<ValueFailure<T>, T> get value;
+
+  /// Throws [UnexpectedValueError] containing the [ValueFailure]
+  T getOrCrash() {
+    // id = identity - same as writing (right) => right
+    return value.fold((ValueFailure<T> f) => throw UnexpectedValueError(f), id);
+  }
+
+  T getOrElse(T dflt) {
+    return value.getOrElse(() => dflt);
+  }
+
+  /// Returns the [ValueFailure] if the value is invalid, otherwise returns [Unit]
+  ///
+  /// Example:
+  ///
+  /// extension NoteX on Note {
+  ///   Option<ValueFailure<dynamic>> get failureOption {
+  ///     return description.failureOrUnit
+  ///         .andThen(color.failureOrUnit)
+  ///         .andThen(todos.failureOrUnit)
+  ///         .andThen(
+  ///           todos
+  ///               .getOrCrash()
+  ///               .map((todoItem) => todoItem.failureOption)
+  ///               .filter((o) => o.isSome())
+  ///               .getOrElse(0, (_) => none())
+  ///               .fold(() => right(unit), (f) => left(f)),
+  ///         )
+  ///         .fold((f) => some(f), (_) => none());
+  ///   }
+  /// }
+  ///
+  /// Usage in a Widget:
+  /// if (note.failureOption.isSome()) {
+  ///   return ErrorNoteCard(note: note);
+  /// }
+  Either<ValueFailure<dynamic>, Unit> get failureOrUnit {
+    return value.fold(
+      (ValueFailure<T> l) => left(l),
+      (T r) => right(unit),
+    );
+  }
+
+  @override
+  bool isValid() {
+    return value.isRight();
+  }
+
+  @override
+  bool operator ==(Object o) {
+    if (identical(this, o)) return true;
+    return o is ValueObject<T> && o.value == value;
+  }
+
+  @override
+  int get hashCode => value.hashCode;
+
+  @override
+  String toString() => 'Value([[value]])';
+}
+
+class UniqueId extends ValueObject<String> {
+  @override
+  final Either<ValueFailure<String>, String> value;
+
+  // We cannot let a simple String be passed in. This would allow for possible non-unique IDs.
+  factory UniqueId() {
+    return UniqueId._(
+      right(const Uuid().v1()),
+    );
+  }
+
+  /// Used with strings we trust are unique, such as database IDs.
+  factory UniqueId.fromUniqueString(String uniqueIdStr) {
+    return UniqueId._(
+      right(uniqueIdStr),
+    );
+  }
+
+  const UniqueId._(this.value);
+}
+
+class StringSingleLine extends ValueObject<String> {
+  @override
+  final Either<ValueFailure<String>, String> value;
+
+  factory StringSingleLine(String input) {
+    return StringSingleLine._(
+      validateSingleLine(input),
+    );
+  }
+
+  const StringSingleLine._(this.value);
+}

generators/static/templates/core/model/value_validators_template.jinja

@@ -0,0 +1,105 @@
+import 'package:dartz/dartz.dart';
+import 'package:[[project_name]]/core/model/failures.dart';
+
+// Used to validate ValueObjects within the domain
+// Example:
+//
+// Note({required Description description})
+//
+// Description extends a ValueObject<String> and has a validator that ensures, for example, that the string is not empty
+//
+//
+// class Description extends ValueObject<String> {
+//   @override
+//   final Either<ValueFailure<String>, String> value;
+//   static const maxLength = 1000;
+//   factory Description(String input) {
+//     assert(input != null);
+//     return Description._(
+//       validateMaxStringLength(input, maxLength).flatMap(validateStringNotEmpty),
+//     );
+//   }
+//   const Description._(this.value);
+// }
+//
+//
+// NOTE:  All domain ValueObjects extend ValueObject<T>
+//        Each domain ValueObject has a validator specified in core/value_validators.dart
+//        Validators return an Either<ValueFailure<T>, T> representing the result of the validation
+//        If validation fails, a ValueFailure<T> is returned with the reason for the failure
+//        If validation succeeds, the valid value of type T is returned
+//
+//        The Failures defined in the domain folder (e.g. note_failure.dart) are instead used to represent specific errors
+//        that can occur during the execution of operations in the domain (e.g. error while saving a note)
+//        These Failures are used to handle errors at the application level and not for data validation
+
+Either<ValueFailure<String>, String> validateMaxStringLength(
+  String input,
+  int maxLength,
+) {
+  if (input.length <= maxLength) {
+    return right(input);
+  } else {
+    return left(ValueFailure<String>.exceedingLength(
+      failedValue: input,
+      max: maxLength,
+    ));
+  }
+}
+
+Either<ValueFailure<String>, String> validateStringNotEmpty(String input) {
+  if (input.isEmpty) {
+    return left(ValueFailure<String>.empty(failedValue: input));
+  } else {
+    return right(input);
+  }
+}
+
+Either<ValueFailure<String>, String> validateSingleLine(String input) {
+  if (input.contains('\n')) {
+    return left(ValueFailure<String>.multiline(failedValue: input));
+  } else {
+    return right(input);
+  }
+}
+
+Either<ValueFailure<List<T>>, List<T>> validateMaxListLength<T>(List<T> input, int maxLength) {
+  if (input.length <= maxLength) {
+    return right(input);
+  } else {
+    return left(ValueFailure<List<T>>.listTooLong(
+      failedValue: input,
+      max: maxLength,
+    ));
+  }
+}
+
+Either<ValueFailure<String>, String> validateEmailAddress(String input) {
+  // Maybe not the most robust way of email validation but it__STRING_3__*+-/=?^_`{|}~]+@[a-zA-Z0-9]+\.[a-zA-Z]+__STRING_4__";
+  const String emailRegex = r"^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,253}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,253}[a-zA-Z0-9])?)*$";
+  if (RegExp(emailRegex).hasMatch(input)) {
+    return right(input);
+  } else {
+    return left(ValueFailure<String>.invalidEmail(failedValue: input));
+  }
+}
+
+Either<ValueFailure<String>, String> validatePassword(String input) {
+  // You can also add some advanced password checks (uppercase/lowercase, at least 1 number, ...)
+  if (input.length >= 6) {
+    return right(input);
+  } else {
+    return left(ValueFailure<String>.shortPassword(failedValue: input));
+  }
+}
+
+Either<ValueFailure<String>, String> validateConfirmPassword(
+  String password,
+  String confirmPassword,
+) {
+  if (password == confirmPassword) {
+    return right(confirmPassword);
+  } else {
+    return left(ValueFailure<String>.passwordsDoNotMatch(failedValue: confirmPassword));
+  }
+}

generators/static/templates/core/presentation/app_drawer_template.jinja

@@ -0,0 +1,52 @@
+import 'package:caravaggio_ui/caravaggio_ui.dart';
+import 'package:flutter/material.dart';
+import 'package:go_router/go_router.dart';
+import 'package:[[project_name]]/features/home/home_page.dart';
+{% for drawer_item in drawer_items %}
+import 'package:[[project_name]]/[[drawer_item.name]]/presentation/[[drawer_item.name]]_page.dart';
+{% endfor %}
+
+class AppDrawer extends StatelessWidget {
+  const AppDrawer({super.key});
+
+  @override
+  Widget build(BuildContext context) {
+    return Drawer(
+      child: ListView(
+        padding: EdgeInsets.zero,
+        children: <Widget>[
+          const DrawerHeader(
+            decoration: BoxDecoration(
+              color: Colors.blue,
+            ),
+            child: Text(
+              'App Navigation',
+              style: TextStyle(
+                color: Colors.white,
+                fontSize: 24,
+              ),
+            ),
+          ),
+          CTile.simple(
+            title: 'Home',
+            icon: Icons.home,
+            onTap: () {
+              Navigator.of(context).pop();
+              context.go(HomePage.routeName);
+            },
+          ),
+{% for drawer_item in drawer_items %}
+          CTile.simple(
+            title: '[[drawer_item.name|replace("_", " ")|title]]',
+            icon: Icons.star,
+            onTap: () {
+              Navigator.of(context).pop();
+              context.go([[drawer_item.name|title]]Page.routeName);
+            },
+          ),
+{% endfor %}
+        ],
+      ),
+    );
+  }
+}

generators/static/templates/core/presentation/app_widget_template.jinja

@@ -0,0 +1,41 @@
+import 'package:flutter/material.dart';
+import 'package:caravaggio_ui/caravaggio_ui.dart';
+import 'package:flutter_bloc/flutter_bloc.dart';
+import 'package:provider/single_child_widget.dart' show SingleChildWidget;
+{% if has_login %}
+import 'package:[[project_name]]/features/auth/application/auth_bloc.dart';
+import 'package:[[project_name]]/injection.dart';
+import 'package:[[project_name]]/domain/auth/model/i_auth_facade.dart';
+{% endif %}
+import 'package:[[project_name]]/router.dart';
+
+class AppWidget extends StatelessWidget {
+  const AppWidget({super.key});
+
+  @override
+  Widget build(BuildContext context) {
+    return MultiBlocProvider(
+      providers: <SingleChildWidget>[
+{% if has_login %}
+        BlocProvider<AuthBloc>(create: (BuildContext context) => AuthBloc(getIt<IAuthFacade>())..add(const AuthCheckRequested())),
+{% endif %}
+        // Add blocs here if needed
+      ],
+      child: const _App(),
+    );
+  }
+}
+
+class _App extends StatelessWidget {
+  const _App();
+
+  @override
+  Widget build(BuildContext context) {
+    return MaterialApp.router(
+      title: '[[project_name]]',
+      theme: CUI.themeData,
+      routerConfig: router,
+    );
+  }
+}
+

generators/static/templates/core/presentation/bottom_nav_bar_template.jinja

@@ -0,0 +1,32 @@
+import 'package:flutter/material.dart';
+
+class BottomNavBar extends StatelessWidget {
+  final int currentIndex;
+  final Function(int) onTap;
+
+  const BottomNavBar({
+    super.key,
+    required this.currentIndex,
+    required this.onTap,
+  });
+
+  @override
+  Widget build(BuildContext context) {
+    return BottomNavigationBar(
+      currentIndex: currentIndex,
+      onTap: onTap,
+      items: const [
+        BottomNavigationBarItem(
+          icon: Icon(Icons.home),
+          label: 'Home',
+        ),
+{% for nav_item in nav_items %}
+        BottomNavigationBarItem(
+          icon: Icon(Icons.star),
+          label: '[[nav_item.name|replace("_", " ")|title]]',
+        ),
+{% endfor %}
+      ],
+    );
+  }
+}

generators/static/templates/domain/domain_mapper_template.jinja

@@ -0,0 +1,39 @@
+/*
+ * Mapper template for DTO-Domain conversions
+ * Maps between DTO (API layer) and Domain Entity (business layer)
+ * 
+ * This mapper ensures proper conversion between:
+ * - DTO (from/to API)
+ * - Domain Entity (business logic)
+ *
+ * Extends BaseMapper which provides default toDomainList/toDtoList implementations.
+ */
+
+import 'package:injectable/injectable.dart';
+import 'package:[[project_name]]/core/model/value_objects.dart';
+import 'package:[[project_name]]/core/infrastructure/base_mapper.dart';
+import 'package:[[project_name]]/[[import_prefix]]/model/[[file_name]].dart';
+import 'package:[[project_name]]/[[import_prefix]]/model/value_objects.dart';
+import 'package:[[project_name]]/[[import_prefix]]/infrastructure/[[file_name]]_dto.dart';
+[[mapper_imports]]
+
+@lazySingleton
+class [[entity_name]]Mapper extends BaseMapper<[[entity_name]], [[entity_name]]Dto> {
+[[mapper_fields]]
+
+  [[entity_name]]Mapper([[mapper_constructor_params]]);
+
+  @override
+  [[entity_name]] toDomain([[entity_name]]Dto dto) {
+    return [[entity_name]](
+[[from_dto_fields]]
+    );
+  }
+
+  @override
+  [[entity_name]]Dto toDto([[entity_name]] entity) {
+    return [[entity_name]]Dto(
+[[to_dto_fields]]
+    );
+  }
+}

generators/static/templates/domain/domain_remote_service_template.jinja

@@ -0,0 +1,46 @@
+/*
+ * Remote [[entity_name]] service — Retrofit REST client.
+ */
+
+import 'package:dio/dio.dart';
+import 'package:injectable/injectable.dart';
+import 'package:retrofit/retrofit.dart';
+import 'package:[[project_name]]/apis/common/constants.dart';
+import 'package:[[project_name]]/[[import_prefix]]/infrastructure/[[file_name]]_dto.dart';
+import 'package:[[project_name]]/[[import_prefix]]/infrastructure/i_[[file_name]]_service.dart';
+
+part '[[file_name]]_remote_service.g.dart';
+
+@module
+abstract class [[entity_name]]RemoteModule {
+  @lazySingleton
+  [[entity_name]]RemoteService [[entity_name_camel]]RemoteService(Dio dio) {
+    return [[entity_name]]RemoteService(dio, baseUrl: Constants.dioBaseUrl);
+  }
+}
+
+@RestApi()
+abstract class [[entity_name]]RemoteService implements I[[entity_name]]Service {
+  @factoryMethod
+  factory [[entity_name]]RemoteService(Dio dio, {String baseUrl}) = _[[entity_name]]RemoteService;
+
+  @override
+  @GET('/[[kebab_name]]s')
+  Future<List<[[entity_name]]Dto>> getAll();
+
+  @override
+  @GET('/[[kebab_name]]s/{id}')
+  Future<[[entity_name]]Dto> getById(@Path('id') String id);
+
+  @override
+  @POST('/[[kebab_name]]s')
+  Future<[[entity_name]]Dto> create(@Body() [[entity_name]]Dto [[entity_name_camel]]Dto);
+
+  @override
+  @PUT('/[[kebab_name]]s/{id}')
+  Future<[[entity_name]]Dto> update(@Path('id') String id, @Body() [[entity_name]]Dto [[entity_name_camel]]Dto);
+
+  @override
+  @DELETE('/[[kebab_name]]s/{id}')
+  Future<void> delete(@Path('id') String id);
+}

generators/static/templates/domain/domain_repository_template.jinja

@@ -0,0 +1,90 @@
+/*
+ * Repository implementation template
+ * Provides concrete implementation of repository interface with:
+ * - BaseRepositoryMixin for centralized error handling
+ * - Service for API calls
+ * - Mapper for DTO-Domain conversions
+ * - Injectable dependency registration
+ * 
+ * This repository acts as a bridge between the domain layer and the API layer
+ */
+
+import 'package:dartz/dartz.dart';
+import 'package:injectable/injectable.dart';
+import 'package:[[project_name]]/core/infrastructure/base_repository_mixin.dart';
+import 'package:[[project_name]]/[[import_prefix]]/model/[[file_name]].dart';
+import 'package:[[project_name]]/[[import_prefix]]/model/[[file_name]]_failure.dart';
+import 'package:[[project_name]]/[[import_prefix]]/model/i_[[file_name]]_repository.dart';
+import 'package:[[project_name]]/[[import_prefix]]/infrastructure/[[file_name]]_dto.dart';
+import 'package:[[project_name]]/[[import_prefix]]/infrastructure/i_[[file_name]]_service.dart';
+import 'package:[[project_name]]/[[import_prefix]]/infrastructure/[[file_name]]_mapper.dart';
+
+@Injectable(as: I[[entity_name]]Repository)
+class [[entity_name]]Repository with BaseRepositoryMixin<[[entity_name]]Failure> implements I[[entity_name]]Repository {
+  final I[[entity_name]]Service _service;
+  final [[entity_name]]Mapper _mapper;
+
+  [[entity_name]]Repository(
+    this._service,
+    this._mapper,
+  );
+
+  @override
+  Future<Either<[[entity_name]]Failure, List<[[entity_name]]>>> getAll() {
+    return handleListCall(
+      serviceCall: () => _service.getAll(),
+      mapToDomainList: (List<[[entity_name]]Dto> dtos) => _mapper.toDomainList(dtos),
+      onUnexpected: () => const [[entity_name]]Failure.unexpected(),
+      onNotFound: () => const [[entity_name]]Failure.notFound(),
+      onInsufficientPermission: () => const [[entity_name]]Failure.insufficientPermission(),
+    );
+  }
+
+  @override
+  Future<Either<[[entity_name]]Failure, [[entity_name]]>> getById(String id) {
+    return handleSimpleCall(
+      serviceCall: () => _service.getById(id),
+      mapToDomain: ([[entity_name]]Dto dto) => _mapper.toDomain(dto),
+      onUnexpected: () => const [[entity_name]]Failure.unexpected(),
+      onNotFound: () => const [[entity_name]]Failure.notFound(),
+      onInsufficientPermission: () => const [[entity_name]]Failure.insufficientPermission(),
+    );
+  }
+
+  @override
+  Future<Either<[[entity_name]]Failure, Unit>> create([[entity_name]] item) {
+    return handleUnitCall(
+      serviceCall: () async {
+        final [[entity_name]]Dto dto = _mapper.toDto(item);
+        await _service.create(dto);
+      },
+      onUnexpected: () => const [[entity_name]]Failure.unexpected(),
+      onNotFound: () => const [[entity_name]]Failure.notFound(),
+      onInsufficientPermission: () => const [[entity_name]]Failure.insufficientPermission(),
+    );
+  }
+
+  @override
+  Future<Either<[[entity_name]]Failure, Unit>> update([[entity_name]] item) {
+    return handleUnitCall(
+      serviceCall: () async {
+        final [[entity_name]]Dto dto = _mapper.toDto(item);
+        await _service.update(item.id.getOrCrash(), dto);
+      },
+      onUnexpected: () => const [[entity_name]]Failure.unexpected(),
+      onNotFound: () => const [[entity_name]]Failure.notFound(),
+      onInsufficientPermission: () => const [[entity_name]]Failure.insufficientPermission(),
+      onUnableToUpdate: () => const [[entity_name]]Failure.unableToUpdate(),
+    );
+  }
+
+  @override
+  Future<Either<[[entity_name]]Failure, Unit>> delete(String id) {
+    return handleUnitCall(
+      serviceCall: () => _service.delete(id),
+      onUnexpected: () => const [[entity_name]]Failure.unexpected(),
+      onNotFound: () => const [[entity_name]]Failure.notFound(),
+      onInsufficientPermission: () => const [[entity_name]]Failure.insufficientPermission(),
+    );
+  }
+}

generators/static/templates/domain/domain_service_module_template.jinja

@@ -0,0 +1,23 @@
+/*
+ * Binds I[[entity_name]]Service to mock or remote implementation per DataSourceConfig.
+ */
+
+import 'package:injectable/injectable.dart';
+import 'package:[[project_name]]/apis/common/data_source_config.dart';
+import 'package:[[project_name]]/[[import_prefix]]/infrastructure/i_[[file_name]]_service.dart';
+import 'package:[[project_name]]/[[import_prefix]]/infrastructure/[[file_name]]_remote_service.dart';
+import 'package:[[project_name]]/[[import_prefix]]/infrastructure/mock_[[file_name]]_service.dart';
+
+@module
+abstract class [[entity_name]]ServiceModule {
+  @lazySingleton
+  I[[entity_name]]Service [[entity_name_camel]]Service(
+    [[entity_name]]RemoteService remote,
+    Mock[[entity_name]]Service mock,
+  ) {
+    if (DataSourceConfig.useMock('[[file_name]]')) {
+      return mock;
+    }
+    return remote;
+  }
+}

generators/static/templates/domain/enum_template.jinja

@@ -0,0 +1,3 @@
+enum [[enum_name]] {
+  [[values]],
+}

generators/static/templates/domain/i_domain_service_template.jinja

@@ -0,0 +1,18 @@
+/*
+ * Service interface for [[entity_name]] data access.
+ * Implemented by mock (JSON) and remote (Retrofit) services.
+ */
+
+import 'package:[[project_name]]/[[import_prefix]]/infrastructure/[[file_name]]_dto.dart';
+
+abstract class I[[entity_name]]Service {
+  Future<List<[[entity_name]]Dto>> getAll();
+
+  Future<[[entity_name]]Dto> getById(String id);
+
+  Future<[[entity_name]]Dto> create([[entity_name]]Dto [[entity_name_camel]]Dto);
+
+  Future<[[entity_name]]Dto> update(String id, [[entity_name]]Dto [[entity_name_camel]]Dto);
+
+  Future<void> delete(String id);
+}

generators/static/templates/domain/mock_domain_service_template.jinja

@@ -0,0 +1,73 @@
+/*
+ * Mock [[entity_name]] service — loads seed data from assets/mock/[[file_name]].json.
+ * CRUD mutations are kept in memory for the current app session.
+ */
+
+import 'dart:convert';
+
+import 'package:flutter/services.dart';
+import 'package:injectable/injectable.dart';
+import 'package:[[project_name]]/[[import_prefix]]/infrastructure/[[file_name]]_dto.dart';
+import 'package:[[project_name]]/[[import_prefix]]/infrastructure/i_[[file_name]]_service.dart';
+
+@lazySingleton
+class Mock[[entity_name]]Service implements I[[entity_name]]Service {
+  static const String _assetPath = 'assets/mock/[[file_name]].json';
+
+  List<[[entity_name]]Dto>? _items;
+
+  Future<List<[[entity_name]]Dto>> _loadItems() async {
+    if (_items != null) {
+      return _items!;
+    }
+    final String raw = await rootBundle.loadString(_assetPath);
+    final Map<String, dynamic> decoded = jsonDecode(raw) as Map<String, dynamic>;
+    final List<dynamic> list = decoded['items'] as List<dynamic>? ?? <dynamic>[];
+    _items = list
+        .map((dynamic e) => [[entity_name]]Dto.fromJson(Map<String, dynamic>.from(e as Map)))
+        .toList();
+    return _items!;
+  }
+
+  @override
+  Future<List<[[entity_name]]Dto>> getAll() => _loadItems();
+
+  @override
+  Future<[[entity_name]]Dto> getById(String id) async {
+    final List<[[entity_name]]Dto> items = await _loadItems();
+    for (final [[entity_name]]Dto item in items) {
+      if (item.id == id) {
+        return item;
+      }
+    }
+    throw StateError('[[entity_name]] not found: $id');
+  }
+
+  @override
+  Future<[[entity_name]]Dto> create([[entity_name]]Dto [[entity_name_camel]]Dto) async {
+    final List<[[entity_name]]Dto> items = await _loadItems();
+    items.add([[entity_name_camel]]Dto);
+    return [[entity_name_camel]]Dto;
+  }
+
+  @override
+  Future<[[entity_name]]Dto> update(String id, [[entity_name]]Dto [[entity_name_camel]]Dto) async {
+    final List<[[entity_name]]Dto> items = await _loadItems();
+    final int index = items.indexWhere(([[entity_name]]Dto e) => e.id == id);
+    if (index < 0) {
+      throw StateError('[[entity_name]] not found: $id');
+    }
+    items[index] = [[entity_name_camel]]Dto;
+    return [[entity_name_camel]]Dto;
+  }
+
+  @override
+  Future<void> delete(String id) async {
+    final List<[[entity_name]]Dto> items = await _loadItems();
+    final int before = items.length;
+    items.removeWhere(([[entity_name]]Dto e) => e.id == id);
+    if (items.length == before) {
+      throw StateError('[[entity_name]] not found: $id');
+    }
+  }
+}