Web SDK v5.0.0 Migration Guide
This guide is to provide information about breaking changes and how to migrate to the AmitySDK 5.0.0 version.

Installation

Following the recent changes with Amity Social Cloud, the Web SDK is now published under a different name.
To install the new v5 version, you will have to run the following commands:
1
npm uninstall eko-sdk # uninstall version 4
2
npm install --save @amityco/js-sdk # install version 5
Copied!
After that, you'll have to change your imports accordingly. You can easily do this by performing a global "search and replace" and put eko-sdk as input and @amityco/js-sdk as output. You should end up with a diff looking like this:
1
-import Client from 'eko-sdk'
2
+import Client from '@amityco/js-sdk'
Copied!
After that, we also renamed the sets of constants for consistency.

Handling breaking changes

Don't worry, we didn't change much! Only errors and constants were impacted since we used to prefix them. Aside from this, we did not introduce any change in SDK's logic.
If you are looking for a quick win which will fit 90% of the projects, we recommend you to perform a quick "search and replace" and erase the "Eko" prefix from your code wherever you used it. That is that simple!
For the most precautious, here's an exhaustive list of the names we changed.

Eko Client (optional)

The main object you'll interact with is our SDK Client. This class can be freely renamed since it is the default export of our package (ie: import EkoClient from "eko-sdk") so there should be no problem keeping it like this if you prefer.
In the eventuality that you'd like to keep the name we gave in the source code, please find that we rename the class to ASCClient.
Old names (v4)
New names (v5)
EkoClient
ASCClient

Errors (optional)

Globally found, there will be no need to adapt your code except if you specifically added try catch blocks for those error classes.
Old names (v4)
New names (v5)
EkoSDKError
ASCError
EkoSDKConnectionError
ASCSDKConnectionError
EkoSDKInvalidParameterError
ASCSDKInvalidParameterError

Constants (mandatory)

All these can be found as named exports at the root of our package (ie: import { EkoFileType } from "eko-sdk"). You will have to manually change those.

Client

Old names (v4)
New names (v5)
EkoConnectionStatus
ConnectionStatus
EkoErrorCode
ErrorCode

LiveObject

Old names (v4)
New names (v5)
EkoDataStatus
DataStatus
EkoLoadingStatus
LoadingStatus

User

Old names (v4)
New names (v5)
EkoUserSortingMethod
UserSortingMethod

File

Old names (v4)
New names (v5)
EkoFileType
FileType
EkoImageSize
ImageSize

Reactions

Old names (v4)
New names (v5)
EkoReactionReferenceType
ReactionReferenceType
EkoReactionEventType
ReactionEventType

Channel

Old names (v4)
New names (v5)
EkoChannelType
ChannelType
EkoChannelMembership
ChannelMembership
EkoMemberFilter
MemberFilter

Message

Old names (v4)
New names (v5)
EkoMessageType
MessageType
EkoSyncState
SyncState

Community

Old names (v4)
New names (v5)
EkoCommunityFilter
CommunityFilter
EkoCommunitySortingMethod
CommunitySortingMethod
EkoCommunityUserFilter
CommunityUserFilter
EkoCommunityUserMembership
CommunityUserMembership
EkoCommunityUserSortingMethod
CommunityUserSortingMethod
EkoCommunityCategorySortingMethod
CommunityCategorySortingMethod

Post

Old names (v4)
New names (v5)
EkoPostTargetType
PostTargetType
EkoPostDataType
PostDataType
EkoPostSortingMethod
PostSortingMethod

Comment

Old names (v4)
New names (v5)
EkoCommentReferenceType
CommentReferenceType
EkoCommentDataType
CommentDataType
EkoCommentSortingMethod
CommentSortingMethod

Conflicting names

In case you're already using any of those names in your own codebase, you can easily manage by renaming the named imports with the as keyword.
1
import { CommentDataType } from './my-own-module'
2
3
// use "as" to rename as you see fit and avoid conflicts.
4
import {
5
CommentDataType as ASCCommentDataType,
6
} from '@amityco/js-sdk'
Copied!
Last modified 5mo ago