first bang implementation

app/lib/features/bangs/data/database/daos/bang.dart

@@ -0,0 +1,98 @@
+import 'package:bang_navigator/features/bangs/data/database/database.dart';
+import 'package:bang_navigator/features/bangs/data/models/bang.dart';
+import 'package:bang_navigator/features/bangs/data/models/bang_data.dart';
+import 'package:drift/drift.dart';
+
+part 'bang.g.dart';
+
+@DriftAccessor()
+class BangDao extends DatabaseAccessor<BangDatabase> with _$BangDaoMixin {
+  BangDao(super.db);
+
+  Selectable<Bang> getBangs({Iterable<BangGroup?>? groups}) {
+    final selectable = select(db.bang);
+    if (groups != null) {
+      selectable.where((t) => t.group.isInValues(groups));
+    }
+
+    return selectable;
+  }
+
+  SingleOrNullSelectable<BangData> getBangData(String trigger) {
+    return select(db.bangDataView)..where((t) => t.trigger.equals(trigger));
+  }
+
+  Selectable<BangData> getBangDataList({Iterable<BangGroup?>? groups}) {
+    final selectable = select(db.bangDataView);
+    if (groups != null) {
+      selectable.where((t) => t.group.isInValues(groups));
+    }
+
+    selectable.orderBy([(t) => OrderingTerm.asc(t.websiteName)]);
+
+    return selectable;
+  }
+
+  Selectable<BangData> getFrequentBangDataList({Iterable<BangGroup?>? groups}) {
+    final selectable = select(db.bangDataView)
+      ..where((t) => t.frequency.isBiggerThanValue(0));
+    if (groups != null) {
+      selectable.where((t) => t.group.isInValues(groups));
+    }
+
+    selectable.orderBy([
+      (t) => OrderingTerm.desc(t.frequency),
+      (t) => OrderingTerm.desc(t.lastUsed),
+    ]);
+
+    return selectable;
+  }
+
+  Future<int> increaseFrequency(String trigger) {
+    return db.bangFrequency.insertOne(
+      BangFrequencyCompanion.insert(
+        trigger: trigger,
+        frequency: 1,
+        lastUsed: DateTime.now().toUtc(),
+      ),
+      onConflict: DoUpdate(
+        (old) => BangFrequencyCompanion.custom(
+          frequency: old.frequency + const Constant(1),
+          lastUsed: Variable(DateTime.now().toUtc()),
+        ),
+      ),
+    );
+  }
+
+  Selectable<BangData> queryBangs(String searchString) {
+    return db.bangQuery(query: db.buildQuery(searchString));
+  }
+
+  Future<void> insertBangs(Iterable<Bang> bangs) {
+    return db.bang.insertAll(bangs);
+  }
+
+  Future<int> upsertIcon(String trigger, Uint8List iconData) {
+    return db.bangIcon.insertOne(
+      BangIconCompanion.insert(
+        trigger: trigger,
+        iconData: iconData,
+        fetchDate: DateTime.now().toUtc(),
+      ),
+      mode: InsertMode.insertOrReplace,
+    );
+  }
+
+  Future<void> replaceBangs(Iterable<Bang> bangs) {
+    return batch(
+      (batch) {
+        batch.replaceAll(db.bang, bangs);
+      },
+    );
+  }
+
+  Future<int> deleteBangs(Iterable<String> triggers) {
+    final statement = delete(db.bang)..where((t) => t.trigger.isIn(triggers));
+    return statement.go();
+  }
+}

app/lib/features/bangs/data/database/daos/bang.g.dart

@@ -0,0 +1,6 @@
+// GENERATED CODE - DO NOT MODIFY BY HAND
+
+part of 'bang.dart';
+
+// ignore_for_file: type=lint
+mixin _$BangDaoMixin on DatabaseAccessor<BangDatabase> {}

app/lib/features/bangs/data/database/database.dart

@@ -0,0 +1,28 @@
+import 'package:bang_navigator/features/bangs/data/database/daos/bang.dart';
+import 'package:bang_navigator/features/bangs/data/database/drift/converters/bang_format.dart';
+import 'package:bang_navigator/features/bangs/data/models/bang.dart';
+import 'package:bang_navigator/features/bangs/data/models/bang_data.dart';
+import 'package:bang_navigator/features/query/domain/tokenizer.dart';
+import 'package:drift/drift.dart';
+
+part 'database.g.dart';
+
+@DriftDatabase(include: {'database.drift'}, daos: [BangDao])
+class BangDatabase extends _$BangDatabase with PrefixQueryBuilderMixin {
+  @override
+  final int schemaVersion = 1;
+
+  @override
+  final int ftsTokenLimit = 6;
+  @override
+  final int ftsMinTokenLength = 2;
+
+  @override
+  MigrationStrategy get migration => MigrationStrategy(
+        beforeOpen: (details) async {
+          await customStatement('PRAGMA foreign_keys = ON;');
+        },
+      );
+
+  BangDatabase(super.e);
+}

app/lib/features/bangs/data/database/database.drift

@@ -0,0 +1,88 @@
+import 'package:bang_navigator/features/bangs/data/database/drift/converters/bang_format.dart';
+import 'package:bang_navigator/features/bangs/data/models/bang_data.dart';
+import 'package:bang_navigator/features/bangs/data/models/bang.dart';
+
+CREATE TABLE bang (
+  "trigger" TEXT PRIMARY KEY NOT NULL,
+  "group" ENUM(BangGroup),
+  website_name TEXT NOT NULL,
+  domain TEXT NOT NULL,
+  url_template TEXT NOT NULL,
+  category TEXT,
+  sub_category TEXT,
+  format TEXT MAPPED BY `const BangFormatConverter()`
+) WITH Bang;
+
+CREATE TABLE bang_frequency (
+  "trigger" TEXT PRIMARY KEY NOT NULL REFERENCES bang ("trigger") ON DELETE CASCADE,
+  frequency INTEGER NOT NULL,
+  last_used DATETIME NOT NULL
+);
+
+CREATE TABLE bang_icon (
+  "trigger" TEXT PRIMARY KEY NOT NULL REFERENCES bang ("trigger") ON DELETE CASCADE,
+  icon_data BLOB NOT NULL,
+  fetch_date DATETIME NOT NULL
+);
+
+CREATE VIRTUAL TABLE bang_fts 
+	USING fts5(
+    trigger,
+    website_name,
+    content=bang,
+    prefix='2 3'
+  );
+
+CREATE VIEW bang_data_view WITH BangData AS
+  SELECT
+    b.*,
+    bf.frequency,
+    bf.last_used,
+    bi.icon_data
+  FROM
+    bang b
+  LEFT JOIN
+    bang_frequency bf ON b."trigger" = bf."trigger"
+  LEFT JOIN
+    bang_icon bi ON b."trigger" = bi."trigger";
+
+-- Triggers to keep the FTS index up to date.
+CREATE TRIGGER bang_after_insert AFTER INSERT ON bang BEGIN
+  INSERT INTO 
+    bang_fts(rowid, "trigger", website_name) 
+    VALUES (new.rowid, new."trigger", new.website_name);
+END;
+CREATE TRIGGER bang_after_delete AFTER DELETE ON bang BEGIN
+  INSERT INTO 
+    bang_fts(bang_fts, rowid, "trigger", website_name) 
+    VALUES('delete', old.rowid, old."trigger", old.website_name);
+END;
+CREATE TRIGGER bang_after_update AFTER UPDATE ON bang BEGIN
+  INSERT INTO 
+    bang_fts(bang_fts, rowid, "trigger", website_name) 
+    VALUES('delete', old.rowid, old."trigger", old.website_name);
+  INSERT INTO 
+    bang_fts(rowid, "trigger", website_name) 
+    VALUES (new.rowid, new."trigger", new.website_name);
+END;
+
+optimizeFtsIndex:
+  INSERT INTO bang_fts(bang_fts) VALUES ('optimize');
+
+bangQuery WITH BangData:
+  SELECT
+    b.*,
+    bf.frequency,
+    bf.last_used,
+    bi.icon_data
+  FROM
+    bang_fts(:query) fts
+  INNER JOIN
+    bang b ON b.rowid = fts.rowid
+  LEFT JOIN
+    bang_frequency bf ON b."trigger" = bf."trigger"
+  LEFT JOIN
+    bang_icon bi ON b."trigger" = bi."trigger"
+  ORDER BY
+    RANK,
+    bf.frequency NULLS LAST;

app/lib/features/bangs/data/database/drift/converters/bang_format.dart

@@ -0,0 +1,26 @@
+import 'dart:convert';
+
+import 'package:bang_navigator/features/bangs/data/models/bang.dart';
+import 'package:drift/drift.dart';
+
+class BangFormatConverter extends TypeConverter<Set<BangFormat>?, String?> {
+  const BangFormatConverter();
+
+  @override
+  Set<BangFormat>? fromSql(String? fromDb) {
+    if (fromDb == null) {
+      return null;
+    }
+
+    return Bang.decodeFormat(jsonDecode(fromDb) as List);
+  }
+
+  @override
+  String? toSql(Set<BangFormat>? value) {
+    if (value == null) {
+      return null;
+    }
+
+    return jsonEncode(Bang.encodeFormat(value));
+  }
+}

app/lib/features/bangs/data/models/bang.dart

@@ -0,0 +1,145 @@
+import 'package:bang_navigator/features/bangs/data/database/database.dart'
+    show BangCompanion;
+import 'package:copy_with_extension/copy_with_extension.dart';
+import 'package:drift/drift.dart' show Expression, Insertable, Value;
+import 'package:fast_equatable/fast_equatable.dart';
+import 'package:json_annotation/json_annotation.dart';
+
+part 'bang.g.dart';
+
+enum BangGroup {
+  assistant,
+  kagi,
+}
+
+enum BangFormat {
+  ///When the bang is invoked with no query, opens the base path of the URL (/)
+  ///instead of any path given in the template (g., /search)
+  @JsonValue('open_base_path')
+  openBasePath,
+
+  ///URL encode the search terms. Some sites do not work with this, so it can
+  ///be disabled by omitting this.
+  @JsonValue('url_encode_placeholder')
+  urlEncodePlaceholder,
+
+  ///URL encodes spaces as +, instead of %20. Some sites only work correctly
+  ///with one or the other.
+  @JsonValue('url_encode_space_to_plus')
+  urlEncodeSpaceToPlus,
+}
+
+@JsonSerializable()
+@CopyWith()
+class Bang with FastEquatable implements Insertable<Bang> {
+  static const _templateQueryPlaceholder = '{{{s}}}';
+
+  @JsonKey(includeFromJson: false, includeToJson: false)
+  final BangGroup? group;
+
+  ///The name of the website associated with the bang.
+  @JsonKey(name: 's')
+  final String websiteName;
+
+  ///The domain name of the websit
+  @JsonKey(name: 'd')
+  final String domain;
+
+  ///The specific trigger word or phrase used to invoke the bang.
+  @JsonKey(name: 't')
+  final String trigger;
+
+  ///The URL template to use when the bang is invoked, where `{{{s}}}` is replaced by the user's query.
+  @JsonKey(name: 'u')
+  final String urlTemplate;
+
+  ///The category of the website, if applicable
+  @JsonKey(name: 'c')
+  final String? category;
+
+  ///The subcategory of the website, if applicable
+  @JsonKey(name: 'sc')
+  final String? subCategory;
+
+  ///The format flags indicating how the query should be processed.
+  @JsonKey(name: 'fmt')
+  final Set<BangFormat>? format;
+
+  String formatQuery(String input) {
+    return (format == null ||
+            format!.contains(BangFormat.urlEncodePlaceholder) == true)
+        ? (format == null ||
+                format?.contains(BangFormat.urlEncodeSpaceToPlus) == true)
+            ? Uri.encodeQueryComponent(input)
+            : Uri.encodeComponent(input)
+        : input;
+  }
+
+  Uri getUrl(String? query) {
+    final url = (query != null)
+        ? urlTemplate.replaceAll(_templateQueryPlaceholder, formatQuery(query))
+        : urlTemplate;
+
+    var template = Uri.parse(url);
+    if (!template.hasScheme || template.origin.isEmpty) {
+      template = Uri.https(domain).replace(
+        path: template.path,
+        query: template.query,
+      );
+    }
+
+    return template;
+  }
+
+  static Set<BangFormat> decodeFormat(Iterable input) {
+    return input.map((e) => $enumDecode(_$BangFormatEnumMap, e)).toSet();
+  }
+
+  static List<String> encodeFormat(Iterable<BangFormat> format) {
+    return format.map((e) => _$BangFormatEnumMap[e]!).toList();
+  }
+
+  Bang({
+    required this.websiteName,
+    required this.domain,
+    required this.trigger,
+    required this.urlTemplate,
+    this.group,
+    this.category,
+    this.subCategory,
+    this.format,
+  });
+
+  factory Bang.fromJson(Map<String, dynamic> json) => _$BangFromJson(json);
+
+  Map<String, dynamic> toJson() => _$BangToJson(this);
+
+  @override
+  bool get cacheHash => true;
+
+  @override
+  List<Object?> get hashParameters => [
+        group,
+        websiteName,
+        domain,
+        trigger,
+        urlTemplate,
+        category,
+        subCategory,
+        format,
+      ];
+
+  @override
+  Map<String, Expression<Object>> toColumns(bool nullToAbsent) {
+    return BangCompanion(
+      trigger: Value(trigger),
+      websiteName: Value(websiteName),
+      domain: Value(domain),
+      urlTemplate: Value(urlTemplate),
+      group: Value.absentIfNull(group),
+      category: Value.absentIfNull(category),
+      subCategory: Value.absentIfNull(subCategory),
+      format: Value.absentIfNull(format),
+    ).toColumns(nullToAbsent);
+  }
+}

app/lib/features/bangs/data/models/bang.g.dart

@@ -0,0 +1,167 @@
+// GENERATED CODE - DO NOT MODIFY BY HAND
+
+part of 'bang.dart';
+
+// **************************************************************************
+// CopyWithGenerator
+// **************************************************************************
+
+abstract class _$BangCWProxy {
+  Bang websiteName(String websiteName);
+
+  Bang domain(String domain);
+
+  Bang trigger(String trigger);
+
+  Bang urlTemplate(String urlTemplate);
+
+  Bang group(BangGroup? group);
+
+  Bang category(String? category);
+
+  Bang subCategory(String? subCategory);
+
+  Bang format(Set<BangFormat>? format);
+
+  /// This function **does support** nullification of nullable fields. All `null` values passed to `non-nullable` fields will be ignored. You can also use `Bang(...).copyWith.fieldName(...)` to override fields one at a time with nullification support.
+  ///
+  /// Usage
+  /// ```dart
+  /// Bang(...).copyWith(id: 12, name: "My name")
+  /// ````
+  Bang call({
+    String? websiteName,
+    String? domain,
+    String? trigger,
+    String? urlTemplate,
+    BangGroup? group,
+    String? category,
+    String? subCategory,
+    Set<BangFormat>? format,
+  });
+}
+
+/// Proxy class for `copyWith` functionality. This is a callable class and can be used as follows: `instanceOfBang.copyWith(...)`. Additionally contains functions for specific fields e.g. `instanceOfBang.copyWith.fieldName(...)`
+class _$BangCWProxyImpl implements _$BangCWProxy {
+  const _$BangCWProxyImpl(this._value);
+
+  final Bang _value;
+
+  @override
+  Bang websiteName(String websiteName) => this(websiteName: websiteName);
+
+  @override
+  Bang domain(String domain) => this(domain: domain);
+
+  @override
+  Bang trigger(String trigger) => this(trigger: trigger);
+
+  @override
+  Bang urlTemplate(String urlTemplate) => this(urlTemplate: urlTemplate);
+
+  @override
+  Bang group(BangGroup? group) => this(group: group);
+
+  @override
+  Bang category(String? category) => this(category: category);
+
+  @override
+  Bang subCategory(String? subCategory) => this(subCategory: subCategory);
+
+  @override
+  Bang format(Set<BangFormat>? format) => this(format: format);
+
+  @override
+
+  /// This function **does support** nullification of nullable fields. All `null` values passed to `non-nullable` fields will be ignored. You can also use `Bang(...).copyWith.fieldName(...)` to override fields one at a time with nullification support.
+  ///
+  /// Usage
+  /// ```dart
+  /// Bang(...).copyWith(id: 12, name: "My name")
+  /// ````
+  Bang call({
+    Object? websiteName = const $CopyWithPlaceholder(),
+    Object? domain = const $CopyWithPlaceholder(),
+    Object? trigger = const $CopyWithPlaceholder(),
+    Object? urlTemplate = const $CopyWithPlaceholder(),
+    Object? group = const $CopyWithPlaceholder(),
+    Object? category = const $CopyWithPlaceholder(),
+    Object? subCategory = const $CopyWithPlaceholder(),
+    Object? format = const $CopyWithPlaceholder(),
+  }) {
+    return Bang(
+      websiteName:
+          websiteName == const $CopyWithPlaceholder() || websiteName == null
+              ? _value.websiteName
+              // ignore: cast_nullable_to_non_nullable
+              : websiteName as String,
+      domain: domain == const $CopyWithPlaceholder() || domain == null
+          ? _value.domain
+          // ignore: cast_nullable_to_non_nullable
+          : domain as String,
+      trigger: trigger == const $CopyWithPlaceholder() || trigger == null
+          ? _value.trigger
+          // ignore: cast_nullable_to_non_nullable
+          : trigger as String,
+      urlTemplate:
+          urlTemplate == const $CopyWithPlaceholder() || urlTemplate == null
+              ? _value.urlTemplate
+              // ignore: cast_nullable_to_non_nullable
+              : urlTemplate as String,
+      group: group == const $CopyWithPlaceholder()
+          ? _value.group
+          // ignore: cast_nullable_to_non_nullable
+          : group as BangGroup?,
+      category: category == const $CopyWithPlaceholder()
+          ? _value.category
+          // ignore: cast_nullable_to_non_nullable
+          : category as String?,
+      subCategory: subCategory == const $CopyWithPlaceholder()
+          ? _value.subCategory
+          // ignore: cast_nullable_to_non_nullable
+          : subCategory as String?,
+      format: format == const $CopyWithPlaceholder()
+          ? _value.format
+          // ignore: cast_nullable_to_non_nullable
+          : format as Set<BangFormat>?,
+    );
+  }
+}
+
+extension $BangCopyWith on Bang {
+  /// Returns a callable class that can be used as follows: `instanceOfBang.copyWith(...)` or like so:`instanceOfBang.copyWith.fieldName(...)`.
+  // ignore: library_private_types_in_public_api
+  _$BangCWProxy get copyWith => _$BangCWProxyImpl(this);
+}
+
+// **************************************************************************
+// JsonSerializableGenerator
+// **************************************************************************
+
+Bang _$BangFromJson(Map<String, dynamic> json) => Bang(
+      websiteName: json['s'] as String,
+      domain: json['d'] as String,
+      trigger: json['t'] as String,
+      urlTemplate: json['u'] as String,
+      category: json['c'] as String?,
+      subCategory: json['sc'] as String?,
+      format: (json['fmt'] as List<dynamic>?)
+          ?.map((e) => $enumDecode(_$BangFormatEnumMap, e))
+          .toSet(),
+    );
+
+Map<String, dynamic> _$BangToJson(Bang instance) => <String, dynamic>{
+      's': instance.websiteName,
+      'd': instance.domain,
+      't': instance.trigger,
+      'u': instance.urlTemplate,
+      'c': instance.category,
+      'sc': instance.subCategory,
+      'fmt': instance.format?.map((e) => _$BangFormatEnumMap[e]!).toList(),
+    };
+
+const _$BangFormatEnumMap = {
+  BangFormat.openBasePath: 'open_base_path',
+  BangFormat.urlEncodePlaceholder: 'url_encode_placeholder',
+  BangFormat.urlEncodeSpaceToPlus: 'url_encode_space_to_plus',
+};

app/lib/features/bangs/data/models/bang_data.dart

@@ -0,0 +1,37 @@
+import 'package:bang_navigator/features/bangs/data/models/bang.dart';
+import 'package:copy_with_extension/copy_with_extension.dart';
+import 'package:drift/drift.dart';
+
+part 'bang_data.g.dart';
+
+@CopyWith()
+class BangData extends Bang {
+  final int frequency;
+  final DateTime? lastUsed;
+
+  final Uint8List? iconData;
+
+  BangData({
+    required super.websiteName,
+    required super.domain,
+    required super.trigger,
+    required super.urlTemplate,
+    super.category,
+    super.subCategory,
+    super.format,
+    int? frequency,
+    this.lastUsed,
+    this.iconData,
+  }) : frequency = frequency ?? 0;
+
+  @override
+  bool get cacheHash => true;
+
+  @override
+  List<Object?> get hashParameters => [
+        ...super.hashParameters,
+        frequency,
+        lastUsed,
+        iconData,
+      ];
+}

app/lib/features/bangs/data/models/bang_data.g.dart

@@ -0,0 +1,157 @@
+// GENERATED CODE - DO NOT MODIFY BY HAND
+
+part of 'bang_data.dart';
+
+// **************************************************************************
+// CopyWithGenerator
+// **************************************************************************
+
+abstract class _$BangDataCWProxy {
+  BangData websiteName(String websiteName);
+
+  BangData domain(String domain);
+
+  BangData trigger(String trigger);
+
+  BangData urlTemplate(String urlTemplate);
+
+  BangData category(String? category);
+
+  BangData subCategory(String? subCategory);
+
+  BangData format(Set<BangFormat>? format);
+
+  BangData frequency(int? frequency);
+
+  BangData lastUsed(DateTime? lastUsed);
+
+  BangData iconData(Uint8List? iconData);
+
+  /// This function **does support** nullification of nullable fields. All `null` values passed to `non-nullable` fields will be ignored. You can also use `BangData(...).copyWith.fieldName(...)` to override fields one at a time with nullification support.
+  ///
+  /// Usage
+  /// ```dart
+  /// BangData(...).copyWith(id: 12, name: "My name")
+  /// ````
+  BangData call({
+    String? websiteName,
+    String? domain,
+    String? trigger,
+    String? urlTemplate,
+    String? category,
+    String? subCategory,
+    Set<BangFormat>? format,
+    int? frequency,
+    DateTime? lastUsed,
+    Uint8List? iconData,
+  });
+}
+
+/// Proxy class for `copyWith` functionality. This is a callable class and can be used as follows: `instanceOfBangData.copyWith(...)`. Additionally contains functions for specific fields e.g. `instanceOfBangData.copyWith.fieldName(...)`
+class _$BangDataCWProxyImpl implements _$BangDataCWProxy {
+  const _$BangDataCWProxyImpl(this._value);
+
+  final BangData _value;
+
+  @override
+  BangData websiteName(String websiteName) => this(websiteName: websiteName);
+
+  @override
+  BangData domain(String domain) => this(domain: domain);
+
+  @override
+  BangData trigger(String trigger) => this(trigger: trigger);
+
+  @override
+  BangData urlTemplate(String urlTemplate) => this(urlTemplate: urlTemplate);
+
+  @override
+  BangData category(String? category) => this(category: category);
+
+  @override
+  BangData subCategory(String? subCategory) => this(subCategory: subCategory);
+
+  @override
+  BangData format(Set<BangFormat>? format) => this(format: format);
+
+  @override
+  BangData frequency(int? frequency) => this(frequency: frequency);
+
+  @override
+  BangData lastUsed(DateTime? lastUsed) => this(lastUsed: lastUsed);
+
+  @override
+  BangData iconData(Uint8List? iconData) => this(iconData: iconData);
+
+  @override
+
+  /// This function **does support** nullification of nullable fields. All `null` values passed to `non-nullable` fields will be ignored. You can also use `BangData(...).copyWith.fieldName(...)` to override fields one at a time with nullification support.
+  ///
+  /// Usage
+  /// ```dart
+  /// BangData(...).copyWith(id: 12, name: "My name")
+  /// ````
+  BangData call({
+    Object? websiteName = const $CopyWithPlaceholder(),
+    Object? domain = const $CopyWithPlaceholder(),
+    Object? trigger = const $CopyWithPlaceholder(),
+    Object? urlTemplate = const $CopyWithPlaceholder(),
+    Object? category = const $CopyWithPlaceholder(),
+    Object? subCategory = const $CopyWithPlaceholder(),
+    Object? format = const $CopyWithPlaceholder(),
+    Object? frequency = const $CopyWithPlaceholder(),
+    Object? lastUsed = const $CopyWithPlaceholder(),
+    Object? iconData = const $CopyWithPlaceholder(),
+  }) {
+    return BangData(
+      websiteName:
+          websiteName == const $CopyWithPlaceholder() || websiteName == null
+              ? _value.websiteName
+              // ignore: cast_nullable_to_non_nullable
+              : websiteName as String,
+      domain: domain == const $CopyWithPlaceholder() || domain == null
+          ? _value.domain
+          // ignore: cast_nullable_to_non_nullable
+          : domain as String,
+      trigger: trigger == const $CopyWithPlaceholder() || trigger == null
+          ? _value.trigger
+          // ignore: cast_nullable_to_non_nullable
+          : trigger as String,
+      urlTemplate:
+          urlTemplate == const $CopyWithPlaceholder() || urlTemplate == null
+              ? _value.urlTemplate
+              // ignore: cast_nullable_to_non_nullable
+              : urlTemplate as String,
+      category: category == const $CopyWithPlaceholder()
+          ? _value.category
+          // ignore: cast_nullable_to_non_nullable
+          : category as String?,
+      subCategory: subCategory == const $CopyWithPlaceholder()
+          ? _value.subCategory
+          // ignore: cast_nullable_to_non_nullable
+          : subCategory as String?,
+      format: format == const $CopyWithPlaceholder()
+          ? _value.format
+          // ignore: cast_nullable_to_non_nullable
+          : format as Set<BangFormat>?,
+      frequency: frequency == const $CopyWithPlaceholder()
+          ? _value.frequency
+          // ignore: cast_nullable_to_non_nullable
+          : frequency as int?,
+      lastUsed: lastUsed == const $CopyWithPlaceholder()
+          ? _value.lastUsed
+          // ignore: cast_nullable_to_non_nullable
+          : lastUsed as DateTime?,
+      iconData: iconData == const $CopyWithPlaceholder()
+          ? _value.iconData
+          // ignore: cast_nullable_to_non_nullable
+          : iconData as Uint8List?,
+    );
+  }
+}
+
+extension $BangDataCopyWith on BangData {
+  /// Returns a callable class that can be used as follows: `instanceOfBangData.copyWith(...)` or like so:`instanceOfBangData.copyWith.fieldName(...)`.
+  // ignore: library_private_types_in_public_api
+  _$BangDataCWProxy get copyWith => _$BangDataCWProxyImpl(this);
+}

app/lib/features/bangs/data/providers.dart

@@ -0,0 +1,37 @@
+import 'package:bang_navigator/features/bangs/data/database/database.dart';
+import 'package:drift/drift.dart';
+import 'package:drift/native.dart';
+import 'package:path/path.dart' as p;
+import 'package:path_provider/path_provider.dart' as path_provider;
+import 'package:riverpod_annotation/riverpod_annotation.dart';
+import 'package:sqlite3/sqlite3.dart';
+import 'package:sqlite3_flutter_libs/sqlite3_flutter_libs.dart';
+import 'package:universal_io/io.dart';
+
+part 'providers.g.dart';
+
+@Riverpod(keepAlive: true)
+BangDatabase bangDatabase(BangDatabaseRef ref) {
+  return BangDatabase(
+    LazyDatabase(() async {
+      // put the database file, called db.sqlite here, into the documents folder
+      // for your app.
+      final dbFolder = await path_provider.getApplicationDocumentsDirectory();
+      final file = File(p.join(dbFolder.path, 'bang.db'));
+
+      // Also work around limitations on old Android versions
+      if (Platform.isAndroid) {
+        await applyWorkaroundToOpenSqlite3OnOldAndroidVersions();
+      }
+
+      // Make sqlite3 pick a more suitable location for temporary files - the
+      // one from the system may be inaccessible due to sandboxing.
+      final cachebase = (await path_provider.getTemporaryDirectory()).path;
+      // We can't access /tmp on Android, which sqlite3 would try by default.
+      // Explicitly tell it about the correct temporary directory.
+      sqlite3.tempDirectory = cachebase;
+
+      return NativeDatabase.createInBackground(file);
+    }),
+  );
+}

app/lib/features/bangs/data/providers.g.dart

@@ -0,0 +1,24 @@
+// GENERATED CODE - DO NOT MODIFY BY HAND
+
+part of 'providers.dart';
+
+// **************************************************************************
+// RiverpodGenerator
+// **************************************************************************
+
+String _$bangDatabaseHash() => r'bbca2edf32faa378dcb6270b12019758d5156662';
+
+/// See also [bangDatabase].
+@ProviderFor(bangDatabase)
+final bangDatabaseProvider = Provider<BangDatabase>.internal(
+  bangDatabase,
+  name: r'bangDatabaseProvider',
+  debugGetCreateSourceHash:
+      const bool.fromEnvironment('dart.vm.product') ? null : _$bangDatabaseHash,
+  dependencies: null,
+  allTransitiveDependencies: null,
+);
+
+typedef BangDatabaseRef = ProviderRef<BangDatabase>;
+// ignore_for_file: type=lint
+// ignore_for_file: subtype_of_sealed_class, invalid_use_of_internal_member, invalid_use_of_visible_for_testing_member

app/lib/features/bangs/data/services/bang_source.dart

@@ -0,0 +1,43 @@
+import 'dart:convert';
+
+import 'package:bang_navigator/core/http_error_handler.dart';
+import 'package:bang_navigator/features/bangs/data/models/bang.dart';
+import 'package:exceptions/exceptions.dart';
+import 'package:flutter/foundation.dart';
+import 'package:http/http.dart' as http;
+import 'package:riverpod_annotation/riverpod_annotation.dart';
+
+part 'bang_source.g.dart';
+
+@Riverpod()
+class BangSource extends _$BangSource {
+  late http.Client _client;
+
+  @override
+  void build() {
+    _client = http.Client();
+  }
+
+  Future<Result<List<Bang>>> getBangs(Uri url, BangGroup? group) async {
+    return Result.fromAsync(
+      () async {
+        final response = await _client.get(url);
+        return await compute(
+          (args) => jsonDecode(utf8.decode(args[0])) as List,
+          [response.bodyBytes],
+        ).then(
+          (json) => json.map((e) {
+            var bang = Bang.fromJson(e as Map<String, dynamic>);
+
+            if (group != null) {
+              bang = bang.copyWith.group(group);
+            }
+
+            return bang;
+          }).toList(),
+        );
+      },
+      exceptionHandler: handleHttpError,
+    );
+  }
+}

app/lib/features/bangs/data/services/bang_source.g.dart

@@ -0,0 +1,25 @@
+// GENERATED CODE - DO NOT MODIFY BY HAND
+
+part of 'bang_source.dart';
+
+// **************************************************************************
+// RiverpodGenerator
+// **************************************************************************
+
+String _$bangSourceHash() => r'6ca70e8be16a0ae104fa6b739e3c0f2c59eab565';
+
+/// See also [BangSource].
+@ProviderFor(BangSource)
+final bangSourceProvider =
+    AutoDisposeNotifierProvider<BangSource, void>.internal(
+  BangSource.new,
+  name: r'bangSourceProvider',
+  debugGetCreateSourceHash:
+      const bool.fromEnvironment('dart.vm.product') ? null : _$bangSourceHash,
+  dependencies: null,
+  allTransitiveDependencies: null,
+);
+
+typedef _$BangSource = AutoDisposeNotifier<void>;
+// ignore_for_file: type=lint
+// ignore_for_file: subtype_of_sealed_class, invalid_use_of_internal_member, invalid_use_of_visible_for_testing_member