@amityco/ts-sdk 6.12.2-d74459e.0 → 6.12.2-e855934.0

package/dist/index.cjs.js

@@ -943,7 +943,7 @@ const pullFromCache = (key) => {
 /**
  * ```js
  * import { pushToCache } from '@amityco/ts-sdk'
- * pushToCache<Amity.User>(["user", "foobar"], user)
+ * pushToCache<Amity.InternalUser>(["user", "foobar"], user)
  * ```
  *
  * Saves any provided value as {@link Amity.CacheEntry} for the matching {@link Amity.CacheKey}
@@ -1009,7 +1009,7 @@ const mergeInCache = (key, mutation, options) => {
 /**
  * ```js
  * import { upsertInCache } from '@amityco/ts-sdk'
- * upsertInCache<Amity.User>(["user", "foobar"], user)
+ * upsertInCache<Amity.InternalUser>(["user", "foobar"], user)
  * ```
  *
  * Insert or update any provided value as {@link Amity.CacheEntry} for
@@ -4706,7 +4706,11 @@ const withUser = (member, userIdProp = 'userId', userProp = 'user') => {
             const client = getActiveClient();
             if (!client.cache)
                 return undefined;
-            const userCache = (_a = pullFromCache(['user', 'get', member[userIdProp]])) === null || _a === void 0 ? void 0 : _a.data;
+            const userCache = (_a = pullFromCache([
+                'user',
+                'get',
+                member[userIdProp],
+            ])) === null || _a === void 0 ? void 0 : _a.data;
             if (!userCache) {
                 return undefined;
             }
@@ -6274,7 +6278,7 @@ const onChannelDeleted = (callback) => {
  * })
  * ```
  *
- * Fired when any {@link Amity.User} has been banned from any {@link Amity.Channel}
+ * Fired when any {@link Amity.InternalUser} has been banned from any {@link Amity.Channel}
  *
  * @param callback The function to call when the event was fired
  * @returns an {@link Amity.Unsubscriber} function to stop listening
@@ -6311,7 +6315,7 @@ const createUserEventSubscriber = (event, callback) => {
  * })
  * ```
  *
- * Fired when a {@link Amity.User} has been deleted
+ * Fired when a {@link Amity.InternalUser} has been deleted
  *
  * @param callback The function to call when the event was fired
  * @returns an {@link Amity.Unsubscriber} function to stop listening
@@ -7755,7 +7759,7 @@ const onChannelMuted = (callback) => {
  * })
  * ```
  *
- * Fired when any {@link Amity.User} has been added to any {@link Amity.Channel}
+ * Fired when any {@link Amity.InternalUser} has been added to any {@link Amity.Channel}
  *
  * @param callback The function to call when the event was fired
  * @returns an {@link Amity.Unsubscriber} function to stop listening
@@ -7781,7 +7785,7 @@ const onChannelMemberAdded = (callback) => {
  * })
  * ```
  *
- * Fired when any {@link Amity.User} has been removed from any {@link Amity.Channel}
+ * Fired when any {@link Amity.InternalUser} has been removed from any {@link Amity.Channel}
  *
  * @param callback The function to call when the event was fired
  * @returns an {@link Amity.Unsubscriber} function to stop listening
@@ -7807,7 +7811,7 @@ const onChannelMemberRemoved = (callback) => {
  * })
  * ```
  *
- * Fired when any {@link Amity.User} has been unbanned from any {@link Amity.Channel}
+ * Fired when any {@link Amity.InternalUser} has been unbanned from any {@link Amity.Channel}
  *
  * @param callback The function to call when the event was fired
  * @returns an {@link Amity.Unsubscriber} function to stop listening
@@ -8581,11 +8585,11 @@ const getChannels = (params, callback, config) => {
  * const updated = await addMembers(channelId, ['foo', 'bar'])
  * ```
  *
- * Adds a list of {@link Amity.User} to a {@link Amity.Channel}
+ * Adds a list of {@link Amity.InternalUser} to a {@link Amity.Channel}
  *
  * @param channelId The ID of the {@link Amity.Channel} to perform
- * @param userIds The list of IDs {@link Amity.User} to add
- * @returns A success boolean if the {@link Amity.User} were added to the {@link Amity.Channel}
+ * @param userIds The list of IDs {@link Amity.InternalUser} to add
+ * @returns A success boolean if the {@link Amity.InternalUser} were added to the {@link Amity.Channel}
  *
  * @category Channel API
  * @async
@@ -8615,11 +8619,11 @@ const addMembers$1 = async (channelId, userIds) => {
  * const updated = await removeMembers(channelId, ['foo', 'bar'])
  * ```
  *
- * Removes a list of {@link Amity.User} from a {@link Amity.Channel}
+ * Removes a list of {@link Amity.InternalUser} from a {@link Amity.Channel}
  *
  * @param channelId The ID of the {@link Amity.Channel} to perform
- * @param userIds The list of IDs {@link Amity.User} to remove
- * @returns A success boolean if the list of {@link Amity.User} were removed from the {@link Amity.Channel}
+ * @param userIds The list of IDs {@link Amity.InternalUser} to remove
+ * @returns A success boolean if the list of {@link Amity.InternalUser} were removed from the {@link Amity.Channel}
  *
  * @category Channel API
  * @async
@@ -8911,12 +8915,12 @@ var index$j = /*#__PURE__*/Object.freeze({
  * const updated = await addRole(channelId, 'foo', ['bar'])
  * ```
  *
- * Adds an {@link Amity.Role} to a list of {@link Amity.User} on a {@link Amity.Channel}
+ * Adds an {@link Amity.Role} to a list of {@link Amity.InternalUser} on a {@link Amity.Channel}
  *
  * @param channelId The ID of the {@link Amity.Channel} to perform
  * @param roleId The ID of the {@link Amity.Role} to apply
- * @param userId Array of IDs of the {@link Amity.User} to perform
- * @returns A success boolean if the {@link Amity.Role} were added to list of {@link Amity.User} in the {@link Amity.Channel}
+ * @param userId Array of IDs of the {@link Amity.InternalUser} to perform
+ * @returns A success boolean if the {@link Amity.Role} were added to list of {@link Amity.InternalUser} in the {@link Amity.Channel}
  *
  * @category Channel API
  * @async
@@ -8943,12 +8947,12 @@ const addRole = async (channelId, roleId, userIds) => {
  * const updated = await removeRole(channelId, 'foo', ['bar'])
  * ```
  *
- * Removes an {@link Amity.Role} from a list of {@link Amity.User} on a {@link Amity.Channel}
+ * Removes an {@link Amity.Role} from a list of {@link Amity.InternalUser} on a {@link Amity.Channel}
  *
  * @param channelId The ID of the {@link Amity.Channel} to perform
  * @param roleId The ID of the {@link Amity.Role} to apply
- * @param userIds Array of IDs of the {@link Amity.User} to perform
- * @returns A success boolean if the {@link Amity.Role} were removed from list of {@link Amity.User} in the {@link Amity.Channel}
+ * @param userIds Array of IDs of the {@link Amity.InternalUser} to perform
+ * @returns A success boolean if the {@link Amity.Role} were removed from list of {@link Amity.InternalUser} in the {@link Amity.Channel}
  *
  * @category Channel API
  * @async
@@ -8977,7 +8981,7 @@ const removeRole = async (channelId, roleId, userIds) => {
  * ```
  *
  * @param channelId of {@link Amity.Channel} from which the users should be banned
- * @param userIds of the {@link Amity.User}'s to be banned
+ * @param userIds of the {@link Amity.InternalUser}'s to be banned
  * @returns the updated {@link Amity.Membership}'s object
  *
  * @category Channel API
@@ -9012,7 +9016,7 @@ const banMembers$1 = async (channelId, userIds) => {
  * ```
  *
  * @param channelId of {@link Amity.Channel} where the users should be unbanned
- * @param userIds of the {@link Amity.User}'s to be unbanned
+ * @param userIds of the {@link Amity.InternalUser}'s to be unbanned
  * @returns the updated {@link Amity.Membership}'s object
  *
  * @category Channel API
@@ -9465,10 +9469,10 @@ var index$g = /*#__PURE__*/Object.freeze({
  * const blockedUser = await UserRepository.blockUser('userId')
  * ```
  *
- * Blocks a {@link Amity.User}
+ * Blocks a {@link Amity.InternalUser}
  *
- * @param userId The ID of the {@link Amity.User} to block
- * @returns the blocked {@link Amity.User} object
+ * @param userId The ID of the {@link Amity.InternalUser} to block
+ * @returns the blocked {@link Amity.InternalUser} object
  *
  * @category Post API
  * @async
@@ -9498,10 +9502,10 @@ const blockUser = async (userId) => {
  * const unblockedUser = await UserRepository.blockUser('userId')
  * ```
  *
- * Blocks a {@link Amity.User}
+ * Blocks a {@link Amity.InternalUser}
  *
- * @param userId The ID of the {@link Amity.User} to unblock
- * @returns the unblocked {@link Amity.User} object
+ * @param userId The ID of the {@link Amity.InternalUser} to unblock
+ * @returns the unblocked {@link Amity.InternalUser} object
  *
  * @category Post API
  * @async
@@ -9529,7 +9533,7 @@ const unBlockUser = async (userId) => {
  * ```
  *
  * @param query The query parameters
- * @returns A page of {@link Amity.User} objects
+ * @returns A page of {@link Amity.InternalUser} objects
  *
  * @category Block API
  * @async
@@ -9567,11 +9571,11 @@ const queryBlockedUsers = async (query) => {
  * const { data: users } = queryBlockedUsers.locally({ page: 'page_token' })
  * ```
  *
- * Queries a paginable list of {@link Amity.User} objects from cache
+ * Queries a paginable list of {@link Amity.InternalUser} objects from cache
  * Search is performed by displayName such as `.startsWith(search)`
  *
  * @param query The query parameters
- * @returns A page of {@link Amity.User} objects
+ * @returns A page of {@link Amity.InternalUser} objects
  *
  * @category Block API
  */
@@ -9599,6 +9603,105 @@ queryBlockedUsers.locally = (query = {}) => {
         : undefined;
 };
 
+const categoryLinkedObject = (category) => {
+    return Object.assign(Object.assign({}, category), { get avatar() {
+            var _a;
+            if (!category.avatarFileId)
+                return null;
+            let avatar = {
+                fileId: ((_a = category.avatarFileId) === null || _a === void 0 ? void 0 : _a.toString()) ? category.avatarFileId.toString() : '',
+                type: 'image',
+                fileUrl: '',
+                createdAt: '',
+                attributes: {
+                    name: '',
+                    extension: '',
+                    size: '',
+                    mimeType: '',
+                    metadata: {
+                        exif: {},
+                        gps: {},
+                        width: 0,
+                        height: 0,
+                        isFull: false,
+                    },
+                },
+            };
+            const cacheData = pullFromCache([
+                'file',
+                'get',
+                `${category.avatarFileId}`,
+            ]);
+            if (cacheData === null || cacheData === void 0 ? void 0 : cacheData.data) {
+                avatar = cacheData === null || cacheData === void 0 ? void 0 : cacheData.data;
+            }
+            return avatar;
+        } });
+};
+
+const commentLinkedObject = (comment) => {
+    return Object.assign(Object.assign({}, comment), { get target() {
+            const commentTypes = {
+                type: comment.targetType,
+            };
+            if (comment.targetType === 'user') {
+                return Object.assign(Object.assign({}, commentTypes), { userId: comment.targetId });
+            }
+            if (commentTypes.type === 'content') {
+                return Object.assign(Object.assign({}, commentTypes), { contentId: comment.targetId });
+            }
+            if (commentTypes.type === 'community') {
+                const cacheData = pullFromCache([
+                    'communityUsers',
+                    'get',
+                    `${comment.targetId}#${comment.userId}`,
+                ]);
+                return Object.assign(Object.assign({}, commentTypes), { communityId: comment.targetId, creatorMember: cacheData === null || cacheData === void 0 ? void 0 : cacheData.data });
+            }
+            return {
+                type: 'unknown',
+            };
+        } });
+};
+
+const userLinkedObject = (user) => {
+    return Object.assign(Object.assign({}, user), { get avatar() {
+            var _a;
+            if (!user.avatarFileId)
+                return null;
+            let avatar = {
+                fileId: ((_a = user.avatarFileId) === null || _a === void 0 ? void 0 : _a.toString()) ? user.avatarFileId.toString() : '',
+                type: 'image',
+                fileUrl: '',
+                createdAt: '',
+                attributes: {
+                    name: '',
+                    extension: '',
+                    size: '',
+                    mimeType: '',
+                    metadata: {
+                        exif: {},
+                        gps: {},
+                        width: 0,
+                        height: 0,
+                        isFull: false,
+                    },
+                },
+            };
+            const cacheData = pullFromCache(['file', 'get', `${user.avatarFileId}`]);
+            if (cacheData === null || cacheData === void 0 ? void 0 : cacheData.data) {
+                avatar = cacheData === null || cacheData === void 0 ? void 0 : cacheData.data;
+            }
+            return avatar;
+        } });
+};
+
+const LinkedObject = {
+    comment: commentLinkedObject,
+    user: userLinkedObject,
+    category: categoryLinkedObject,
+};
+
 /* eslint-disable no-use-before-define */
 /* begin_public_function
   id: user.get_blocked_users
@@ -9609,10 +9712,10 @@ queryBlockedUsers.locally = (query = {}) => {
  * const unblockedUser = await UserRepository.blockUser('userId')
  * ```
  *
- * Blocks a {@link Amity.User}
+ * Blocks a {@link Amity.InternalUser}
  *
- * @param params The params to get blocked {@link Amity.User}s
- * @param callback to recieve updates on unblocked {@link Amity.User}s
+ * @param params The params to get blocked {@link Amity.InternalUser}s
+ * @param callback to recieve updates on unblocked {@link Amity.InternalUser}s
  * @returns {@link Amity.Unsubscriber} to unsubscribe from collection
  *
  * @category Post API
@@ -9635,7 +9738,7 @@ const getBlockedUsers$1 = (params, callback, config) => {
         const users = (_a = data.data
             .map(userId => pullFromCache(['user', 'get', userId]))
             .filter(Boolean)
-            .map(({ data }) => data)) !== null && _a !== void 0 ? _a : [];
+            .map(({ data }) => LinkedObject.user(data))) !== null && _a !== void 0 ? _a : [];
         callback({
             onNextPage: onFetch,
             data: users,
@@ -9705,7 +9808,7 @@ const getBlockedUsers = (params, callback, config) => {
  *
  * Follow the user
  *
- * @param userId the ID of the {@link Amity.User}
+ * @param userId the ID of the {@link Amity.InternalUser}
  * @returns the status {@link Amity.FollowStatus}
  *
  * @category Follow API
@@ -9738,8 +9841,8 @@ const follow = async (userId) => {
  *
  * Cancel the follow request or unfollow the user
  *
- * @param userId the ID of the {@link Amity.User}
- * @returns A success boolean if the user {@link Amity.User} was unfollowed
+ * @param userId the ID of the {@link Amity.InternalUser}
+ * @returns A success boolean if the user {@link Amity.InternalUser} was unfollowed
  *
  * @category Follow API
  * @async
@@ -9767,7 +9870,7 @@ const unfollow = async (userId) => {
  *
  * Accept the follow request
  *
- * @param userId the ID of the {@link Amity.User} follower
+ * @param userId the ID of the {@link Amity.InternalUser} follower
  * @returns A success boolean if the follow request was accepted
  *
  * @category Follow API
@@ -9795,7 +9898,7 @@ const acceptFollower = async (userId) => {
  *
  * Accept the follow request
  *
- * @param userId the ID of the {@link Amity.User} follower
+ * @param userId the ID of the {@link Amity.InternalUser} follower
  * @returns A success boolean if the follow request was accepted
  *
  * @category Follow API
@@ -9824,7 +9927,7 @@ const acceptMyFollower = async (userId) => {
  *
  * Decline the follow request or delete the follower
  *
- * @param userId the ID of the {@link Amity.User} follower
+ * @param userId the ID of the {@link Amity.InternalUser} follower
  * @returns A success boolean if the follow request was decline
  *
  * @category Follow API
@@ -9852,7 +9955,7 @@ const declineFollower = async (userId) => {
  *
  * Decline the follow request or delete the follower
  *
- * @param userId the ID of the {@link Amity.User} follower
+ * @param userId the ID of the {@link Amity.InternalUser} follower
  * @returns A success boolean if the follow request was decline
  *
  * @category Follow API
@@ -10021,7 +10124,7 @@ const onFollowRequestDeclined = (callback) => createFollowEventSubscriber('follo
  *
  * Fetches the number of followers, followings, pending requests and the follow status for current user
  *
- * @param userId the ID of the {@link Amity.User}
+ * @param userId the ID of the {@link Amity.InternalUser}
  * @returns the associated {@link Amity.FollowInfo} object
  *
  * @category Follow API
@@ -10053,7 +10156,7 @@ const getFollowInfo$1 = async (userId) => {
  *
  * Fetches the number of followers, followings, pending requests and the follow status for current user from cache
  *
- * @param userId the ID of the {@link Amity.User}
+ * @param userId the ID of the {@link Amity.InternalUser}
  * @returns the associated {@link Amity.FollowInfo} object
  *
  * @category Follow API
@@ -10165,7 +10268,7 @@ const observeFollowInfo = (userId, callback, policy = 'cache_then_server') => {
  *
  * Observe all mutations on a list of followers {@link Amity.FollowStatus} for a given user
  *
- * @param userId the ID of the {@link Amity.User}
+ * @param userId the ID of the {@link Amity.InternalUser}
  * @param callback the function to call when new data are available
  * @returns An {@link Amity.Unsubscriber} function to run when willing to stop observing the messages
  *
@@ -10204,7 +10307,7 @@ const observeFollowers = (userId, callback) => {
  *
  * Observe all mutations on a list of followings {@link Amity.FollowStatus} for a given user
  *
- * @param userId the ID of the {@link Amity.User}
+ * @param userId the ID of the {@link Amity.InternalUser}
  * @param callback the function to call when new data are available
  * @returns An {@link Amity.Unsubscriber} function to run when willing to stop observing the messages
  *
@@ -10322,7 +10425,7 @@ queryFollowers.locally = (query) => queryFollows.locally('followers', query);
  *
  * let followers = []
  * const unsub = getFollowers({
- *   userId: Amity.User['userId'];
+ *   userId: Amity.InternalUser['userId'];
  * }, response => merge(followers, response.data))
  * ```
  *
@@ -10446,7 +10549,7 @@ queryFollowings.locally = (query) => queryFollows.locally('following', query);
  *
  * let followings = []
  * const unsub = getFollowings({
- *   userId: Amity.User['userId'];
+ *   userId: Amity.InternalUser['userId'];
  * }, response => merge(followings, response.data))
  * ```
  *
@@ -10650,7 +10753,7 @@ const getUserByIds = async (userIds) => {
         ingestInCache(data, { cachedAt });
     fireEvent('user.fetched', data);
     return {
-        data: data.users,
+        data: data.users.map(user => LinkedObject.user(user)),
         cachedAt,
     };
 };
@@ -10677,7 +10780,7 @@ getUserByIds.locally = (userIds) => {
     const cached = userIds
         .map(userId => pullFromCache(['user', 'get', userId]))
         .filter(Boolean);
-    const users = cached.map(({ data }) => data);
+    const users = cached.map(({ data }) => LinkedObject.user(data));
     const oldest = (_a = cached.sort((a, b) => (a.cachedAt < b.cachedAt ? -1 : 1))) === null || _a === void 0 ? void 0 : _a[0];
     if ((cached === null || cached === void 0 ? void 0 : cached.length) < userIds.length)
         return;
@@ -10696,11 +10799,11 @@ getUserByIds.locally = (userIds) => {
  * const updated = await updateUser(userId, { displayName: 'foobar' })
  * ```
  *
- * Updates an {@link Amity.User}
+ * Updates an {@link Amity.InternalUser}
  *
- * @param userId The ID of the {@link Amity.User} to update
+ * @param userId The ID of the {@link Amity.InternalUser} to update
  * @param patch The patch data to apply
- * @returns the updated {@link Amity.User} object
+ * @returns the updated {@link Amity.InternalUser} object
  *
  * @category User API
  * @async
@@ -10812,7 +10915,7 @@ const isUserFlaggedByMe = async (userId) => {
  * })
  * ```
  *
- * Fired when a {@link Amity.User} has been updated
+ * Fired when a {@link Amity.InternalUser} has been updated
  *
  * @param callback The function to call when the event was fired
  * @returns an {@link Amity.Unsubscriber} function to stop listening
@@ -10829,7 +10932,7 @@ const onUserUpdated = (callback) => createUserEventSubscriber('user.updated', ca
  * })
  * ```
  *
- * Fired when a {@link Amity.User} has been flagged
+ * Fired when a {@link Amity.InternalUser} has been flagged
  *
  * @param callback The function to call when the event was fired
  * @returns an {@link Amity.Unsubscriber} function to stop listening
@@ -10846,7 +10949,7 @@ const onUserFlagged = (callback) => createUserEventSubscriber('user.flagged', ca
  * })
  * ```
  *
- * Fired when a flag has been removed from a {@link Amity.User}
+ * Fired when a flag has been removed from a {@link Amity.InternalUser}
  *
  * @param callback The function to call when the event was fired
  * @returns an {@link Amity.Unsubscriber} function to stop listening
@@ -10863,7 +10966,7 @@ const onUserUnflagged = (callback) => createUserEventSubscriber('user.unflagged'
  * })
  * ```
  *
- * Fired when flags have been cleared for a {@link Amity.User}
+ * Fired when flags have been cleared for a {@link Amity.InternalUser}
  *
  * @param callback The function to call when the event was fired
  * @returns an {@link Amity.Unsubscriber} function to stop listening
@@ -10880,7 +10983,7 @@ const onUserFlagCleared = (callback) => createUserEventSubscriber('user.flagClea
  * })
  * ```
  *
- * Fired when a {@link Amity.User} has been fetched
+ * Fired when a {@link Amity.InternalUser} has been fetched
  *
  * @param callback The function to call when the event was fired
  * @returns an {@link Amity.Unsubscriber} function to stop listening
@@ -10924,7 +11027,7 @@ const getUser$1 = async (userId) => {
     const { users } = data;
     fireEvent('user.fetched', data);
     return {
-        data: users.find(user => user.userId === userId),
+        data: LinkedObject.user(users.find(user => user.userId === userId)),
         cachedAt,
     };
 };
@@ -10961,7 +11064,7 @@ getUser$1.locally = (userId) => {
  * });
  * ```
  *
- * Observe all mutation on a given {@link Amity.User}
+ * Observe all mutation on a given {@link Amity.InternalUser}
  *
  * @param userId the ID of the user to observe
  * @param callback the function to call when new data are available
@@ -10987,11 +11090,11 @@ const getUser = (userId, callback) => {
  * const { data: users, prevPage, nextPage } = await queryUsers({ displayName: 'foo' })
  * ```
  *
- * Queries a paginable list of {@link Amity.User} objects
+ * Queries a paginable list of {@link Amity.InternalUser} objects
  * Search is performed by displayName such as `.startsWith(search)`
  *
  * @param query The query parameters
- * @returns A page of {@link Amity.User} objects
+ * @returns A page of {@link Amity.InternalUser} objects
  *
  * @category User API
  * @async
@@ -11022,7 +11125,7 @@ const queryUsers = async (query = {}) => {
     fireEvent('user.fetched', data);
     const prevPage = toPage(paging.previous);
     const nextPage = toPage(paging.next);
-    return { data: users, cachedAt, prevPage, nextPage };
+    return { data: users.map(user => LinkedObject.user(user)), cachedAt, prevPage, nextPage };
 };
 /**
  * ```js
@@ -11030,11 +11133,11 @@ const queryUsers = async (query = {}) => {
  * const { data: users } = queryUsers.locally({ keyword: 'foo' })
  * ```
  *
- * Queries a paginable list of {@link Amity.User} objects from cache
+ * Queries a paginable list of {@link Amity.InternalUser} objects from cache
  * Search is performed by displayName such as `.startsWith(search)`
  *
  * @param query The query parameters
- * @returns A page of {@link Amity.User} objects
+ * @returns A page of {@link Amity.InternalUser} objects
  *
  * @category User API
  */
@@ -11118,7 +11221,7 @@ const getUsers = (params, callback, config) => {
         const users = (_a = data.data
             .map(userId => pullFromCache(['user', 'get', userId]))
             .filter(Boolean)
-            .map(({ data }) => data)) !== null && _a !== void 0 ? _a : [];
+            .map(({ data }) => LinkedObject.user(data))) !== null && _a !== void 0 ? _a : [];
         callback({
             onNextPage: onFetch,
             /*
@@ -11181,7 +11284,7 @@ const getUsers = (params, callback, config) => {
  * @param callback the function to call when new data are available
  * @returns An {@link Amity.Unsubscriber} function to run when willing to stop observing the user
  *
- * Observe all mutation on a given {@link Amity.User}
+ * Observe all mutation on a given {@link Amity.InternalUser}
  * @category User Observer
  */
 const observeUser = (userId, callback) => {
@@ -11194,11 +11297,12 @@ const observeUser = (userId, callback) => {
         // filter function
         if (((_a = result.data) === null || _a === void 0 ? void 0 : _a.userId) !== userId)
             return;
+        const newResult = Object.assign(Object.assign({}, result), { data: LinkedObject.user(result.data) });
         if (callback instanceof Function)
-            return callback(result);
+            return callback(newResult);
         if (action !== 'onFetch')
-            (_b = callback.onEvent) === null || _b === void 0 ? void 0 : _b.call(callback, action, result);
-        (_c = callback[action]) === null || _c === void 0 ? void 0 : _c.call(callback, result);
+            (_b = callback.onEvent) === null || _b === void 0 ? void 0 : _b.call(callback, action, newResult);
+        (_c = callback[action]) === null || _c === void 0 ? void 0 : _c.call(callback, newResult);
     };
     const disposers = [];
     disposers.push(onUserUpdated(data => router({ data, loading: false, origin: 'event' }, 'onUpdate')), onUserDeleted(data => router({ data, loading: false, origin: 'event' }, 'onDelete')), onUserFlagged(data => router({ data, loading: false, origin: 'event' }, 'onFlagged')), onUserUnflagged(data => router({ data, loading: false, origin: 'event' }, 'onUnflagged')), onUserFlagCleared(data => router({ data, loading: false, origin: 'event' }, 'onFlagCleared')));
@@ -11220,7 +11324,7 @@ const observeUser = (userId, callback) => {
  * const unsub = UserRepository.searchUserByDisplayName({}, response => merge(users, response.data))
  * ```
  *
- * Observe all mutations on a list of {@link Amity.User}s
+ * Observe all mutations on a list of {@link Amity.InternalUser}s
  *
  * @param params for searching users
  * @param callback the function to call when new data are available
@@ -11921,35 +12025,6 @@ getPost$1.locally = (postId) => {
     };
 };
 
-const commentLinkedObject = (comment) => {
-    return Object.assign(Object.assign({}, comment), { get target() {
-            const commentTypes = {
-                type: comment.targetType,
-            };
-            if (comment.targetType === 'user') {
-                return Object.assign(Object.assign({}, commentTypes), { userId: comment.targetId });
-            }
-            if (commentTypes.type === 'content') {
-                return Object.assign(Object.assign({}, commentTypes), { contentId: comment.targetId });
-            }
-            if (commentTypes.type === 'community') {
-                const cacheData = pullFromCache([
-                    'communityUsers',
-                    'get',
-                    `${comment.targetId}#${comment.userId}`,
-                ]);
-                return Object.assign(Object.assign({}, commentTypes), { communityId: comment.targetId, creatorMember: cacheData === null || cacheData === void 0 ? void 0 : cacheData.data });
-            }
-            return {
-                type: 'unknown',
-            };
-        } });
-};
-
-const LinkedObject = {
-    comment: commentLinkedObject,
-};
-
 /**
  * ```js
  * import { CommentRepository } from '@amityco/ts-sdk'
@@ -13616,10 +13691,10 @@ const markAsDelivered = async (subChannelId, messageId) => {
  * })
  * ```
  *
- * Queries a paginable list of read {@link Amity.User} by messageId
+ * Queries a paginable list of read {@link Amity.InternalUser} by messageId
  *
  * @param query The query parameters
- * @returns A page of {@link Amity.User} objects
+ * @returns A page of {@link Amity.InternalUser} objects
  *
  * @category Message API
  * @async
@@ -13661,10 +13736,10 @@ const getReadUsers = async (query) => {
  * })
  * ```
  *
- * Queries a paginable list of read {@link Amity.User} objects from cache
+ * Queries a paginable list of read {@link Amity.InternalUser} objects from cache
  *
  * @param query The query parameters
- * @returns A page of {@link Amity.User} objects
+ * @returns A page of {@link Amity.InternalUser} objects
  *
  * @category Message API
  */
@@ -13697,10 +13772,10 @@ getReadUsers.locally = (query) => {
  * })
  * ```
  *
- * Queries a paginable list of delivered {@link Amity.User} by messageId
+ * Queries a paginable list of delivered {@link Amity.InternalUser} by messageId
  *
  * @param query The query parameters
- * @returns A page of {@link Amity.User} objects
+ * @returns A page of {@link Amity.InternalUser} objects
  *
  * @category Message API
  * @async
@@ -13741,10 +13816,10 @@ const getDeliveredUsers = async (query) => {
  * })
  * ```
  *
- * Queries a paginable list of delivered {@link Amity.User} objects from cache
+ * Queries a paginable list of delivered {@link Amity.InternalUser} objects from cache
  *
  * @param query The query parameters
- * @returns A page of {@link Amity.User} objects
+ * @returns A page of {@link Amity.InternalUser} objects
  *
  * @category Message API
  */
@@ -16037,12 +16112,12 @@ const getRecommendedCommunities = (params, callback, config) => {
  * const updated = await CommunityRepository.moderation.addRoles(communityId, ['foo', 'bar'])
  * ```
  *
- * Adds a list of {@link Amity.Role} to a list of {@link Amity.User} on a {@link Amity.Community}
+ * Adds a list of {@link Amity.Role} to a list of {@link Amity.InternalUser} on a {@link Amity.Community}
  *
  * @param communityId The ID of the {@link Amity.Community} to perform
  * @param roleIds Array of IDs of the {@link Amity.Role} to apply
- * @param userIds Array of IDs of the {@link Amity.User} to perform
- * @returns A success boolean if the {@link Amity.Role} were added to list of {@link Amity.User} in the {@link Amity.Community}
+ * @param userIds Array of IDs of the {@link Amity.InternalUser} to perform
+ * @returns A success boolean if the {@link Amity.Role} were added to list of {@link Amity.InternalUser} in the {@link Amity.Community}
  *
  * @category Community API
  * @async
@@ -16069,12 +16144,12 @@ const addRoles = async (communityId, roleIds, userIds) => {
  * const updated = await CommunityRepository.moderation.removeRoles(communityId, ['foo', 'bar'])
  * ```
  *
- * Removes a list of {@link Amity.Role} from a list of {@link Amity.User} on a {@link Amity.Community}
+ * Removes a list of {@link Amity.Role} from a list of {@link Amity.InternalUser} on a {@link Amity.Community}
  *
  * @param communityId The ID of the {@link Amity.Community} to perform
  * @param roleIds Array of IDs of the {@link Amity.Role} to apply
- * @param userIds Array of IDs of the {@link Amity.User} to perform
- * @returns A success boolean if the {@link Amity.Role} were removed from list of {@link Amity.User} in the {@link Amity.Community}
+ * @param userIds Array of IDs of the {@link Amity.InternalUser} to perform
+ * @returns A success boolean if the {@link Amity.Role} were removed from list of {@link Amity.InternalUser} in the {@link Amity.Community}
  *
  * @category Community API
  * @async
@@ -16103,7 +16178,7 @@ const removeRoles = async (communityId, roleIds, userIds) => {
  * ```
  *
  * @param communityId of {@link Amity.Community} from which the users should be banned
- * @param userIds of the {@link Amity.User}'s to be banned
+ * @param userIds of the {@link Amity.InternalUser}'s to be banned
  * @returns the updated {@link Amity.Membership}'s object
  *
  * @category Community API
@@ -16138,7 +16213,7 @@ const banMembers = async (communityId, userIds) => {
  * ```
  *
  * @param communityId of {@link Amity.Community} from which the users should be unbanned
- * @param userIds of the {@link Amity.User}'s to be unbanned
+ * @param userIds of the {@link Amity.InternalUser}'s to be unbanned
  * @returns the updated {@link Amity.Membership}'s object
  *
  * @category Community API
@@ -16179,11 +16254,11 @@ var index$9 = /*#__PURE__*/Object.freeze({
  * const updated = await CommunityRepository.moderation.addMembers(communityId, ['foo', 'bar'])
  * ```
  *
- * Adds a list of {@link Amity.User} to a {@link Amity.Community} to add users to
+ * Adds a list of {@link Amity.InternalUser} to a {@link Amity.Community} to add users to
  *
  * @param communityId The ID of the {@link Amity.Community} to perform
- * @param userIds The list of IDs {@link Amity.User} to add
- * @returns A success boolean if the {@link Amity.User} were added to the {@link Amity.Community}
+ * @param userIds The list of IDs {@link Amity.InternalUser} to add
+ * @returns A success boolean if the {@link Amity.InternalUser} were added to the {@link Amity.Community}
  *
  * @category Community API
  * @async
@@ -16210,11 +16285,11 @@ const addMembers = async (communityId, userIds) => {
  * const updated = await CommunityRepository.moderation.removeMembers(communityId, ['foo', 'bar'])
  * ```
  *
- * Removes a list of {@link Amity.User} from a {@link Amity.Community}
+ * Removes a list of {@link Amity.InternalUser} from a {@link Amity.Community}
  *
  * @param communityId The ID of the {@link Amity.Community} to edit
- * @param userIds The list of IDs {@link Amity.User} to remove
- * @returns A success boolean if the list of {@link Amity.User} were removed from the {@link Amity.Community}
+ * @param userIds The list of IDs {@link Amity.InternalUser} to remove
+ * @returns A success boolean if the list of {@link Amity.InternalUser} were removed from the {@link Amity.Community}
  *
  * @category Community API
  * @async
@@ -16499,7 +16574,7 @@ const getCategory = async (categoryId) => {
         ingestInCache(data, { cachedAt });
     const { categories } = data;
     return {
-        data: categories.find(category => category.categoryId === categoryId),
+        data: categoryLinkedObject(categories.find(category => category.categoryId === categoryId)),
         cachedAt,
     };
 };
@@ -16568,7 +16643,12 @@ const queryCategories = async (query) => {
     }
     const nextPage = toPage(paging.next);
     const prevPage = toPage(paging.previous);
-    return { data: categories, cachedAt, prevPage, nextPage };
+    return {
+        data: categories.map(category => LinkedObject.category(category)),
+        cachedAt,
+        prevPage,
+        nextPage,
+    };
 };
 /**
  * ```js
@@ -16641,7 +16721,7 @@ const getCategories = (params, callback, config) => {
         let categories = (_a = data.data
             .map(categoryId => pullFromCache(['category', 'get', categoryId]))
             .filter(Boolean)
-            .map(({ data }) => data)) !== null && _a !== void 0 ? _a : [];
+            .map(({ data }) => LinkedObject.category(data))) !== null && _a !== void 0 ? _a : [];
         if (!params.includeDeleted) {
             categories = filterByPropEquality(categories, 'isDeleted', false);
         }
@@ -19447,7 +19527,7 @@ const getPlayer = async (parameters) => {
         hls.loadSource(url);
     }
     else {
-        const recording = recordings[0];
+        const recording = recordings.find(rec => !!rec.mp4);
         if (!recording || !recording.mp4) {
             throw new Error('No playable recording available');
         }