Adds and updatesfor JS SDK v4

Author: genwhittTTD

docs/guides/integration-javascript-client-side.md

@@ -46,13 +46,13 @@ To implement, you'll need to complete the following steps:
 
 Support for client-side token generation is available in version 3.4.5 and above of the SDK. 
 
-The URL for the SDK is:
+The URL for the SDK is: (**GWH__AS05 updated URL?**)
 
 - [https://cdn.prod.uidapi.com/uid2-sdk-3.4.5.js](https://cdn.prod.uidapi.com/uid2-sdk-3.4.5.js)
 
 In the following code examples, the placeholder `{{ UID2_JS_SDK_URL }}` refers to this URL.
 
-If you want to use a debug build of the SDK, use the following URL instead:
+If you want to use a debug build of the SDK, use the following URL instead: (**GWH__AS04 updated URL?**)
 
 - [https://cdn.integ.uidapi.com/uid2-sdk-3.4.5.js](https://cdn.integ.uidapi.com/uid2-sdk-3.4.5.js)
 

docs/sdks/sdk-ref-javascript-v2.md

@@ -1,6 +1,6 @@
 ---
-title: SDK for JavaScript (2.x and earlier versions)
-description: Reference information about earlier versions of the JavaScript client-side SDK.
+title: SDK for JavaScript (2.x and earlier)
+description: Reference information about 2.x and earlier versions of the JavaScript client-side SDK.
 hide_table_of_contents: false
 sidebar_position: 02
 ---
@@ -9,10 +9,10 @@ import Link from '@docusaurus/Link';
 import ExampleUid2Cookie from '/docs/snippets/_example-uid2-cookie.mdx';
 import ExampleJavaScriptV2Init from '/docs/snippets/_example-javascript-v2-init.mdx';
 
-# SDK for JavaScript Reference Guide (2.x and earlier versions)
+# SDK for JavaScript Reference Guide (v2.x and earlier)
 
-:::tip
-This documentation is for earlier versions of the SDK for JavaScript. If you're using an earlier version, we recommend upgrading. See [SDK for JavaScript Reference Guide](sdk-ref-javascript.md), which includes a migration guide.
+:::important
+This documentation is for earlier versions of the SDK for JavaScript. If you're using an earlier version, we recommend upgrading. See [SDK for JavaScript Reference Guide](sdk-ref-javascript.md), which includes a migration guide to upgrade to the current version, v4.
 :::
 
 Use this SDK to facilitate the process of establishing client identity using UID2 and retrieving advertising tokens. The following sections describe the high-level [workflow](#workflow-overview) for establishing UID2 identity, provide the SDK [API reference](#api-reference), and explain the [UID2 cookie format](#uid2-cookie-format). 
@@ -47,11 +47,6 @@ This SDK is in the following open-source GitHub repository:
 
 - [https://github.com/iabtechlab/uid2-web-integrations](https://github.com/iabtechlab/uid2-web-integrations)
 
-<!-- The binary is published in these locations:
-
-- NPM: [https://www.npmjs.com/package/@uid2/uid2-sdk](https://www.npmjs.com/package/@uid2/uid2-sdk)
-- CDN: [https://cdn.prod.uidapi.com/uid2-sdk-${VERSION_ID}.js](https://cdn.prod.uidapi.com/uid2-sdk-${VERSION_ID}.js) (** v3 JS SDK: stash per SW 8/15/23**) -->
-
 ## Terminology
 
 In this document, the following terms apply:

docs/sdks/sdk-ref-javascript-v3.md

@@ -11,18 +11,6 @@ import Link from '@docusaurus/Link';
 import ExampleUid2Cookie from '/docs/snippets/_example-uid2-cookie.mdx';
 import ExampleJavaScriptInit from '/docs/snippets/_example-javascript-init.mdx';
 
-export const New = () => (
-  <span className='pill'>NEW IN V3</span>
-);
-
-export const New3100 = () => (
-  <span className='pill'>New in version 3.10.0</span>
-);
-
-export const Deprecated3100 = () => (
-  <span className='pill'>Deprecated in version 3.10.0</span>
-);
-
 # SDK for JavaScript Reference Guide
 
 Use this SDK to facilitate the process of generating or establishing client identity using UID2, retrieving advertising tokens for <Link href="../ref-info/glossary-uid#gl-bidstream">bidstream</Link> use, and automatically refreshing UID2 tokens.
@@ -33,12 +21,24 @@ The following sections describe the high-level [workflow](#workflow-overview) fo
 If you're using Prebid.js with the UID2 Identity Module, or with another product that has UID2 support, you probably don't need to use the SDK at all. The Prebid.js module manages everything. For details, see [UID2 Client-Side Integration Guide for Prebid.js](../guides/integration-prebid-client-side.md).
 :::
 
-This page describes version 3 of the SDK. If you are using an earlier version, we recommend that you upgrade your integration, using the [migration guide](#migration-guide). If needed, documentation for [earlier versions of the SDK](./sdk-ref-javascript-v2.md) is also available.
-
 For integration steps for content publishers, refer to either of the following:
   - [Client-Side Integration Guide for JavaScript](../guides/integration-javascript-client-side.md)
   - [Client-Server Integration Guide for JavaScript](../guides/integration-javascript-client-server.md)
 
+## SDK Version
+
+This page describes version 4 of the UID2 SDK for JavaScript, which is the latest version. If you're using an earlier version, we recommend that you upgrade your integration, using the [migration guide](#migration-guide). If needed, documentation is also available for the following earlier versions:
+
+- [Version 3](./sdk-ref-javascript-v3.md)
+- [Version 2.x and earlier](./sdk-ref-javascript-v2.md)
+
+## Changes From Previous Version
+
+Version 4 includes the following key changes from version 3:
+
+- **New**: [**GWH__AS01 include any info here re changes, updates, new stuff.**]
+- **Deprecated elements**: the `abort()` function was deprecated in v3 and is not part of v4. Instead, use [disconnect()](#disconnect-void) which has the same functionality as `abort()`, but also includes more thorough disconnection logic. 
+
 ## Functionality
 
 This SDK simplifies development for publishers who want to build their own customized UID2 integration. The following table shows the functions it supports.
@@ -274,13 +274,12 @@ All interactions with the SDK for JavaScript are done through the global `__uid2
 - [getAdvertisingToken()](#getadvertisingtoken-string)
 - [getAdvertisingTokenAsync()](#getadvertisingtokenasync-promise)
 - [isLoginRequired()](#isloginrequired-boolean)
-- [isIdentityAvailable()](#isidentityavailable-boolean) <New3100 />
+- [isIdentityAvailable()](#isidentityavailable-boolean)
 - [disconnect()](#disconnect-void)
-- [abort()](#abort-void) <Deprecated3100 />
-- [callbacks](#callbacks) <New />
-- [setIdentity()](#setidentityidentity-identity-void) <New />
-- [getIdentity()](#getidentity-identity--null) <New />
-- [isInitComplete()](#isinitcomplete-boolean) <New />
+- [callbacks](#callbacks)
+- [setIdentity()](#setidentityidentity-identity-void)
+- [getIdentity()](#getidentity-identity--null)
+- [isInitComplete()](#isinitcomplete-boolean)
 
 ### constructor()
 
@@ -333,7 +332,7 @@ The `opts` object supports the following properties.
 | `cookieDomain` | string | Optional | The domain name string to apply to the UID2 cookie (see [UID2 Storage Format](#uid2-storage-format)).<br/>For example, if the `baseUrl` is `https://my.operator.com`, the `cookieDomain` value might be `operator.com`. | `undefined` |
 | `cookiePath` | string | Optional | The path string to apply to the UID2 cookie (see [UID2 Storage Format](#uid2-storage-format)). | `/` |
 | `useCookie` | `boolean` | Optional | Set this to `true` to tell the SDK to store the identity in cookie storage instead of local storage. You can still provide an identity using a first-party cookie if this value is false or not provided. | 
-| `callback` | `function(object): void` | Deprecated | The function that the SDK should invoke after validating the passed identity. Do not use this for new integrations. | N/A |
+| `callback` | `function(object): void` | Deprecated | The function that the SDK should invoke after validating the passed identity. Do not use this for new integrations. [**GWH__AS02 do we need to remove this line?**] | N/A |
 
 #### Multiple Init Calls
 
@@ -439,8 +438,6 @@ Specifies whether a UID2 [POST&nbsp;/token/generate](../endpoints/post-token-gen
 
 ### isIdentityAvailable(): boolean
 
-<New3100 />
-
 Determines whether an identity is available: for example, if there is an unexpired identity in local storage or in a cookie, or if an identity has already been requested.
 
 If false, a UID2 [POST&nbsp;/token/generate](../endpoints/post-token-generate.md) call is required. 
@@ -475,16 +472,6 @@ After this function is executed, the [getAdvertisingToken()](#getadvertisingtoke
 If you need to provide a `cookieDomain` or `cookiePath` for the SDK to access the correct cookie, and `init` has not been completed, the SDK cannot clear the cookie. In this case, no error is raised.
 :::
 
-### abort(): void
-
-<Deprecated3100 />
-
-This function is deprecated and support will be removed soon. Instead, use [disconnect()](#disconnect-void) which has the same functionality as `abort()`, but also includes more thorough disconnection logic. 
-	
-Terminates any background timers or requests. The UID2 object remains in an unspecified state and cannot be used anymore. 
-
-This function is intended for use in advanced scenarios where you might want to replace the existing UID2 object with a new instance.
-
 ### callbacks
 
 This is an array that stores all of the registered callbacks. You should only interact with it using the [Array Push Pattern](#array-push-pattern).
@@ -542,9 +529,9 @@ The following is an example of the UID2 cookie structure:
 The contents of the `private` object are explicitly unspecified and are left for the SDK to interpret. Do not make any assumptions about the structure, semantics, or compatibility of this object. Any updates to the cookie must retain its structure.
 :::
 
-## Migration Guide
+## Migration Guide [GWH__AS03 this section needs updating]
 
-This section includes all the information you need to upgrade from an earlier version of the SDK for JavaScript to the current version, v3. It includes:
+This section includes all the information you need to upgrade from an earlier version of the SDK for JavaScript to the current version, v4. It includes:
 
 - [Benefits of Migrating](#benefits-of-migrating)
 - [Required Changes](#required-changes)
@@ -563,7 +550,7 @@ If your existing integration uses version 1.x or 2.x of the SDK, version 3 is fu
   - If you rely on setting a first-party cookie to provide a new identity, you do not gain any benefit from this change.
   - If you only provide the identity by passing it to `init`, the SDK no longer writes to the cookie.
 
-Some of the functionality from versions 1.x and 2.x has been deprecated, and you should make changes to future-proof your integration.
+Some of the functionality from earlier versions has been deprecated, and you should make changes to future-proof your integration.
 - The legacy callback system has been deprecated and will eventually be removed.
 
 By updating your integration, you can take advantage of the additional features available:

docs/sdks/sdk-ref-javascript.md

@@ -1,5 +1,5 @@
 ---
-title: SDK for JavaScript (2.x and earlier versions)
+title: SDK for JavaScript (2.x and earlier)
 description: JavaScript Client-Side SDK の旧バージョンに関するリファレンス情報。
 hide_table_of_contents: false
 sidebar_position: 02
@@ -9,9 +9,9 @@ import Link from '@docusaurus/Link';
 import ExampleUid2Cookie from '../snippets/_example-uid2-cookie.mdx';
 import ExampleJavaScriptV2Init from '../snippets/_example-javascript-v2-init.mdx';
 
-# SDK for JavaScript Reference Guide (2.x and earlier versions)
+# SDK for JavaScript Reference Guide (v2.x and earlier)
 
-:::tip
+:::important
 このドキュメントは、SDK for JavaScript の旧バージョン用です。以前のバージョンを使用している場合は、アップグレードすることを勧めます。移行ガイドを含む [SDK for JavaScript Reference Guide](sdk-ref-javascript.md) を参照してください。
 :::
 
@@ -46,10 +46,6 @@ SDK が提供する特定の機能の使用許可が与えられ、そのアク
 
 - [https://github.com/iabtechlab/uid2-web-integrations](https://github.com/iabtechlab/uid2-web-integrations)
 
-<!-- The binary is published in these locations:
-
-- NPM: [https://www.npmjs.com/package/@uid2/uid2-sdk](https://www.npmjs.com/package/@uid2/uid2-sdk)
-- CDN: [https://cdn.prod.uidapi.com/uid2-sdk-${VERSION_ID}.js](https://cdn.prod.uidapi.com/uid2-sdk-${VERSION_ID}.js) (** v3 JS SDK: stash per SW 8/15/23**) -->
 
 ## Terminology