chore(release): bump version to 7.20.1

Author: agordn52

CHANGELOG.md

@@ -1,3 +1,17 @@
+## [7.20.1] - 2026-04-26
+
+### Fixed
+
+* **`NyScheduler.getKeyTaskOnce(name)` now returns the full prefixed storage key** (`ny_scheduler_${name}_once`) instead of the unprefixed `${name}_once`. This makes the documented reset pattern `await NyStorage.delete(NyScheduler.getKeyTaskOnce("welcome_to_app"))` actually delete the stored flag
+
+### Added
+
+* **`NyScheduler.clearTaskOnce(name)`** convenience method that clears a once-task's executed state without needing to compute the storage key manually
+
+### Changed
+
+* Bumped `app_badge_plus` dependency from `^1.2.8` to `^1.2.9`
+
 ## [7.20.0] - 2026-04-20
 
 ### Added

example/pubspec.lock

@@ -5,10 +5,10 @@ packages:
     dependency: transitive
     description:
       name: app_badge_plus
-      sha256: "81130fe6150ce2a1f12af4bb7d6f646496d284d5f87f2c121af8258a453bbb3f"
+      sha256: dab607342bbf73b33a532e384117ccb13efbaabadb6058c40fd74d743b0ef1ab
       url: "https://pub.dev"
     source: hosted
-    version: "1.2.8"
+    version: "1.2.9"
   args:
     dependency: transitive
     description:
@@ -345,10 +345,10 @@ packages:
     dependency: transitive
     description:
       name: hooks
-      sha256: e79ed1e8e1929bc6ecb6ec85f0cb519c887aa5b423705ded0d0f2d9226def388
+      sha256: "025f060e86d2d4c3c47b56e33caf7f93bf9283340f26d23424ebcfccf34f621e"
       url: "https://pub.dev"
     source: hosted
-    version: "1.0.2"
+    version: "1.0.3"
   http:
     dependency: transitive
     description:
@@ -604,6 +604,14 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "4.1.0"
+  record_use:
+    dependency: transitive
+    description:
+      name: record_use
+      sha256: "2551bd8eecfe95d14ae75f6021ad0248be5c27f138c2ec12fcb52b500b3ba1ed"
+      url: "https://pub.dev"
+    source: hosted
+    version: "0.6.0"
   rxdart:
     dependency: transitive
     description:
@@ -837,10 +845,10 @@ packages:
     dependency: transitive
     description:
       name: vm_service
-      sha256: "45caa6c5917fa127b5dbcfbd1fa60b14e583afdc08bfc96dda38886ca252eb60"
+      sha256: "046d3928e16fa4dc46e8350415661755ab759d9fc97fc21b5ab295f71e4f0499"
       url: "https://pub.dev"
     source: hosted
-    version: "15.0.2"
+    version: "15.1.0"
   web:
     dependency: transitive
     description:

lib/helpers/src/ny_scheduler.dart

@@ -67,9 +67,17 @@ class NyScheduler {
     return await readBool(key);
   }
 
-  /// Get the key for a task that runs once
+  /// Get the full storage key for a task that runs once.
+  /// Use this with [NyStorage.delete] to reset the task.
   static String getKeyTaskOnce(String name) {
-    return "${name}_once";
+    return key("${name}_once");
+  }
+
+  /// Clear the executed state for a task scheduled with [taskOnce].
+  /// After calling this, the next [taskOnce] invocation with the same
+  /// [name] will execute the callback again.
+  static Future<void> clearTaskOnce(String name) async {
+    await _secureStorage.delete(key: key("${name}_once"));
   }
 
   /// Run a task daily

pubspec.lock

@@ -5,10 +5,10 @@ packages:
     dependency: "direct main"
     description:
       name: app_badge_plus
-      sha256: "81130fe6150ce2a1f12af4bb7d6f646496d284d5f87f2c121af8258a453bbb3f"
+      sha256: dab607342bbf73b33a532e384117ccb13efbaabadb6058c40fd74d743b0ef1ab
       url: "https://pub.dev"
     source: hosted
-    version: "1.2.8"
+    version: "1.2.9"
   args:
     dependency: transitive
     description:
@@ -371,10 +371,10 @@ packages:
     dependency: transitive
     description:
       name: hooks
-      sha256: e79ed1e8e1929bc6ecb6ec85f0cb519c887aa5b423705ded0d0f2d9226def388
+      sha256: "025f060e86d2d4c3c47b56e33caf7f93bf9283340f26d23424ebcfccf34f621e"
       url: "https://pub.dev"
     source: hosted
-    version: "1.0.2"
+    version: "1.0.3"
   http:
     dependency: transitive
     description:
@@ -676,6 +676,14 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "4.1.0"
+  record_use:
+    dependency: transitive
+    description:
+      name: record_use
+      sha256: "2551bd8eecfe95d14ae75f6021ad0248be5c27f138c2ec12fcb52b500b3ba1ed"
+      url: "https://pub.dev"
+    source: hosted
+    version: "0.6.0"
   rxdart:
     dependency: "direct main"
     description:
@@ -925,10 +933,10 @@ packages:
     dependency: transitive
     description:
       name: vm_service
-      sha256: "45caa6c5917fa127b5dbcfbd1fa60b14e583afdc08bfc96dda38886ca252eb60"
+      sha256: "046d3928e16fa4dc46e8350415661755ab759d9fc97fc21b5ab295f71e4f0499"
       url: "https://pub.dev"
     source: hosted
-    version: "15.0.2"
+    version: "15.1.0"
   web:
     dependency: transitive
     description:

pubspec.yaml

@@ -1,6 +1,6 @@
 name: nylo_support
 description: Support library for the Nylo framework. This library supports routing, widgets, localization, cli, storage and more.
-version: 7.20.0
+version: 7.20.1
 homepage: https://nylo.dev
 repository: https://github.com/nylo-core/support/tree/7.x
 issue_tracker: https://github.com/nylo-core/support/issues
@@ -36,7 +36,7 @@ dependencies:
   path_provider: ^2.1.5
   timezone: ^0.11.0
   flutter_timezone: ^5.0.2
-  app_badge_plus: ^1.2.8
+  app_badge_plus: ^1.2.9
   mask_text_input_formatter: ^2.9.0
   uuid: ^4.5.3
   characters: ^1.4.1

test/helpers/ny_scheduler_test.dart

@@ -1,10 +1,22 @@
+import 'package:flutter_secure_storage/flutter_secure_storage.dart';
 import 'package:flutter_test/flutter_test.dart';
 import 'package:nylo_support/helpers/ny_helpers.dart';
+import 'package:nylo_support/local_storage/ny_local_storage.dart';
+import 'package:nylo_support/nylo.dart';
 import 'package:nylo_support/testing/ny_testing.dart';
 
 void main() {
   NyTest.init();
 
+  setUp(() {
+    Nylo.isTestMode = true;
+  });
+
+  tearDown(() async {
+    await NyStorage.deleteAll();
+    Nylo.isTestMode = true;
+  });
+
   nyGroup('NyScheduler', () {
     nyGroup('prefix', () {
       nyTest('should be ny_scheduler_', () async {
@@ -27,13 +39,80 @@ void main() {
     });
 
     nyGroup('getKeyTaskOnce', () {
-      nyTest('should append _once to name', () async {
-        expect(NyScheduler.getKeyTaskOnce('myTask'), 'myTask_once');
+      nyTest('should return the full prefixed storage key', () async {
+        expect(
+          NyScheduler.getKeyTaskOnce('myTask'),
+          'ny_scheduler_myTask_once',
+        );
       });
 
       nyTest('should handle empty name', () async {
-        expect(NyScheduler.getKeyTaskOnce(''), '_once');
+        expect(NyScheduler.getKeyTaskOnce(''), 'ny_scheduler__once');
+      });
+
+      nyTest(
+        'returned key matches the key actually written by taskOnce',
+        () async {
+          int calls = 0;
+          await NyScheduler.taskOnce('match_test', () async => calls++);
+          expect(calls, 1);
+
+          final raw = await FlutterSecureStorage().read(
+            key: NyScheduler.getKeyTaskOnce('match_test'),
+          );
+          expect(raw, 'true');
+        },
+      );
+    });
+
+    nyGroup('hasExecutedTaskOnce', () {
+      nyTest('returns false before the task runs', () async {
+        expect(await NyScheduler.hasExecutedTaskOnce('not_yet'), false);
       });
+
+      nyTest('returns true after taskOnce completes', () async {
+        await NyScheduler.taskOnce('has_run', () async {});
+        expect(await NyScheduler.hasExecutedTaskOnce('has_run'), true);
+      });
+    });
+
+    nyGroup('clearTaskOnce', () {
+      nyTest('allows a once-task to run again after clearing', () async {
+        int calls = 0;
+        Future<void> work() async => calls++;
+
+        await NyScheduler.taskOnce('rerun_me', work);
+        await NyScheduler.taskOnce('rerun_me', work);
+        expect(calls, 1);
+
+        await NyScheduler.clearTaskOnce('rerun_me');
+        expect(await NyScheduler.hasExecutedTaskOnce('rerun_me'), false);
+
+        await NyScheduler.taskOnce('rerun_me', work);
+        expect(calls, 2);
+      });
+
+      nyTest('is a no-op when the task was never executed', () async {
+        await NyScheduler.clearTaskOnce('never_existed');
+        expect(await NyScheduler.hasExecutedTaskOnce('never_existed'), false);
+      });
+    });
+
+    nyGroup('developer-facing reset via NyStorage.delete', () {
+      nyTest(
+        'NyStorage.delete(getKeyTaskOnce(name)) resets the task',
+        () async {
+          int calls = 0;
+          await NyScheduler.taskOnce('via_storage', () async => calls++);
+          expect(calls, 1);
+
+          await NyStorage.delete(NyScheduler.getKeyTaskOnce('via_storage'));
+          expect(await NyScheduler.hasExecutedTaskOnce('via_storage'), false);
+
+          await NyScheduler.taskOnce('via_storage', () async => calls++);
+          expect(calls, 2);
+        },
+      );
     });
   });
 }