feat: Update Dart, Flutter API links and improve document structure (#931)

Author: mbfakourii

Diff for: _config.yml

@@ -20,10 +20,11 @@ support_url: https://community.parseplatform.org
 apis:
   osx: https://parseplatform.org/Parse-SDK-iOS-OSX/api/
   android: https://parseplatform.org/Parse-SDK-Android/api/
-  js: https://parseplatform.org/Parse-SDK-JS/api/master/
+  js: https://parseplatform.org/Parse-SDK-JS/api/
   php: https://parseplatform.org/parse-php-sdk/
   dotnet: https://parseplatform.org/Parse-SDK-dotNET/api/
-  flutter: flutter/api/
+  flutter: https://parseplatform.org/Parse-SDK-Flutter/flutter/flutter_parse_sdk_flutter/flutter_parse_sdk_flutter-library.html
+  dart: https://parseplatform.org/Parse-SDK-Flutter/dart/flutter_parse_sdk/flutter_parse_sdk-library.html
   parse-server: https://parseplatform.org/parse-server/api/
 
 # Build settings

Diff for: _includes/flutter/cloud-code.md renamed to _includes/dart/cloud-code.md

@@ -0,0 +1,73 @@
+# Getting Started
+
+- To install the Parse Dart SDK add it to your app as a dependency via the [pub.dev](https://pub.dev/packages/parse_server_sdk/install) registry.
+
+Once you have the SDK added as a dependency, initialize the SDK as early as possible in your application (e.g. in your application class) like this:
+
+```dart
+await Parse().initialize(
+    keyApplicationId,
+    keyParseServerUrl,
+);
+```
+
+If you want to use secure storage or use the Flutter web/desktop SDK, please change to the below instance of  `CoreStorage` as it has no dependencies on Flutter. `CoreStoreSembastImp` does not encrypt the data on the web and Web is not safe anyway. Encrypt fields manually as needed.
+
+```dart
+await Parse().initialize(
+  	keyParseApplicationId, 
+  	keyParseServerUrl,
+        coreStore: await CoreStoreSembastImp.getInstance("/data"));
+```
+
+It's possible to add other parameters to work with your instance of Parse Server:
+
+```dart
+await Parse().initialize(
+    keyApplicationId,
+    keyParseServerUrl,
+    clientKey: keyParseClientKey, // Required for some setups
+    debug: true, // When enabled, prints logs to console
+    liveQueryUrl: keyLiveQueryUrl, // Required if using LiveQuery 
+    autoSendSessionId: true, // Required for authentication and ACL
+    securityContext: securityContext, // Again, required for some setups
+    coreStore: CoreStoreMemoryImp()); // Non persistent mode (default): Sdk will store everything in memory instead of using Sembast as an internal DB.
+```
+
+⚠️ The master key should only be used in safe environments and never on client side. Using this package on a server should be fine.
+
+## Early Web Support
+
+Due to Cross-Origin Resource Sharing (CORS) restrictions, web support requires adding `X-Parse-Installation-Id` as an allowed header in the Parse Server configuration:
+
+- When running directly via docker, set the env var `PARSE_SERVER_ALLOW_HEADERS=X-Parse-Installation-Id`.
+- When running via express, set the [Parse Server option](https://parseplatform.org/parse-server/api/master/ParseServerOptions.html) `allowHeaders: ['X-Parse-Installation-Id']`.
+
+## Desktop Support (macOS)
+
+The security entitlements posed by the macOS framework require that your app is granted permission to open outgoing network connections, so that the Parse Flutter SDK can communicate with Parse Server. To grant this permission, add the following code:
+
+```swift
+<key>com.apple.security.network.client</key>
+<true/>
+```
+
+to the following files:
+
+```
+/macOS/Runner/Release.entitlements
+/macOS/Runner/DebugProfile.entitlements
+```
+
+## Network client
+
+By default, this SDK uses the `ParseHTTPClient`. Another option is use `ParseDioClient`. This client supports the most features (for example a progress callback at the file upload), but a benchmark has shown that dio is slower than http on web.
+
+If you want to use the `ParseDioClient`, which uses the dio network library, you can provide a custom `ParseClientCreator` at the initialization of the SDK:
+
+```dart
+await Parse().initialize(
+  //...
+  clientCreator: ({bool? sendSessionId, SecurityContext? securityContext}) => ParseDioClient(sendSessionId: sendSessionId, securityContext: securityContext),
+);
+```

Diff for: _includes/flutter/config.md renamed to _includes/dart/config.md

@@ -1,6 +1,5 @@
 # Getting Started
 
-- To install the Parse Dart SDK add it to your app as a dependency via the [pub.dev](https://pub.dev/packages/parse_server_sdk/install) registry.
 - To install the Parse Flutter SDK add it to your app as a dependency via the [pub.dev](https://pub.dev/packages/parse_server_sdk_flutter/install) registry.
 
 Once you have the SDK added as a dependency, initialize the SDK as early as possible in your application (e.g. in your application class) like this:

Diff for: _includes/flutter/files.md renamed to _includes/dart/files.md

@@ -185,6 +185,11 @@
         width: 23px;
         height: 24px;
     }
+    svg.icon-dart{
+        fill: $dartPlatform;
+        width: 23px;
+        height: 24px;
+    }
     svg.icon-js{
         fill: $jsPlatform;
         width: 33px;

Diff for: _includes/dart/getting-started.md

@@ -75,6 +75,9 @@ input {
     &.flutter_docs_header{
       background-color: $flutterPlatform;
     }
+    &.dart_docs_header{
+      background-color: $dartPlatform;
+    }
     &.php_docs_docsearch{
       background-color: $phpPlatform;
     }

Diff for: _includes/flutter/objects.md renamed to _includes/dart/objects.md

@@ -34,6 +34,9 @@
         &.flutter_docs_header{
           background-color: $flutterPlatform;
         }
+        &.dart_docs_header{
+          background-color: $dartPlatform;
+        }
         &.php_docs_header{
           background-color: $phpPlatform;
         }

Diff for: _includes/flutter/other-features.md renamed to _includes/dart/other-features.md

@@ -97,6 +97,7 @@ $osxPlatform: #9CAFBA;
 $androidPlatform: #00C26E;
 $jsPlatform: #F5A623;
 $flutterPlatform: #47c5fb;
+$dartPlatform: #227ee6;
 $dotnetPlatform: #922ADD;
 $unityPlatform: #11A4BA;
 $phpPlatform: #0E69A1;

Diff for: _includes/flutter/queries.md renamed to _includes/dart/queries.md

@@ -0,0 +1,7 @@
+---
+layout: redirected
+sitemap: false
+permalink: /dart/api/
+redirect_to:
+- https://parseplatform.org/Parse-SDK-Flutter/dart/flutter_parse_sdk/flutter_parse_sdk-library.html
+---

Diff for: _includes/flutter/storage.md renamed to _includes/dart/storage.md

@@ -0,0 +1,21 @@
+---
+title: Dart Guide | Parse
+permalink: /dart/guide/
+layout: guide
+platform: dart
+language: dart
+display_platform: Dart
+api_reference: /dart/api
+
+sections:
+- "dart/getting-started.md"
+- "dart/objects.md"
+- "dart/queries.md"
+- "dart/cloud-code.md"
+- "dart/config.md"
+- "dart/files.md"
+- "dart/other-features.md"
+- "dart/storage.md"
+- "dart/users.md"
+
+---

Diff for: _includes/flutter/users.md renamed to _includes/dart/users.md

@@ -3,5 +3,5 @@ layout: redirected
 sitemap: false
 permalink: /flutter/api/
 redirect_to:
-  - https://pub.dev/documentation/parse_server_sdk_flutter/latest/
----
+- https://parseplatform.org/Parse-SDK-Flutter/flutter/flutter_parse_sdk_flutter/flutter_parse_sdk_flutter-library.html
+---

Diff for: _includes/flutter/getting-started.md

@@ -5,18 +5,18 @@ layout: guide
 platform: flutter
 language: dart
 display_platform: Flutter
-api_reference: https://parse-community.github.io/Parse-SDK-Flutter/api
+api_reference: /flutter/api
 
 sections:
 - "flutter/getting-started.md"
-- "flutter/objects.md"
-- "flutter/queries.md"
-- "flutter/cloud-code.md"
-- "flutter/config.md"
-- "flutter/files.md"
+- "dart/objects.md"
+- "dart/queries.md"
+- "dart/cloud-code.md"
+- "dart/config.md"
+- "dart/files.md"
 - "flutter/push-notifications.md"
-- "flutter/other-features.md"
-- "flutter/storage.md"
-- "flutter/users.md"
+- "dart/other-features.md"
+- "dart/storage.md"
+- "dart/users.md"
 
 ---

Diff for: assets/symbols.svg

@@ -79,6 +79,20 @@ layout: docs
           </footer>
       </div>
 
+      <div class="docs-platform">
+          <header class="docs-platform__header">
+              <span class="docs-platform__name">Dart</span>
+              <svg class="icon icon-dart"><use xlink:href="{{ site.baseurl }}/assets/symbols.svg#dart"></use></svg>
+          </header>
+          <ul class="docs-platform__links">
+              <li class="docs-platform__links"><a href="dart/guide/">Guide</a></li>
+              <li class="docs-platform__links"><a href="{{ site.apis.dart }}">API Reference</a></li>
+          </ul>
+          <footer class="docs-platform__footer">
+              <a href="https://github.com/parse-community/Parse-SDK-Flutter/releases/latest" class="btn btn--outline">Latest Downloads</a>
+          </footer>
+      </div>
+
       <div class="docs-platform">
           <header class="docs-platform__header">
               <span class="docs-platform__name">JavaScript</span>