From daf42cfc2c60fd3f90e57d0085b8fe3b9c077be7 Mon Sep 17 00:00:00 2001
From: Benjamin Altpeter <hi@bn.al>
Date: Mon, 28 Aug 2023 14:21:37 +0200
Subject: [PATCH] Fixes #30: Towards #9: Document `branch-io/v1`

---
 src/adapters/branch-io.ts | 61 +++++++++++++++++----------------------
 1 file changed, 27 insertions(+), 34 deletions(-)

diff --git a/src/adapters/branch-io.ts b/src/adapters/branch-io.ts
index 1891500..3ad8644 100644
--- a/src/adapters/branch-io.ts
+++ b/src/adapters/branch-io.ts
@@ -27,36 +27,36 @@ export const adapters: Adapter[] = [
                 {
                     context: 'body',
                     path: 'google_advertising_id',
-                    reasoning: 'obvious property name',
+                    reasoning: 'https://help.branch.io/developers-hub/reference/attribution-api',
                 },
                 {
                     context: 'body',
                     path: 'advertising_ids.aaid',
-                    reasoning: 'obvious property name',
+                    reasoning: 'https://help.branch.io/developers-hub/reference/attribution-api',
                 },
             ],
 
             idfv: {
                 context: 'body',
                 path: 'ios_vendor_id',
-                reasoning: 'obvious property name',
+                reasoning: 'https://help.branch.io/developers-hub/reference/attribution-api',
             },
 
             otherIdentifiers: [
                 {
                     context: 'body',
                     path: 'hardware_id',
-                    reasoning: 'obvious property name',
+                    reasoning: 'https://github.com/tweaselORG/TrackHAR/issues/30#issuecomment-1695529472',
                 },
                 {
                     context: 'body',
                     path: 'metadata.$marketing_cloud_visitor_id',
-                    reasoning: 'obvious property name',
+                    reasoning: 'https://help.branch.io/partners-portal/docs/adobe-analytics',
                 },
                 {
                     context: 'body',
                     path: 'metadata.$braze_install_id',
-                    reasoning: 'obvious property name',
+                    reasoning: 'https://help.branch.io/partners-portal/docs/braze',
                 },
                 {
                     context: 'body',
@@ -71,27 +71,22 @@ export const adapters: Adapter[] = [
                 {
                     context: 'body',
                     path: 'metadata.$google_analytics_client_id',
-                    reasoning: 'obvious property name',
+                    reasoning: 'https://help.branch.io/partners-portal/docs/google-analytics',
                 },
                 {
                     context: 'body',
                     path: 'metadata.$mixpanel_distinct_id',
-                    reasoning: 'obvious property name',
+                    reasoning: 'https://help.branch.io/partners-portal/docs/mixpanel',
                 },
                 {
                     context: 'body',
                     path: 'metadata.$segment_anonymous_id',
-                    reasoning: 'obvious property name',
-                },
-                {
-                    context: 'body',
-                    path: 'metadata.transaction_id',
-                    reasoning: 'obvious property name',
+                    reasoning: 'https://help.branch.io/partners-portal/docs/segment-export',
                 },
                 {
                     context: 'body',
                     path: 'metadata.user_id',
-                    reasoning: 'obvious property name',
+                    reasoning: 'https://help.branch.io/using-branch/docs/advertising-identifiers-for-attribution',
                 },
                 {
                     context: 'body',
@@ -108,6 +103,11 @@ export const adapters: Adapter[] = [
                     path: 'identity_id',
                     reasoning: 'obvious property name',
                 },
+                {
+                    context: 'body',
+                    path: 'identity',
+                    reasoning: 'https://help.branch.io/developers-hub/reference/attribution-api',
+                },
             ],
 
             manufacturer: {
@@ -125,13 +125,13 @@ export const adapters: Adapter[] = [
             screenWidth: {
                 context: 'body',
                 path: 'screen_width',
-                reasoning: 'obvious property name',
+                reasoning: 'https://help.branch.io/developers-hub/reference/attribution-api',
             },
 
             screenHeight: {
                 context: 'body',
                 path: 'screen_height',
-                reasoning: 'obvious property name',
+                reasoning: 'https://help.branch.io/developers-hub/reference/attribution-api',
             },
 
             networkConnectionType: {
@@ -143,7 +143,7 @@ export const adapters: Adapter[] = [
             osName: {
                 context: 'body',
                 path: 'os',
-                reasoning: 'obvious property name',
+                reasoning: 'https://help.branch.io/developers-hub/reference/attribution-api',
             },
 
             osVersion: [
@@ -155,7 +155,7 @@ export const adapters: Adapter[] = [
                 {
                     context: 'body',
                     path: 'os_version',
-                    reasoning: 'obvious property name',
+                    reasoning: 'https://help.branch.io/developers-hub/reference/attribution-api',
                 },
             ],
 
@@ -175,7 +175,7 @@ export const adapters: Adapter[] = [
             localIp: {
                 context: 'body',
                 path: 'local_ip',
-                reasoning: 'obvious property name',
+                reasoning: 'https://help.branch.io/developers-hub/reference/attribution-api',
             },
 
             architecture: {
@@ -193,26 +193,19 @@ export const adapters: Adapter[] = [
             userAgent: {
                 context: 'body',
                 path: 'user_agent',
-                reasoning: 'obvious property name',
+                reasoning: 'https://help.branch.io/developers-hub/reference/attribution-api',
             },
 
-            country: [
-                {
-                    context: 'body',
-                    path: 'country',
-                    reasoning: 'obvious property name',
-                },
-                {
-                    context: 'body',
-                    path: 'locale',
-                    reasoning: 'obvious property name',
-                },
-            ],
+            country: {
+                context: 'body',
+                path: 'country',
+                reasoning: 'obvious property name',
+            },
 
             appVersion: {
                 context: 'body',
                 path: 'app_version',
-                reasoning: 'obvious property name',
+                reasoning: 'https://help.branch.io/developers-hub/reference/attribution-api',
             },
 
             appId: [