Use the cognitive_data package to manage the data

example/lib/main.dart

@@ -23,6 +23,9 @@ class MyApp extends StatelessWidget {
 class MyHomePage extends StatefulWidget {
   const MyHomePage({super.key});
 
+  final String participantID = '101';
+  final String sessionID = '001';
+
   @override
   State<MyHomePage> createState() => _MyHomePageState();
 }
@@ -36,15 +39,21 @@ class _MyHomePageState extends State<MyHomePage> {
           mainAxisAlignment: MainAxisAlignment.center,
           children: <Widget>[
             ElevatedButton(
-              onPressed: runDigitSpanForward,
+              onPressed: () => runDigitSpanForward(
+                participantID: widget.participantID,
+                sessionID: widget.sessionID,
+              ),
               child: Text(
                 'Digit Span Forward',
                 style: Theme.of(context).textTheme.titleLarge,
               ),
             ),
             const SizedBox(height: 10),
             ElevatedButton(
-              onPressed: runDigitSpanBackwards,
+              onPressed: () => runDigitSpanBackwards(
+                participantID: widget.participantID,
+                sessionID: widget.sessionID,
+              ),
               child: Text(
                 'Digit Span Backwards',
                 style: Theme.of(context).textTheme.titleLarge,
@@ -57,24 +66,34 @@ class _MyHomePageState extends State<MyHomePage> {
     );
   }
 
-  void runDigitSpanForward() async {
+  void runDigitSpanForward({
+    required String participantID,
+    required String sessionID,
+  }) async {
     UserConfig config = UserConfig(
       stimListPractice: ['01', '234'],
       stimListExperimental: ['5678', '01567', '987654'],
+      participantID: participantID,
+      sessionID: sessionID,
     );
-    DigitSpanTasksData data = await Get.to(() => DigitSpanForward(
+    DigitSpanTaskData data = await Get.to(() => DigitSpanForward(
           config: config,
         ));
     // ignore: avoid_print
     print('\n\n\nFORWARD data \n $data');
   }
 
-  void runDigitSpanBackwards() async {
+  void runDigitSpanBackwards({
+    required String participantID,
+    required String sessionID,
+  }) async {
     UserConfig config = UserConfig(
       stimListPractice: ['23', '567'],
       stimListExperimental: ['0123', '45678', '901234'],
+      participantID: participantID,
+      sessionID: sessionID,
     );
-    DigitSpanTasksData data = await Get.to(() => DigitSpanBackwards(
+    DigitSpanTaskData data = await Get.to(() => DigitSpanBackwards(
           config: config,
         ));
     // ignore: avoid_print

example/linux/flutter/generated_plugin_registrant.cc

@@ -6,6 +6,10 @@
 
 #include "generated_plugin_registrant.h"
 
+#include <sqlite3_flutter_libs/sqlite3_flutter_libs_plugin.h>
 
 void fl_register_plugins(FlPluginRegistry* registry) {
+  g_autoptr(FlPluginRegistrar) sqlite3_flutter_libs_registrar =
+      fl_plugin_registry_get_registrar_for_plugin(registry, "Sqlite3FlutterLibsPlugin");
+  sqlite3_flutter_libs_plugin_register_with_registrar(sqlite3_flutter_libs_registrar);
 }

example/linux/flutter/generated_plugins.cmake

@@ -3,6 +3,7 @@
 #
 
 list(APPEND FLUTTER_PLUGIN_LIST
+  sqlite3_flutter_libs
 )
 
 list(APPEND FLUTTER_FFI_PLUGIN_LIST

example/macos/Flutter/GeneratedPluginRegistrant.swift

@@ -5,8 +5,12 @@
 import FlutterMacOS
 import Foundation
 
+import path_provider_foundation
 import shared_preferences_foundation
+import sqlite3_flutter_libs
 
 func RegisterGeneratedPlugins(registry: FlutterPluginRegistry) {
+  PathProviderPlugin.register(with: registry.registrar(forPlugin: "PathProviderPlugin"))
   SharedPreferencesPlugin.register(with: registry.registrar(forPlugin: "SharedPreferencesPlugin"))
+  Sqlite3FlutterLibsPlugin.register(with: registry.registrar(forPlugin: "Sqlite3FlutterLibsPlugin"))
 }

example/pubspec.lock

@@ -29,13 +29,29 @@ packages:
       url: "https://pub.dartlang.org"
     source: hosted
     version: "1.1.1"
+  cognitive_data:
+    dependency: transitive
+    description:
+      path: "."
+      ref: HEAD
+      resolved-ref: "1ccab9a918c15db74a7b8b35aa7bc5d0079a31ae"
+      url: "https://github.com/mario-bermonti/cognitive_data.git"
+    source: git
+    version: "0.0.1"
   collection:
     dependency: transitive
     description:
       name: collection
       url: "https://pub.dartlang.org"
     source: hosted
     version: "1.16.0"
+  convert:
+    dependency: transitive
+    description:
+      name: convert
+      url: "https://pub.dartlang.org"
+    source: hosted
+    version: "3.1.0"
   cupertino_icons:
     dependency: "direct main"
     description:
@@ -50,6 +66,13 @@ packages:
       relative: true
     source: path
     version: "0.0.1"
+  drift:
+    dependency: transitive
+    description:
+      name: drift
+      url: "https://pub.dartlang.org"
+    source: hosted
+    version: "1.7.1"
   fake_async:
     dependency: transitive
     description:
@@ -156,6 +179,27 @@ packages:
       url: "https://pub.dartlang.org"
     source: hosted
     version: "1.8.2"
+  path_provider:
+    dependency: transitive
+    description:
+      name: path_provider
+      url: "https://pub.dartlang.org"
+    source: hosted
+    version: "2.0.15"
+  path_provider_android:
+    dependency: transitive
+    description:
+      name: path_provider_android
+      url: "https://pub.dartlang.org"
+    source: hosted
+    version: "2.0.27"
+  path_provider_foundation:
+    dependency: transitive
+    description:
+      name: path_provider_foundation
+      url: "https://pub.dartlang.org"
+    source: hosted
+    version: "2.2.1"
   path_provider_linux:
     dependency: transitive
     description:
@@ -294,6 +338,20 @@ packages:
       url: "https://pub.dartlang.org"
     source: hosted
     version: "1.9.0"
+  sqlite3:
+    dependency: transitive
+    description:
+      name: sqlite3
+      url: "https://pub.dartlang.org"
+    source: hosted
+    version: "1.8.0"
+  sqlite3_flutter_libs:
+    dependency: transitive
+    description:
+      name: sqlite3_flutter_libs
+      url: "https://pub.dartlang.org"
+    source: hosted
+    version: "0.5.20"
   stack_trace:
     dependency: transitive
     description:
@@ -338,6 +396,13 @@ packages:
       url: "https://pub.dartlang.org"
     source: hosted
     version: "0.4.9"
+  typed_data:
+    dependency: transitive
+    description:
+      name: typed_data
+      url: "https://pub.dartlang.org"
+    source: hosted
+    version: "1.3.2"
   vector_math:
     dependency: transitive
     description:

example/windows/flutter/generated_plugin_registrant.cc

@@ -7,8 +7,11 @@
 #include "generated_plugin_registrant.h"
 
 #include <permission_handler_windows/permission_handler_windows_plugin.h>
+#include <sqlite3_flutter_libs/sqlite3_flutter_libs_plugin.h>
 
 void RegisterPlugins(flutter::PluginRegistry* registry) {
   PermissionHandlerWindowsPluginRegisterWithRegistrar(
       registry->GetRegistrarForPlugin("PermissionHandlerWindowsPlugin"));
+  Sqlite3FlutterLibsPluginRegisterWithRegistrar(
+      registry->GetRegistrarForPlugin("Sqlite3FlutterLibsPlugin"));
 }

example/windows/flutter/generated_plugins.cmake

@@ -4,6 +4,7 @@
 
 list(APPEND FLUTTER_PLUGIN_LIST
   permission_handler_windows
+  sqlite3_flutter_libs
 )
 
 list(APPEND FLUTTER_FFI_PLUGIN_LIST

lib/digit_span_tasks.dart

@@ -2,5 +2,5 @@ library digit_span_tasks;
 
 export 'src/digit_span_forward.dart';
 export 'src/digit_span_backwards.dart';
-export 'src/digit_span_task/components/data/digit_span_tasks_data.dart';
+export 'src/digit_span_task/components/data/digit_span_task_data.dart';
 export 'src/digit_span_task/components/config/user_config.dart';

lib/src/digit_span_task/components/activity/activity_controller.dart

@@ -1,3 +1,4 @@
+import 'package:digit_span_tasks/src/digit_span_task/components/config/session_type.dart';
 import 'package:get/get.dart';
 import 'package:digit_span_tasks/src/digit_span_task/components/data/data_manager.dart';
 import 'package:digit_span_tasks/src/digit_span_task/components/activity/task_step.dart';
@@ -47,14 +48,14 @@ class ActivityController extends GetxController {
   }
 
   Future<void> endSession() async {
-    _data.addEndTime(_config.isPractice);
+    _data.endTime = DateTime.now();
     await reset();
     Get.back();
   }
 
   /// Resets the important settings so another session can be run.
   Future<void> reset() async {
     taskStep(TaskStep.instructions);
-    _config.isPractice = true;
+    _config.sessionType = SessionType.practice;
   }
 }

lib/src/digit_span_task/components/activity/activity_view.dart

@@ -20,7 +20,7 @@ class ActivityView extends StatelessWidget {
 
   @override
   Widget build(BuildContext context) {
-    data.addStartTime(_config.isPractice);
+    data.startTime = DateTime.now();
     return Obx(() {
       switch (mDigits.taskStep.value) {
         case TaskStep.instructions:

lib/src/digit_span_task/components/config/ds_config.dart

@@ -1,3 +1,4 @@
+import 'package:digit_span_tasks/src/digit_span_task/components/config/session_type.dart';
 import 'package:get/get.dart';
 import 'package:digit_span_tasks/src/digit_span_task/components/config/user_config.dart';
 
@@ -6,9 +7,9 @@ import 'package:digit_span_tasks/src/digit_span_task/components/config/user_conf
 class DSConfig extends GetxController {
   final UserConfig userConfig;
 
-  /// The [isPractice] flag controls whether the practice or experimental should
-  /// be presented and how to store the data.
-  bool isPractice = true;
+  /// Controls whether the practice or experimental should be presented and
+  /// how to manage the data.
+  SessionType sessionType = SessionType.practice;
 
   DSConfig({required this.userConfig});
 }

lib/src/digit_span_task/components/config/session_trial_type_map.dart

@@ -0,0 +1,26 @@
+import 'package:cognitive_data/models/trial_type.dart';
+import 'package:digit_span_tasks/src/digit_span_task/components/config/session_type.dart';
+import 'package:digit_span_tasks/src/digit_span_task/components/exceptions/sessiontype_conversion_exception.dart';
+
+/// Maps from a [SessionType] to the corresponding [TrialType].
+/// This mapping is essential because creating a [Trial] object requires a
+/// [TrialType], and this conversion provides a straightforward way to obtain
+/// the required [TrialType] based on the given [SessionType].
+const Map<SessionType, TrialType> sessionToTrialTypeMap = {
+  SessionType.practice: TrialType.practice,
+  SessionType.experimental: TrialType.experimental,
+};
+
+/// Converts a [SessionType] to the corresponding [TrialType].
+///
+/// Given a [SessionType], this function looks up the corresponding
+/// [TrialType] using the [sessionToTrialTypeMap]. If a match is found,
+/// it returns the associated [TrialType]. If no match is found, a
+/// [DSTSessionTypeConversionException] is thrown.
+TrialType convertSessionToTrialType(SessionType sessionType) {
+  final TrialType? trialType = sessionToTrialTypeMap[sessionType];
+  if (trialType == null) {
+    throw DSTSessionTypeConversionException();
+  }
+  return trialType;
+}

lib/src/digit_span_task/components/config/session_type.dart

@@ -0,0 +1,2 @@
+/// Identifies whether it is a practice or experimental session
+enum SessionType { practice, experimental }

lib/src/digit_span_task/components/config/user_config.dart

@@ -14,9 +14,24 @@ class UserConfig extends GetxController {
   /// are randomized (e.g., "123" may be turned into "213").
   late final List<String> stimListExperimental;
 
+  /// ID that uniquely identifies this participant's session.
+  /// It will be used to pair the different data collected by [digit_span_tasks]
+  /// for the participant's particular session. So it is essential that
+  /// the [sessionID] is an unique identifier across all the sessions for this
+  /// participant.
+  final String sessionID;
+
+  /// ID that uniquely identifies this participant.
+  /// It will be used to pair the different data collected by [digit_span_tasks]
+  /// for the participant. So it is essential that the [participantID] is an
+  /// unique identifier across all participant.
+  final String participantID;
+
   UserConfig({
     required stimListPractice,
     required stimListExperimental,
+    required this.sessionID,
+    required this.participantID,
   }) {
     this.stimListPractice = randomizeDigitsInSets(stimListPractice);
     this.stimListExperimental = randomizeDigitsInSets(stimListExperimental);