Merge branch 'main' into neelkanth-kaushik/LIBRARIES-2724

Author: MichaelGHSeg

.gitignore

@@ -16,14 +16,10 @@ migrate_working_dir/
 *.iws
 .idea/
 
-# The .vscode folder contains launch configuration and tasks you configure in
-# VS Code which you may wish to be included in version control, so this line
-# is commented out by default.
-#.vscode/
-
 # Flutter/Dart/Pub related
 # Libraries should not include pubspec.lock, per https://dart.dev/guides/libraries/private-files#pubspeclock.
 pubspec.lock
+_pubspec.lock
 **/doc/api/
 .dart_tool/
 .packages
@@ -36,6 +32,7 @@ build/
 
 # VSCode
 launch.json
+**/.vscode/
 
 #Coverage
 coverage/

README.md

@@ -15,6 +15,8 @@ The main [segment_analytics](http://pub.dev/packages/segment_analytics) package.
 
 [Docs](packages/core#readme)
 
+[Changelog](packages/core/CHANGELOG.md)
+
 ## Plugins
 
 ### Adjust (`segment_analytics_plugin_adjust`)
@@ -62,26 +64,6 @@ Some destination plugins might not support all platform functionality. Refer to
 
 See the [example app](./example/README.md) to check a full test app of how to integrate Analytics-Flutter into your own Flutter app.
 
-## Release Notes
-
-### Version 1.1.7
-
-1. **Release Date** - 21<sup>st</sup> May 2025.
-
-2. **Fixes Github Issue [#144](https://github.com/segmentio/analytics_flutter/issues/144)** - Up to version 1.1.6, the `setFlushPolicies` method inadvertently overwrote the `Configuration.collectDeviceId`property. This issue has been resolved in version 1.1.7.
-
-3. **Fixes Github Issue [#147](https://github.com/segmentio/analytics_flutter/issues/147)** - The `compileSdkVersion` in the `build.gradle` file has been updated from 31 to 35. Previously, this caused the following error:  
-`Android build error "Only safe (?.) or non-null asserted (!!.) calls are allowed on a nullable receiver of type 'android.content.pm.ApplicationInfo?"` . This update resolves the issue with `compileSdkVersion 35`.
-
-4. **Fixes Github Issue [#138](https://github.com/segmentio/analytics_flutter/issues/138)** - Prior to version 1.1.7, the version field returned the browser's version string instead of the app version from `pubspec.yaml`. Since `pubspec.yaml` is a build-time configuration file and not accessible at runtime (especially in browser environments), this was expected behavior.  
-As of version 1.1.7, if the following tag is added to `<project-root>/web/index.html`: `<meta name="app-version" content="1.2.3">`
-the app will return the value in the `content` attribute. 
-**Note:** This value should be manually synchronized with the version in `pubspec.yaml`.
-
-5. **Fixes Github Issue [#152](https://github.com/segmentio/analytics_flutter/issues/152) and [#98](https://github.com/segmentio/analytics_flutter/issues/98)** - Until version 1.1.6, the `integrations: {}` field was missing in the data payload sent to the Segment server. This has been addressed in version 1.1.7.
-
-6. **Fixes Github Issue [#157](https://github.com/segmentio/analytics_flutter/issues/157)** - Resolves the `Concurrent modification during iteration: Instance(length: 6) of '_GrowableList'` error that occurred when multiple plugins were added simultaneously.
-
 ## Contributing
 
 See the [contributing guide](CONTRIBUTING.md) to learn how to contribute to the repository and the development workflow.

packages/core/CHANGELOG.md

@@ -1,15 +1,23 @@
+## 1.1.9
+
+- Fix for storageJson configuration properly enabling/disabling writing of files on all platforms #171
+
 ## 1.1.8
 
-- Reverting fix for #152
+- Reverting fix for #152 - The `integrations` field is vestigial and remains available for SDK users to populate to suppress extra events from server side destinations.
 
 ## 1.1.7
 
-- Fix for setFlushPolicies method is overwriting Configuration properties #144
-- Fix for Android build error on nullable receiver in sdk 35 #147
-- Fix for Context app version wrong on Flutter web #138
-- Fix for Integrations field is empty in segment analytics #152
+- Fix for setFlushPolicies method is overwriting Configuration properties #144 - Up to version 1.1.6, the `setFlushPolicies` method inadvertently overwrote the `Configuration.collectDeviceId`property.
+- Fix for Android build error on nullable receiver in sdk 35 #147  - The `compileSdkVersion` in the `build.gradle` file has been updated from 31 to 35. Previously, this caused the following error:  
+`Android build error "Only safe (?.) or non-null asserted (!!.) calls are allowed on a nullable receiver of type 'android.content.pm.ApplicationInfo?"`.
+- Fix for Context app version wrong on Flutter web #138 - Prior to version 1.1.7, the version field returned the browser's version string instead of the app version from `pubspec.yaml`. Since `pubspec.yaml` is a build-time configuration file and not accessible at runtime (especially in browser environments), this was expected behavior.  
+As of version 1.1.7, if the following tag is added to `<project-root>/web/index.html`: `<meta name="app-version" content="1.2.3">`
+the app will return the value in the `content` attribute. 
+**Note:** This value should be manually synchronized with the version in `pubspec.yaml`.
+- Fix for Integrations field is empty in segment analytics #152 - Until version 1.1.6, the `integrations: {}` field was missing in the data payload sent to the Segment server.
 - Fix for AppsFlyer Destination not initializing properly #98
-- fix for Crash in Timeline.applyPlugins #157
+- fix for Crash in Timeline.applyPlugins #157 - Resolves the `Concurrent modification during iteration: Instance(length: 6) of '_GrowableList'` error that occurred when multiple plugins were added simultaneously.
 
 ## 1.1.6
 

packages/core/README.md

@@ -578,25 +578,7 @@ See the [example app](../../example/README.md) to check a full test app of how t
 
 ## Release Notes
 
-### Version 1.1.8 (10 Jul 2025)
-
-Reverting fix for #152
-
-### Version 1.1.7 (21 May 2025)
-
-1. **Fixes Github Issue [#144](https://github.com/segmentio/analytics_flutter/issues/144)** - Up to version 1.1.6, the `setFlushPolicies` method inadvertently overwrote the `Configuration.collectDeviceId`property. This issue has been resolved in version 1.1.7.
-
-2. **Fixes Github Issue [#147](https://github.com/segmentio/analytics_flutter/issues/147)** - The `compileSdkVersion` in the `build.gradle` file has been updated from 31 to 35. Previously, this caused the following error:  
-`Android build error "Only safe (?.) or non-null asserted (!!.) calls are allowed on a nullable receiver of type 'android.content.pm.ApplicationInfo?"` . This update resolves the issue with `compileSdkVersion 35`.
-
-3. **Fixes Github Issue [#138](https://github.com/segmentio/analytics_flutter/issues/138)** - Prior to version 1.1.7, the version field returned the browser's version string instead of the app version from `pubspec.yaml`. Since `pubspec.yaml` is a build-time configuration file and not accessible at runtime (especially in browser environments), this was expected behavior.  
-As of version 1.1.7, if the following tag is added to `<project-root>/web/index.html`: `<meta name="app-version" content="1.2.3">`
-the app will return the value in the `content` attribute. 
-**Note:** This value should be manually synchronized with the version in `pubspec.yaml`.
-
-4. **Fixes Github Issue [#152](https://github.com/segmentio/analytics_flutter/issues/152) and [#98](https://github.com/segmentio/analytics_flutter/issues/98)** - Until version 1.1.6, the `integrations: {}` field was missing in the data payload sent to the Segment server. This has been addressed in version 1.1.7.
-
-5. **Fixes Github Issue [#157](https://github.com/segmentio/analytics_flutter/issues/157)** - Resolves the `Concurrent modification during iteration: Instance(length: 6) of '_GrowableList'` error that occurred when multiple plugins were added simultaneously.
+See our [Changelog](./CHANGELOG.md) for release notes.
 
 ## Contributing
 

packages/core/lib/client.dart

@@ -19,7 +19,10 @@ Analytics createClient(Configuration configuration) {
     configuration = setFlushPolicies(configuration, defaultFlushPolicies);
   }
 
-  final analytics = Analytics(configuration, storeFactory());
+  final analytics = Analytics(
+    configuration,
+    storeFactory(storageJson: configuration.storageJson ?? true),
+  );
 
   if (configuration.debug) {
     analytics.addPlugin(EventLogger());

packages/core/lib/utils/store/io.dart

@@ -9,8 +9,11 @@ import 'package:segment_analytics/utils/store/store.dart';
 import 'package:path_provider/path_provider.dart';
 
 class StoreImpl with Store {
+  final bool storageJson;
+  StoreImpl({this.storageJson = true});
   @override
   Future<Map<String, dynamic>?> getPersisted(String key) {
+    if (!storageJson) return Future.value(null);
     return _readFile(key);
   }
 
@@ -19,8 +22,18 @@ class StoreImpl with Store {
 
   @override
   Future setPersisted(String key, Map<String, dynamic> value) {
+    if (!storageJson) return Future.value();
     return _writeFile(key, value);
   }
+  
+  @override
+  Future deletePersisted(String key) async {
+    if (!storageJson) return;
+    final file = File(await _fileName(key));
+    if (await file.exists()) {
+      await file.delete();
+    }
+  }
 
   Future _writeFile(String fileKey, Map<String, dynamic> data) async {
     RandomAccessFile file =

packages/core/lib/utils/store/store.dart

@@ -4,12 +4,14 @@ mixin Store {
   Future<Map<String, dynamic>?> getPersisted(String key);
 
   Future setPersisted(String key, Map<String, dynamic> value);
+  
+  Future deletePersisted(String key);
 
   Future get ready;
 
   void dispose();
 }
 
-StoreImpl storeFactory() {
-  return StoreImpl();
+StoreImpl storeFactory({bool storageJson = true}) {
+  return StoreImpl(storageJson: storageJson);
 }

packages/core/lib/utils/store/unsupported.dart

@@ -4,6 +4,8 @@ import 'package:segment_analytics/errors.dart';
 import 'store.dart';
 
 class StoreImpl with Store {
+  final bool storageJson;
+  StoreImpl({this.storageJson = true});
   @override
   Future<Map<String, dynamic>?> getPersisted(String key) {
     throw PlatformNotSupportedError();
@@ -16,9 +18,14 @@ class StoreImpl with Store {
   Future setPersisted(String key, Map<String, dynamic> value) {
     throw PlatformNotSupportedError();
   }
+  
+  @override
+  Future deletePersisted(String key) {
+    throw PlatformNotSupportedError();
+  }
 
   @override
   void dispose() {
     throw PlatformNotSupportedError();
   }
-}
+}

packages/core/lib/utils/store/web.dart

@@ -5,10 +5,13 @@ import 'package:segment_analytics/utils/store/store.dart';
 import 'package:web/web.dart' as web;
 
 class StoreImpl implements Store {
+  final bool storageJson;
+  StoreImpl({this.storageJson = true});
   web.Storage get localStorage => web.window.localStorage;
 
   @override
   Future<Map<String, dynamic>?> getPersisted(String key) {
+    if (!storageJson) return Future.value(null);
     return _readFromStorage(key);
   }
 
@@ -17,9 +20,17 @@ class StoreImpl implements Store {
 
   @override
   Future setPersisted(String key, Map<String, dynamic> value) {
+    if (!storageJson) return Future.value();
     _writeToStorage(key, value);
     return Future.value();
   }
+  
+  @override
+  Future deletePersisted(String key) {
+    if (!storageJson) return Future.value();
+    localStorage.removeItem(_getFileName(key));
+    return Future.value();
+  }
 
   String _getFileName(String fileKey) {
     return "analytics-flutter-$fileKey.json";

packages/core/lib/version.dart

@@ -1 +1 @@
-const segmentVersion = "1.1.8";
+const segmentVersion = "1.1.9";