DX | 17-02-2025

.github/workflows/check-branch.yml

@@ -8,13 +8,13 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Comment PR
-        if: github.base_ref == 'master' && github.head_ref != 'next'
+        if: github.base_ref == 'master' && github.head_ref != 'staging'
         uses: thollander/actions-comment-pull-request@v2
         with:
           message: |
             We regret to inform you that you are currently not able to merge your changes into the master branch due to restrictions applied by our SRE team. To proceed with merging your changes, we kindly request that you create a pull request from the next branch. Our team will then review the changes and work with you to ensure a successful merge into the master branch.
       - name: Check branch
-        if: github.base_ref == 'master' && github.head_ref != 'next'
+        if: github.base_ref == 'master' && github.head_ref != 'staging'
         run: |
           echo "ERROR: We regret to inform you that you are currently not able to merge your changes into the master branch due to restrictions applied by our SRE team. To proceed with merging your changes, we kindly request that you create a pull request from the next branch. Our team will then review the changes and work with you to ensure a successful merge into the master branch."
           exit 1

CHANGELOG.md

@@ -1,5 +1,10 @@
 # CHANGELOG
 
+### **FEB-17-2025**
+
+#### v1.0.0 - v3 migration null support added
+#### Removed super_enum lib
+
 ## v0.5.1 - Added support for gcp_na region
 #### Added support for gcp_na region
 

LICENSE

@@ -1,6 +1,6 @@
 # MIT License
 
-Copyright (c) 2012 - 2024 Contentstack. All rights reserved.
+Copyright (c) 2012 - 2025 Contentstack. All rights reserved.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -168,7 +168,7 @@ final response = imageTransformation..canvas(imageParams)..getUrl();
 
 MIT License
 
-Copyright (c) 2012 - 2021
+Copyright (c) 2012 - 2025
 [Contentstack](https://www.contentstack.com/). All rights reserved.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy

SECURITY.md

@@ -0,0 +1,27 @@
+# Security
+
+Contentstack takes the security of our software products and services seriously, which includes all source code repositories managed through our GitHub organizations.
+
+If you believe you have found a security vulnerability in any Contentstack-owned repository, please report it to us as described below.
+
+## Reporting Security Issues
+
+**Please do not report security vulnerabilities through public GitHub issues.**
+
+Send email to [[email protected]](mailto:[email protected]).
+
+You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message.
+
+Please include the requested information listed below (as much as you can provide) to help us better understand the nature and scope of the possible issue:
+
+- Type of issue (e.g. buffer overflow, SQL injection, cross-site scripting, etc.)
+- Full paths of source file(s) related to the manifestation of the issue
+- The location of the affected source code (tag/branch/commit or direct URL)
+- Any special configuration required to reproduce the issue
+- Step-by-step instructions to reproduce the issue
+- Proof-of-concept or exploit code (if possible)
+- Impact of the issue, including how an attacker might exploit the issue
+
+This information will help us triage your report more quickly.
+
+[https://www.contentstack.com/trust/](https://www.contentstack.com/trust/)

lib/client.dart

@@ -7,11 +7,11 @@ import 'package:http/http.dart' as http;
 
 class HttpClient extends http.BaseClient {
   final http.Client _client;
-  final Stack stack;
-  final Map<String, String> stackHeaders;
+  final Stack? stack;
+  final Map<String, String>? stackHeaders;
 
-  factory HttpClient(Map<String, String> headers,
-      {http.Client client, Stack stack}) {
+  factory HttpClient(Map<String, String>? headers,
+      {http.Client? client, Stack? stack}) {
     final stackClient = client ?? http.Client();
     return HttpClient._internal(stackClient, headers, stack);
   }
@@ -26,13 +26,13 @@ class HttpClient extends http.BaseClient {
     return _client.send(request);
   }
 
-  Future<T> sendRequest<T, K>(Uri uri) async {
-    stackHeaders[CONTENT_TYPE] = CONTENT_TYPE_VALUE;
-    stackHeaders[X_USER_AGENT] = X_USER_AGENT_VALUE;
+  Future<T?> sendRequest<T, K>(Uri uri) async {
+    stackHeaders![CONTENT_TYPE] = CONTENT_TYPE_VALUE;
+    stackHeaders![X_USER_AGENT] = X_USER_AGENT_VALUE;
     final response = await http
-        .get(uri, headers: stackHeaders)
+        .get(uri, headers: stackHeaders as Map<String, String>)
         .timeout(const Duration(seconds: TIMEOUT));
-    Object bodyJson;
+    Object? bodyJson;
     try {
       bodyJson = jsonDecode(response.body);
     } on FormatException {
@@ -44,42 +44,42 @@ class HttpClient extends http.BaseClient {
       rethrow;
     }
     if (response.statusCode == 200) {
-      final Map bodyJson = json.decode(utf8.decode(response.bodyBytes));
-      if (T == EntryModel && bodyJson.containsKey('entry')) {
+      final Map? bodyJson = json.decode(utf8.decode(response.bodyBytes));
+      if (T == EntryModel && bodyJson!.containsKey('entry')) {
         return fromJson<T, K>(bodyJson['entry']);
-      } else if (K == EntryModel && bodyJson.containsKey('entries')) {
+      } else if (K == EntryModel && bodyJson!.containsKey('entries')) {
         return fromJson<T, K>(bodyJson['entries']);
-      } else if (T == AssetModel && bodyJson.containsKey('asset')) {
+      } else if (T == AssetModel && bodyJson!.containsKey('asset')) {
         return fromJson<T, K>(bodyJson['asset']);
-      } else if (K == AssetModel && bodyJson.containsKey('assets')) {
+      } else if (K == AssetModel && bodyJson!.containsKey('assets')) {
         return fromJson<T, K>(bodyJson['assets']);
-      } else if (T == SyncResult && bodyJson.containsKey('items')) {
+      } else if (T == SyncResult && bodyJson!.containsKey('items')) {
         return fromJson<T, K>(bodyJson);
       } else {
-        if (bodyJson.containsKey('entries')) {
-          var previewResponse = stack.livePreview['entries'];
+        if (bodyJson!.containsKey('entries')) {
+          var previewResponse = stack!.livePreview?.entries;
           if (previewResponse != null) {
-            return fromJson<T, K>(mergeLivePreview(bodyJson, previewResponse));
+            return fromJson<T, K>(mergeLivePreview(bodyJson, Map.fromEntries(previewResponse)));
           }
         }
         return fromJson<T, K>(bodyJson);
       }
     } else {
-      return bodyJson;
+      return fromJson<T, K>(bodyJson) as FutureOr<T?>;
     }
   }
 
-  mergeLivePreview(Map bodyJson, Map previewResponse) {}
+  mergeLivePreview(Map? bodyJson, Map previewResponse) {}
 
   /// Generic objects as well as List of generic objects
   /// (from a JSON list response).
   /// First, you need to have a function that checks the type  of the
   /// generic object and returns the result of the corresponding fromJson call
   /// code taken from:
   /// https://stackoverflow.com/questions/56271651/how-to-pass-a-generic-type-as-a-parameter-to-a-future-in-flutter
-  static T fromJson<T, K>(dynamic json) {
+  static T? fromJson<T, K>(dynamic json) {
     if (json is Iterable) {
-      return _fromJsonList<K>(json) as T;
+      return _fromJsonList<K>(json as List<dynamic>) as T;
     } else if (T == AssetModel) {
       return AssetModel.fromJson(json) as T;
     } else if (T == EntryModel) {
@@ -91,14 +91,14 @@ class HttpClient extends http.BaseClient {
     }
   }
 
-  static List<K> _fromJsonList<K>(List jsonList) {
+  static List<K?>? _fromJsonList<K>(List? jsonList) {
     if (jsonList == null) {
       return null;
     }
 
-    final output = <K>[];
+    final output = <K?>[];
     // ignore: prefer_final_in_for_each
-    for (Map<String, dynamic> json in jsonList) {
+    for (Map<String, dynamic> json in jsonList as Iterable<Map<String, dynamic>>) {
       output.add(fromJson(json));
     }
     return output;

lib/constant.dart

@@ -9,13 +9,13 @@ const X_USER_AGENT_VALUE = '$SDK_NAME-v$SDK_VERSION';
 const TIMEOUT = 30;
 
 void ifLivePreviewEnable(HttpClient _client) {
-  final dictLivePreview = _client.stack.livePreview;
+  final dictLivePreview = _client.stack!.livePreview;
   const String AUTH = 'authorization';
-  if (dictLivePreview.containsKey('enable')) {
-    _client.stack.removeHeader('access_token');
-    _client.stack.removeHeader('environment');
-    _client.stack.setHeader(AUTH, _client.stack.livePreview[AUTH]);
-    _client.stack.setHost(dictLivePreview['host']);
+  if (dictLivePreview!.containsKey('enable')) {
+    _client.stack!.removeHeader('access_token');
+    _client.stack!.removeHeader('environment');
+    _client.stack!.setHeader(AUTH, _client.stack!.livePreview![AUTH]);
+    _client.stack!.setHost(dictLivePreview['host']);
     final String errMessage = '''Invalid content_type_uid! Make sure you have 
           provided same content_type_uid 
           livePreviewQuery parameter in stack class''';

lib/src/asset.dart

@@ -8,11 +8,11 @@ import 'package:contentstack/client.dart';
 /// Learn more about [Assets](https://www.contentstack.com/docs/developers/apis/content-delivery-api/#get-a-single-asset)
 ///
 class Asset {
-  final HttpClient _client;
-  final String _uid;
-  String _urlPath;
+  final HttpClient? _client;
+  final String? _uid;
+  String? _urlPath;
 
-  final Map<String, String> assetParameter = <String, String>{};
+  final Map<String, String?> assetParameter = <String, String?>{};
 
   /// * [_uid] assetUid:
   /// Enter the unique ID of the asset of which you wish to retrieve
@@ -27,8 +27,8 @@ class Asset {
   /// });
   ///
   Asset(this._uid, [this._client]) {
-    assetParameter['environment'] = _client.stackHeaders['environment'];
-    _urlPath = '/${_client.stack.apiVersion}/assets';
+    assetParameter['environment'] = _client!.stackHeaders!['environment'];
+    _urlPath = '/${_client!.stack!.apiVersion}/assets';
   }
 
   ///
@@ -57,13 +57,13 @@ class Asset {
   /// }).catchError((error) {
   ///   print(error['error_code']);
   /// });
-  Future<T> fetch<T, K>() {
-    if (_uid == null || _uid.isEmpty) {
+  Future<T?> fetch<T, K>() {
+    if (_uid == null || _uid!.isEmpty) {
       throw Exception('Provide asset uid to fetch single entry');
     }
     final uri =
-        Uri.https(_client.stack.endpoint, '$_urlPath/$_uid', assetParameter);
-    return _client.sendRequest<T, K>(uri);
+        Uri.https(_client!.stack!.endpoint!, '$_urlPath/$_uid', assetParameter);
+    return _client!.sendRequest<T, K>(uri);
   }
 
   ///

lib/src/asset_query.dart

@@ -8,12 +8,12 @@ import 'package:contentstack/src/base_query.dart';
 /// You can also specify the environment of which you wish to get the assets.
 /// Learn more about [Assets](https://www.contentstack.com/docs/developers/apis/content-delivery-api/#all-assets)
 class AssetQuery extends BaseQuery {
-  final HttpClient _client;
-  String _urlPath;
+  final HttpClient? _client;
+  late String _urlPath;
 
   AssetQuery([this._client]) {
-    queryParameter['environment'] = _client.stackHeaders['environment'];
-    _urlPath = '/${_client.stack.apiVersion}/assets';
+    queryParameter['environment'] = _client!.stackHeaders!['environment'];
+    _urlPath = '/${_client!.stack!.apiVersion}/assets';
   }
 
   ///
@@ -42,9 +42,9 @@ class AssetQuery extends BaseQuery {
   /// }).catchError((error) {
   ///   print(error['error_code']);
   /// });
-  Future<T> find<T, K>() async {
-    final uri = Uri.https(_client.stack.endpoint, _urlPath, queryParameter);
-    return _client.sendRequest<T, K>(uri);
+  Future<T?> find<T, K>() async {
+    final uri = Uri.https(_client!.stack!.endpoint!, _urlPath, queryParameter);
+    return _client!.sendRequest<T, K>(uri);
   }
 
   ///

lib/src/base_query.dart

@@ -1,11 +1,12 @@
 import 'package:contentstack/src/enums/operations.dart';
+import 'package:contentstack/src/enums/operations_type.dart';
 
 ///
 /// This is base Query class that contains common
 /// functions to query in Entry, Assets and content_type
 /// common query for asset & entry
 class BaseQuery {
-  final Map<String, String> queryParameter = <String, String>{};
+  final Map<String, String?> queryParameter = <String, String?>{};
   final Map<String, dynamic> parameter = <String, dynamic>{};
 
   ///
@@ -156,27 +157,38 @@ class BaseQuery {
 
   void where(String fieldUid, QueryOperation queryOperation) {
     if (fieldUid != null && fieldUid.isNotEmpty) {
-      queryOperation.when(equals: (operation) {
-        parameter[fieldUid] = operation.value;
-      }, notEquals: (operation) {
-        parameter[fieldUid] = {'\$ne': operation.value};
-      }, includes: (operation) {
-        parameter[fieldUid] = {'\$in': operation.value};
-      }, excludes: (operation) {
-        parameter[fieldUid] = {'\$nin': operation.value};
-      }, isLessThan: (operation) {
-        parameter[fieldUid] = {'\$lt': operation.value};
-      }, isLessThanOrEqual: (operation) {
-        parameter[fieldUid] = {'\$lte': operation.value};
-      }, isGreaterThan: (operation) {
-        parameter[fieldUid] = {'\$gt': operation.value};
-      }, isGreaterThanOrEqual: (operation) {
-        parameter[fieldUid] = {'\$gte': operation.value};
-      }, exists: (operation) {
-        parameter[fieldUid] = {'\$exists': operation.value};
-      }, matches: (operation) {
-        parameter[fieldUid] = {'\$regex': operation.regex};
-      });
+      switch(queryOperation.operationType) {
+        case QueryOperationType.Equals:
+          parameter[fieldUid] = queryOperation.value;
+          break;
+        case QueryOperationType.NotEquals:
+          parameter[fieldUid] = {'\$ne': queryOperation.value};
+          break;
+        case QueryOperationType.Includes:
+          parameter[fieldUid] = {'\$in': queryOperation.value};
+          break;
+        case QueryOperationType.Excludes:
+          parameter[fieldUid] = {'\$nin': queryOperation.value};
+          break;
+        case QueryOperationType.IsLessThan:
+          parameter[fieldUid] = {'\$lt': queryOperation.value};
+          break;
+        case QueryOperationType.IsLessThanOrEqual:
+          parameter[fieldUid] = {'\$lte': queryOperation.value};
+          break;
+        case QueryOperationType.IsGreaterThan:
+          parameter[fieldUid] = {'\$gt': queryOperation.value};
+          break;
+        case QueryOperationType.IsGreaterThanOrEqual:
+          parameter[fieldUid] = {'\$gte': queryOperation.value};
+          break;
+        case QueryOperationType.Exists:
+          parameter[fieldUid] = {'\$exists': queryOperation.value};
+          break;
+        case QueryOperationType.Matches:
+          parameter[fieldUid] = {'\$regex': queryOperation.value};
+          break;
+      }
     }
   }
 }