@amityco/ts-sdk-react-native 7.26.1-c29647b8.0 → 7.27.0

package/dist/index.cjs.js

@@ -343,10 +343,17 @@ exports.NotificationRolesFilterTypeEnum = void 0;
     NotificationRolesFilterTypeEnum["ONLY"] = "only";
 })(exports.NotificationRolesFilterTypeEnum || (exports.NotificationRolesFilterTypeEnum = {}));
 
+exports.AmityLiveViewerCountMode = void 0;
+(function (AmityLiveViewerCountMode) {
+    AmityLiveViewerCountMode["ALWAYS_SHOW"] = "always";
+    AmityLiveViewerCountMode["HIDE_ENTIRELY"] = "hidden";
+    AmityLiveViewerCountMode["SHOW_ABOVE_MINIMUM"] = "above-minimum";
+})(exports.AmityLiveViewerCountMode || (exports.AmityLiveViewerCountMode = {}));
+
 function getVersion() {
     try {
-        // the string ''v7.26.0-cjs'' should be replaced by actual value by @rollup/plugin-replace
-        return 'v7.26.0-cjs';
+        // the string ''v7.27.0-cjs'' should be replaced by actual value by @rollup/plugin-replace
+        return 'v7.27.0-cjs';
     }
     catch (error) {
         return '__dev__';
@@ -399,7 +406,13 @@ const normalize = (source) => Object.keys(source)
  * @category Cache
  * @hidden
  */
-const encodeKey = (key) => JSON.stringify(key, (_, val) => (typeof val === 'object' ? normalize(val) : val));
+const encodeKey = (key) => JSON.stringify(key, (_, val) => 
+// `typeof null` is `'object'`, so a nullish segment would reach normalize()
+// and throw on Object.keys(null) — taking down whichever cache read built
+// the key. Amity.Serializable does not admit null in the first place, so a
+// null here is a payload that broke its own contract: encode it as null and
+// let the miss be a miss.
+val !== null && typeof val === 'object' ? normalize(val) : val);
 /**
  * Decodes a string back into a {@link Amity.CacheKey}
 
@@ -1966,8 +1979,7 @@ const API_REGIONS = {
 };
 const URLS = {
     http: 'https://apix.{region}.amity.co',
-    // upload: 'https://upload.{region}.amity.co',
-    upload: 'https://apix.{region}.amity.co',
+    upload: 'https://upload.{region}.amity.co',
     mqtt: 'wss://sse.{region}.amity.co:443/mqtt',
 };
 function computeUrl(type, region) {
@@ -2491,10 +2503,11 @@ var MqttError;
     MqttError[MqttError["BAD_USERNAME_OR_PASSWORD"] = 134] = "BAD_USERNAME_OR_PASSWORD";
     MqttError[MqttError["NOT_AUTHORIZED"] = 135] = "NOT_AUTHORIZED";
 })(MqttError || (MqttError = {}));
-// MQTT 5 session expiry, in seconds. 0xFFFFFFFF keeps the session alive
-// indefinitely, matching the previous 3.1.1 `clean: false` behaviour where the
-// broker retained the session (and its subscriptions) across disconnects.
-const SESSION_EXPIRY_INTERVAL = 0xffffffff;
+// MQTT 5 session expiry, in seconds. Under MQTT 3.1.1 the broker capped
+// retained sessions at ~30 min; under MQTT 5 the client's value wins, so an
+// unbounded value ("never") left disconnected sessions piling up on the broker.
+// 1800s matches the previous 3.1.1 cap.
+const SESSION_EXPIRY_INTERVAL = 1800;
 function getMqttOptions(params) {
     return Object.assign({ clean: false, clientId: `mqttjs_ + ${Math.random().toString(16).substring(2, 10)}`, protocolId: 'MQTT', protocolVersion: 5, reconnectPeriod: RETRY_BASE_TIMEOUT, resubscribe: true, 
         // The broker/LB drops idle sockets at ~60s. mqtt.js v5 sends its first
@@ -2611,8 +2624,16 @@ const createMqttTransport = (endpoint) => {
     }
     return {
         connect,
-        async disconnect() {
+        async disconnect(options) {
             if (this.connected) {
+                // On logout we want the broker to release the session immediately
+                // instead of keeping it around for SESSION_EXPIRY_INTERVAL. mqtt.js
+                // only sends a DISCONNECT packet when `force` is false; force=true
+                // just tears the socket down and the broker keeps the session until
+                // it expires on its own.
+                if (options === null || options === void 0 ? void 0 : options.endSession) {
+                    return new Promise(resolve => mqttClient === null || mqttClient === void 0 ? void 0 : mqttClient.end(false, { reasonCode: 0, properties: { sessionExpiryInterval: 0 } }, () => resolve()));
+                }
                 return new Promise(resolve => mqttClient === null || mqttClient === void 0 ? void 0 : mqttClient.end(true, undefined, () => resolve()));
             }
         },
@@ -5092,6 +5113,51 @@ const getCoreUserSettings = async () => {
     return data;
 };
 
+const DEFAULT_CONFIG = {
+    mode: exports.AmityLiveViewerCountMode.ALWAYS_SHOW,
+    threshold: 50,
+};
+const isValidMode = (value) => value === exports.AmityLiveViewerCountMode.ALWAYS_SHOW ||
+    value === exports.AmityLiveViewerCountMode.HIDE_ENTIRELY ||
+    value === exports.AmityLiveViewerCountMode.SHOW_ABOVE_MINIMUM;
+const isValidThreshold = (value) => typeof value === 'number' && Number.isInteger(value) && value >= 1 && value <= 1000;
+/**
+ * ```js
+ * import { getLiveViewerCountConfig } from '@amityco/ts-sdk'
+ * const config = await getLiveViewerCountConfig()
+ * ```
+ *
+ * Fetches the network-level {@link Amity.LiveViewerCountConfig} governing
+ * how the live viewer count is displayed to viewers on a livestream.
+ *
+ * Cold-read — no observable, no cache. Call once per livestream mount /
+ * rejoin. Admin-driven config changes take effect on the next join, not
+ * mid-stream.
+ *
+ * On a malformed payload (unknown mode, out-of-range or missing threshold)
+ * the SDK falls open to `{ mode: ALWAYS_SHOW, threshold: 50 }` and logs a
+ * warning. Network errors reject.
+ *
+ * @returns A Promise of {@link Amity.LiveViewerCountConfig}
+ *
+ * @category Client API
+ * @async
+ */
+/* begin_public_function id: client.getLiveViewerCountConfig */
+const getLiveViewerCountConfig = async () => {
+    var _a, _b;
+    const client = getActiveClient();
+    const { data } = await client.http.get('/api/v3/network-settings/video-streaming');
+    const mode = (_a = data === null || data === void 0 ? void 0 : data.videoStreaming) === null || _a === void 0 ? void 0 : _a.viewerCountDisplayMode;
+    const threshold = (_b = data === null || data === void 0 ? void 0 : data.videoStreaming) === null || _b === void 0 ? void 0 : _b.viewerCountDisplayMinimum;
+    if (!isValidMode(mode) || !isValidThreshold(threshold)) {
+        client.log('client/getLiveViewerCountConfig', 'malformed videoStreaming settings, falling back to default', { mode, threshold });
+        return DEFAULT_CONFIG;
+    }
+    return { mode, threshold };
+};
+/* end_public_function */
+
 /* begin_public_function
   id: client.getProductCatalogueSetting
 */
@@ -5458,7 +5524,7 @@ const logout = async () => {
     const client = getActiveClient();
     client.log('client/api/disconnectClient');
     if (client.mqtt && client.mqtt.connected) {
-        client.mqtt.disconnect();
+        await client.mqtt.disconnect({ endSession: true });
     }
     /*
      * for cases when session state is terminated (example on ban) or token expired,
@@ -5479,6 +5545,7 @@ const logout = async () => {
     client.userId = undefined;
     client.token = undefined;
     client.loginType = undefined;
+    client.isGloballyBanned = false;
     client.http.defaults.headers.common.Authorization = '';
     client.http.defaults.metadata = {
         tokenExpiry: '',
@@ -7774,19 +7841,21 @@ const renewal = () => {
 
 const validateAccessToken = async ({ token, userId }) => {
     const client = getActiveClient();
-    // Validate token using sessions API
-    await client.http.get('/api/v3/sessions', {
-        headers: {
-            Authorization: `Bearer ${token.accessToken}`,
-        },
-    });
-    // Get user details
-    const { data: { users }, } = await client.http.get(`/api/v3/users/${userId}`, {
+    // Verify the token and hydrate the caller in a single call.
+    const { data } = await client.http.get('/api/v4/sessions', {
         headers: {
             Authorization: `Bearer ${token.accessToken}`,
         },
     });
-    const user = users.find((u) => u.userId === userId);
+    const { users, files, userType } = data;
+    const [user] = users;
+    if (userId && (user === null || user === void 0 ? void 0 : user.userId) && userId !== user.userId) {
+        client.log('client/api/validateAccessToken', {
+            message: 'session userId does not match the token userId; using the server value',
+            tokenUserId: userId,
+            sessionUserId: user.userId,
+        });
+    }
     client.http.defaults.headers.common.Authorization = `Bearer ${token.accessToken}`;
     client.http.defaults.metadata = {
         tokenExpiry: token.expiresAt,
@@ -7800,6 +7869,8 @@ const validateAccessToken = async ({ token, userId }) => {
         isUserDeleted: false,
     };
     client.token = token;
+    ingestInCache(prepareUserPayload({ users, files }));
+    setCurrentUserType(userType);
     return user;
 };
 
@@ -7882,14 +7953,6 @@ const loginWithAccessToken = async (accessToken) => {
             setSessionState("notLoggedIn" /* Amity.SessionStates.NOT_LOGGED_IN */);
             throw new ASCError(`User ${userId} has not been found`, 800000 /* Amity.ClientError.UNKNOWN_ERROR */, "error" /* Amity.ErrorLevel.ERROR */);
         }
-        if (user.isDeleted) {
-            setSessionState("notLoggedIn" /* Amity.SessionStates.NOT_LOGGED_IN */);
-            throw new ASCError(`User ${userId} has been deleted`, 800000 /* Amity.ClientError.UNKNOWN_ERROR */, "error" /* Amity.ErrorLevel.ERROR */);
-        }
-        if (user.isGlobalBanned) {
-            setSessionState("notLoggedIn" /* Amity.SessionStates.NOT_LOGGED_IN */);
-            throw new ASCError(`User ${userId} is globally banned`, 800000 /* Amity.ClientError.UNKNOWN_ERROR */, "error" /* Amity.ErrorLevel.ERROR */);
-        }
         // Set userId and login method flag
         client.userId = user.userId;
         // Set login method flag to 'accessToken' in platform-specific login session
@@ -7903,8 +7966,10 @@ const loginWithAccessToken = async (accessToken) => {
     catch (error) {
         // If error occurs, revert session state to not logged in
         setSessionState("notLoggedIn" /* Amity.SessionStates.NOT_LOGGED_IN */);
-        // Re-throw if it's already an ASCError
         if (error instanceof ASCError) {
+            if (error.code === 400312 /* Amity.ServerError.GLOBAL_BAN */) {
+                client.isGloballyBanned = true;
+            }
             throw error;
         }
         // Wrap other errors
@@ -7972,11 +8037,18 @@ const renewWithAccessToken = async (accessToken) => {
         await loginWithAccessToken(accessToken);
     }
     else {
-        // about to expire
-        await validateAccessToken({
-            token: tokenObject,
-            userId,
-        });
+        try {
+            await validateAccessToken({
+                token: tokenObject,
+                userId,
+            });
+        }
+        catch (error) {
+            if (error instanceof ASCError && error.code === 400312 /* Amity.ServerError.GLOBAL_BAN */) {
+                client.isGloballyBanned = true;
+            }
+            throw error;
+        }
     }
 };
 /* end_public_function */
@@ -7993,6 +8065,9 @@ const renewTokenWithHandler = async ({ useScheduledTask = false, }) => {
     if (!client.userId || !client.accessTokenHandler) {
         return;
     }
+    if (client.isGloballyBanned) {
+        return;
+    }
     try {
         const newToken = await client.accessTokenHandler.onTokenRenew(client.userId);
         if (useScheduledTask) {
@@ -8591,6 +8666,7 @@ const createClient = (apiKey, apiRegion = API_REGIONS.SG, { debugSession = DEFAU
         getCoreUserSettings,
         getSocialSettings,
         getChatSettings,
+        getLiveViewerCountConfig,
         getVisitorDeviceId: getDeviceId,
         getMessagePreviewSetting: getMessagePreviewSetting$1,
         onRTEConnectionStateChange,
@@ -8730,21 +8806,13 @@ const resumeSession = async (params, sessionHandler, config) => {
         if (user == null) {
             throw new ASCError(`${params.userId} has not been found`, 800000 /* Amity.ClientError.UNKNOWN_ERROR */, "error" /* Amity.ErrorLevel.ERROR */);
         }
-        if (user.isDeleted) {
-            terminateClient("userDeleted" /* Amity.TokenTerminationReason.USER_DELETED */);
-            return false;
-        }
-        if (user.isGlobalBanned) {
-            terminateClient("globalBan" /* Amity.TokenTerminationReason.GLOBAL_BAN */);
-            return false;
-        }
         client.userId = user.userId;
         client.sessionHandler = sessionHandler;
         /*
          * Cannot push to subscriptions as watcher needs to continue working even if
          * token expires
          */
-        unsubWatcher = client.accessTokenExpiryWatcher(sessionHandler);
+        unsubWatcher = client.accessTokenExpiryWatcher();
         setActiveUser(user);
     }
     catch (error) {
@@ -9730,6 +9798,7 @@ var index$s = /*#__PURE__*/Object.freeze({
     setCurrentUserType: setCurrentUserType,
     setAccessTokenHandler: setAccessTokenHandler,
     getChatSettings: getChatSettings,
+    getLiveViewerCountConfig: getLiveViewerCountConfig,
     getCoreUserSettings: getCoreUserSettings,
     notifications: notifications,
     enableAutoSubscriptions: enableAutoSubscriptions,
@@ -12646,7 +12715,7 @@ const getWatchSessionStorage = () => {
     return storageInstance;
 };
 
-const privateKey = "-----BEGIN PRIVATE KEY-----\nMIIEvwIBADANBgkqhkiG9w0BAQEFAASCBKkwggSlAgEAAoIBAQDAARz+hmBgi8pJ\nQb8LeY41gtHhk+ACMwRfhsn7GqpqRQNG2qU0755mzZuVDUqjQMGSo8THJB7O+OJs\nflbZRkFXlFoFOVNw1UpNOgwEQZ6wB9oRwzepTJAfF1sVhm/o/ixvXh1zDFNDy6yZ\npXyiiJHUVxqyjllZhxnwdvjoVtDs6hW6awG09bB9nh/TTejlUKXoAgzqVwu/1QMu\nUVViET495elEe19aUarEy+oL2iKeXCEvqda/pWNBdbieFyJvvZ08HN8dPuT88wq2\njZLEAth1vrwQ2IAa4ktaLcBQdLJgIkrbDvAiVZ8lQAjS/bq5vXQikTGvoPlC5bbn\nvuOM/3eLAgMBAAECggEAVZ+peHAghq2QVj71nX5lxsNCKaCyYwixSJBpfouTt7Rz\nE6PpzMOXFi1W1o+I22jDakuSM2SOQKqI/u0QefB0r0O/KVk5NrZHXk0mkrdYtxOp\nUgaGyf8UvmjB+8VqHrNKyZdk9qtmbnNj01kTTcAtmE4H39zPR7eR/8Rul94vaZbs\nwCnKJS3mLT3JxyGug6lxanveKkjG+CKC1nJQYWaxCJxaFSzbwXQPvDhB+TvrIbee\npd5v4EAyEJohpr+T9oDGGJkb/KARBZCtwLyB976PKJwwBA8MRVL1i5QwawuMiMq5\nUtnOnbGKtCeFzaLbNU0Qi8bqyims84EQxC6DOu1fkQKBgQDdvsoBsEhsOXV7hlIJ\naEd0eSJZVkdqimxH8uGoMM2FeNaOrcB6yBXqTSP0R3OIyf8eaY6yjRvP30ZNXcll\n/gD3O1Mu6YmWQdt1W2WA6pKOsUuPXasf0pdOF7IiFZKlSabz5YHXFqwVuqm8loaj\nsXel3YWqPVdHiankE7tz+3ssnQKBgQDdqi4TNdD1MdEpihx19jr0QjUiXW3939FK\nqp30HESPEGDGQzXdmJgif9HhZb+cJSuWaHEbjgBrYahvgCF+y6LbEpOD+D/dmT+s\nDEAQaR84sah6dokwPjV8fjBSrcVFjCS+doxv0d3p/9OUEeyUhFrY03nxtIEYkLIE\n/Zvn37b4RwKBgQCLENVFe9XfsaVhQ5r9dV2iyTlmh7qgMZG5CbTFs12hQGhm8McO\n+Z7s41YSJCFr/yq1WwP4LJDtrBw99vyQr1zRsG35tNLp3gGRNzGQSQyC2uQFVHw2\np+7mNewsfhUK/gbrXNsyFnDz6635rPlhfbII3sWuP2wWXFqkxE9CbMwR7QKBgQC6\nawDMzxmo2/iYArrkyevSuEuPVxvFwpF1RgAI6C0QVCnPE38dmdN4UB7mfHekje4W\nVEercMURidPp0cxZolCYBQtilUjAyL0vqC3In1/Ogjq6oy3FEMxSop1pKxMY5j+Q\nnoqFD+6deLUrddeNH7J3X4LSr4dSbX4JjG+tlgt+yQKBgQCuwTL4hA6KqeInQ0Ta\n9VQX5Qr8hFlqJz1gpymi/k63tW/Ob8yedbg3WWNWyShwRMFYyY9S81ITFWM95uL6\nvF3x9rmRjwElJw9PMwVu6dmf/CO0Z1wzXSp2VVD12gbrUD/0/d7MUoJ9LgC8X8f/\nn0txLHYGHbx+nf95+JUg6lV3hg==\n-----END PRIVATE KEY-----";
+const privateKey = "-----BEGIN PRIVATE KEY-----\nMIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQDHo80SecH7FuF2\nhFYnb+l26/VN8UMLXAQFLnxciNTEwkGVFMpdezlH8rU2HtUJL4RETogbAOLVY0XM\njs6sPn8G1nALmh9qeDpUtVqFOVtBHxEZ910TLOtQiunjqJKO5nWdqZ71EC3OFluR\niGQkO84BiIFbv37ub7xl3S8XarbtKoLcyVpkDHi+1wx1pgCAn6gtBUgckPL5NR8j\nLseabl3HAXQfhTCKo4tmOFM2Dxwl1IUMmIJrJg/aIU/U0tj/1Eoo7mG0JcNWX19l\nW3EecCbi0ncCJOrkUdwlBrcjaMayaX/ubEwyUeTGiLdyc4L3GRLHjyK8xgVNXRMH\nbZWJ2a5NAgMBAAECggEASxuE+35zTFO/XydKgmvIGcWL9FbgMlXb7Vcf0nBoG945\nbiz0NVc2paraIhJXc608xbYF3qLmtAE1MVBI0ORyRdBHNxY024l/6H6SH60Ed+uI\nM4ysp5ourY6Vj+DLwpdRiI9YDjqYAQDIUmhNxJP7XPhOMoZI6st+xZQBM34ic/bv\nAMSJm9OZphSp3+qXVkFZztr2mxD2EZSJJLYxi8BCdgM2qhazalbcJ6zDKHCZWVWm\n8RRxDGldyMb/237JxETzP40tAlzOZDmBAbUgEnurDJ93RVDIE3rbZUshwgeQd18a\nem096mWgvB1AIKYgsTAR3pw+V19YWAjq/glP6fz8wQKBgQD/oQq+ukKF0PRgBeM5\ngeTjSwsdGppQLmf5ndujvoiz/TpdjDEPu6R8kigQr1rG2t4K/yfdZoI8RdmJD1al\n3Q7N9hofooSy4rj6E3txzWZCHJjHad2cnCp/O26HiReGAl7wTcfTmNdiFHhZQzm5\nJBkvWAiwuvQMNfEbnXxw6/vIDwKBgQDH7fX8gsc77JLvAWgp1MaQN/sbqVb6JeT1\nFQfR8E/WFCSmzQBtNzd5KgYuCeelwr/8DyYytvN2BzCYZXp73gI1jF3YlW5jVn74\nOY6TwQ095digwo6Z0yuxopdIOApKgAkL9PRKgNrqAf3NAyMua6lOGifzjDojC3KU\nfylQmxMn4wKBgHp2B9O/H0dEBw5JQ8W0+JX6yWQz7mEjGiR2/1W+XXb8hQ1zr709\nw1r6Gb+EghRpnZ3fBpYGGbYOMFx8wKHM+N6qW3F0ReX8v2juFGE8aRSa5oYBrWzt\nU16Idjbv8hj84cZ1PJmdyvDtpYn9rpWHOZl4rxEbPvbqkIsOMyNVqdT5AoGAOSge\nmwIIU2le2FVeohbibXiToWTYKMuMmURZ5/r72AgKMmWJKbAPe+Q3wBG01/7FRBpQ\noU8Ma0HC8s6QJbliiEyIx9JwrJWd1vkdecBHONrtA4ibm/5zD2WcOllLF+FitLhi\n3qnX6+6F0IaFGFBPJrTzlv0P4dTz/OAdv52V7GECgYEA2TttOKBAqWllgOaZOkql\nLVMJVmgR7s6tLi1+cEP8ZcapV9aRbRzTAKXm4f8AEhtlG9F9kCOvHYCYGi6JaiWJ\nZkHjeex3T+eE6Di6y5Bm/Ift5jtVhJ4jCVwHOKTMej79NPUFTJfv8hCo29haBDv6\nRXFrv+T21KCcw8k3sJeJWWQ=\n-----END PRIVATE KEY-----";
 /*
  * The crypto algorithm used for importing key and signing string
  */
@@ -13074,6 +13143,21 @@ const productTagLinkedObject = (productTag) => {
     return Object.assign(Object.assign({}, productTag), { product: internalProduct ? productLinkedObject(internalProduct) : undefined });
 };
 
+const fileLinkedObject = (file) => {
+    var _a, _b, _c;
+    if (!file)
+        return file;
+    if (file.type === 'video') {
+        const video = (_b = (_a = file.attributes) === null || _a === void 0 ? void 0 : _a.metadata) === null || _b === void 0 ? void 0 : _b.video;
+        return Object.assign(Object.assign({}, file), { getWidth: () => { var _a; return (_a = video === null || video === void 0 ? void 0 : video.width) !== null && _a !== void 0 ? _a : 0; }, getHeight: () => { var _a; return (_a = video === null || video === void 0 ? void 0 : video.height) !== null && _a !== void 0 ? _a : 0; }, getRotation: () => { var _a; return (_a = video === null || video === void 0 ? void 0 : video.rotation) !== null && _a !== void 0 ? _a : 0; } });
+    }
+    if (file.type === 'image') {
+        const metadata = (_c = file.attributes) === null || _c === void 0 ? void 0 : _c.metadata;
+        return Object.assign(Object.assign({}, file), { getWidth: () => { var _a; return (_a = metadata === null || metadata === void 0 ? void 0 : metadata.width) !== null && _a !== void 0 ? _a : 0; }, getHeight: () => { var _a; return (_a = metadata === null || metadata === void 0 ? void 0 : metadata.height) !== null && _a !== void 0 ? _a : 0; } });
+    }
+    return file;
+};
+
 const postLinkedObject = (post) => {
     return shallowClone(post, {
         childrenPosts: post.children
@@ -13112,85 +13196,99 @@ const postLinkedObject = (post) => {
                 .filter(Boolean) || []);
         },
         get creator() {
+            // The id is checked for a value, not just for presence: a payload can
+            // carry the field as null, and a null segment in a cache key throws while
+            // being encoded rather than simply missing the cache.
+            if (!post.postedUserId)
+                return undefined;
             const cacheData = pullFromCache(['user', 'get', post.postedUserId]);
             if (!(cacheData === null || cacheData === void 0 ? void 0 : cacheData.data))
-                return;
+                return undefined;
             return userLinkedObject(cacheData.data);
         },
         get targetCommunity() {
             var _a;
+            if (!post.targetId)
+                return undefined;
             const communityCache = (_a = pullFromCache([
                 'community',
                 'get',
                 post.targetId,
             ])) === null || _a === void 0 ? void 0 : _a.data;
             if (!communityCache)
-                return;
+                return undefined;
             return communityLinkedObject(communityCache);
         },
         getImageInfo() {
             var _a, _b;
-            return isAmityImagePost(post)
-                ? (_b = pullFromCache(['file', 'get', (_a = post === null || post === void 0 ? void 0 : post.data) === null || _a === void 0 ? void 0 : _a.fileId])) === null || _b === void 0 ? void 0 : _b.data
-                : undefined;
+            if (!isAmityImagePost(post) || !((_a = post.data) === null || _a === void 0 ? void 0 : _a.fileId))
+                return undefined;
+            return fileLinkedObject((_b = pullFromCache(['file', 'get', post.data.fileId])) === null || _b === void 0 ? void 0 : _b.data);
         },
         getVideoInfo() {
             var _a, _b, _c;
-            return isAmityVideoPost(post)
-                ? (_c = pullFromCache(['file', 'get', (_b = (_a = post === null || post === void 0 ? void 0 : post.data) === null || _a === void 0 ? void 0 : _a.videoFileId) === null || _b === void 0 ? void 0 : _b.original])) === null || _c === void 0 ? void 0 : _c.data
-                : undefined;
+            const originalFileId = isAmityVideoPost(post) ? (_b = (_a = post.data) === null || _a === void 0 ? void 0 : _a.videoFileId) === null || _b === void 0 ? void 0 : _b.original : undefined;
+            if (!originalFileId)
+                return undefined;
+            return fileLinkedObject((_c = pullFromCache(['file', 'get', originalFileId])) === null || _c === void 0 ? void 0 : _c.data);
         },
         getVideoThumbnailInfo() {
             var _a, _b;
-            return isAmityVideoPost(post)
-                ? (_b = pullFromCache(['file', 'get', (_a = post === null || post === void 0 ? void 0 : post.data) === null || _a === void 0 ? void 0 : _a.thumbnailFileId])) === null || _b === void 0 ? void 0 : _b.data
-                : undefined;
+            // `isAmityVideoPost` proves the field is *present* — it tests
+            // `'thumbnailFileId' in post.data` — and presence is not a value. The
+            // server sends the field as null until it has finished transcoding the
+            // video, so a just-published post reaches here with a null id and used to
+            // build the cache key ['file', 'get', null].
+            const thumbnailFileId = isAmityVideoPost(post) ? (_a = post.data) === null || _a === void 0 ? void 0 : _a.thumbnailFileId : undefined;
+            if (!thumbnailFileId)
+                return undefined;
+            return fileLinkedObject((_b = pullFromCache(['file', 'get', thumbnailFileId])) === null || _b === void 0 ? void 0 : _b.data);
         },
         getFileInfo() {
             var _a, _b;
-            return isAmityFilePost(post)
-                ? (_b = pullFromCache(['file', 'get', (_a = post === null || post === void 0 ? void 0 : post.data) === null || _a === void 0 ? void 0 : _a.fileId])) === null || _b === void 0 ? void 0 : _b.data
-                : undefined;
+            if (!isAmityFilePost(post) || !((_a = post.data) === null || _a === void 0 ? void 0 : _a.fileId))
+                return undefined;
+            return (_b = pullFromCache(['file', 'get', post.data.fileId])) === null || _b === void 0 ? void 0 : _b.data;
         },
         getLivestreamInfo() {
             var _a, _b;
-            if (!isAmityLivestreamPost(post))
-                return;
+            if (!isAmityLivestreamPost(post) || !((_a = post.data) === null || _a === void 0 ? void 0 : _a.streamId))
+                return undefined;
             const cache = (_b = pullFromCache([
                 'stream',
                 'get',
-                (_a = post === null || post === void 0 ? void 0 : post.data) === null || _a === void 0 ? void 0 : _a.streamId,
+                post.data.streamId,
             ])) === null || _b === void 0 ? void 0 : _b.data;
             if (!cache)
-                return;
+                return undefined;
             return streamLinkedObject(cache);
         },
         getPollInfo() {
             var _a, _b;
-            if (!isAmityPollPost(post))
-                return;
-            const cache = (_b = pullFromCache(['poll', 'get', (_a = post === null || post === void 0 ? void 0 : post.data) === null || _a === void 0 ? void 0 : _a.pollId])) === null || _b === void 0 ? void 0 : _b.data;
+            if (!isAmityPollPost(post) || !((_a = post.data) === null || _a === void 0 ? void 0 : _a.pollId))
+                return undefined;
+            const cache = (_b = pullFromCache(['poll', 'get', post.data.pollId])) === null || _b === void 0 ? void 0 : _b.data;
             if (!cache)
-                return;
+                return undefined;
             return pollLinkedObject(cache);
         },
         getClipInfo() {
             var _a, _b;
-            return isAmityClipPost(post)
-                ? (_b = pullFromCache(['file', 'get', (_a = post === null || post === void 0 ? void 0 : post.data) === null || _a === void 0 ? void 0 : _a.fileId])) === null || _b === void 0 ? void 0 : _b.data
-                : undefined;
+            if (!isAmityClipPost(post) || !((_a = post.data) === null || _a === void 0 ? void 0 : _a.fileId))
+                return undefined;
+            return (_b = pullFromCache(['file', 'get', post.data.fileId])) === null || _b === void 0 ? void 0 : _b.data;
         },
         getAudioInfo() {
             var _a, _b;
-            return isAmityAudioPost(post)
-                ? (_b = pullFromCache(['file', 'get', (_a = post === null || post === void 0 ? void 0 : post.data) === null || _a === void 0 ? void 0 : _a.fileId])) === null || _b === void 0 ? void 0 : _b.data
-                : undefined;
+            if (!isAmityAudioPost(post) || !((_a = post.data) === null || _a === void 0 ? void 0 : _a.fileId))
+                return undefined;
+            return (_b = pullFromCache(['file', 'get', post.data.fileId])) === null || _b === void 0 ? void 0 : _b.data;
         },
         getRoomInfo() {
             var _a, _b;
-            if (!isAmityRoomPost(post))
-                return;
-            const room = (_b = pullFromCache(['room', 'get', (_a = post === null || post === void 0 ? void 0 : post.data) === null || _a === void 0 ? void 0 : _a.roomId])) === null || _b === void 0 ? void 0 : _b.data;
+            if (!isAmityRoomPost(post) || !((_a = post.data) === null || _a === void 0 ? void 0 : _a.roomId))
+                return undefined;
+            const room = (_b = pullFromCache(['room', 'get', post.data.roomId])) === null || _b === void 0 ? void 0 : _b.data;
             return room ? roomLinkedObject(room) : undefined;
         },
         getEventInfo() {
@@ -14134,6 +14232,7 @@ const eventLinkedObject = (event) => {
 };
 
 const LinkedObject = {
+    file: fileLinkedObject,
     ad: adLinkedObject,
     comment: commentLinkedObject,
     post: postLinkedObject,
@@ -15297,10 +15396,58 @@ class SearchUserLiveCollectionController extends LiveCollectionController {
     }
 }
 
+/* begin_public_function
+  id: user.searchUsers
+*/
+/**
+ * ```js
+ * import { UserRepository } from '@amityco/ts-sdk'
+ *
+ * let users = []
+ * const unsub = UserRepository.searchUsers(
+ *   { displayName: 'jack', searchBy: [SearchUsersByEnum.DISPLAY_NAME] },
+ *   response => merge(users, response.data),
+ * )
+ * ```
+ *
+ * Observe all mutations on a list of {@link Amity.InternalUser}s.
+ *
+ * Pass `searchBy` in `params` to restrict which user fields are matched
+ * (e.g. `[SearchUsersByEnum.DISPLAY_NAME]`). When omitted, the backend
+ * default (both `displayName` and `userId`) applies.
+ *
+ * @param params for searching users
+ * @param callback the function to call when new data are available
+ * @param config the configuration for the live collection
+ * @returns An {@link Amity.Unsubscriber} function to run when willing to stop observing the users
+ *
+ * @category Category Live Collection
+ */
+const searchUsers = (params, callback, config) => {
+    const { log, cache } = getActiveClient();
+    if (!cache) {
+        // eslint-disable-next-line no-console
+        console.log(ENABLE_CACHE_MESSAGE);
+    }
+    const timestamp = Date.now();
+    log(`liveSearchUsers(tmpid: ${timestamp}) > listen`);
+    const searchUsersLiveCollection = new SearchUserLiveCollectionController(params, callback);
+    const disposers = searchUsersLiveCollection.startSubscription();
+    const cacheKey = searchUsersLiveCollection.getCacheKey();
+    disposers.push(() => dropFromCache(cacheKey));
+    return () => {
+        log(`liveSearchUsers(tmpid: ${timestamp}) > dispose`);
+        disposers.forEach(fn => fn());
+    };
+};
+/* end_public_function */
+
 /* begin_public_function
   id: user.search
 */
 /**
+ * @deprecated Use {@link searchUsers} instead. `searchUserByDisplayName` will be removed in a future major version.
+ *
  * ```js
  * import { UserRepository } from '@amityco/ts-sdk-react-native'
  *
@@ -15449,6 +15596,7 @@ var index$q = /*#__PURE__*/Object.freeze({
     getUsers: getUsers,
     getBlockedUsers: getBlockedUsers,
     getBlockingUsers: getBlockingUsers,
+    searchUsers: searchUsers,
     searchUserByDisplayName: searchUserByDisplayName,
     getReachedUsers: getReachedUsers,
     get AmityUserSearchMatchType () { return AmityUserSearchMatchType; }
@@ -15481,7 +15629,7 @@ const getFile = async (fileId) => {
     if (client.cache)
         ingestInCache({ files: [data] }, { cachedAt });
     return {
-        data,
+        data: fileLinkedObject(data),
         cachedAt,
     };
 };
@@ -15508,7 +15656,7 @@ getFile.locally = (fileId) => {
     if (!cached)
         return;
     return {
-        data: cached.data,
+        data: fileLinkedObject(cached.data),
         cachedAt: cached.cachedAt,
     };
 };
@@ -15645,7 +15793,7 @@ const uploadVideo = async (formData, feedType, onProgress) => {
     if (client.cache)
         ingestInCache({ files: data }, { cachedAt });
     return {
-        data,
+        data: data.map(file => fileLinkedObject(file)),
         cachedAt,
     };
 };
@@ -15706,7 +15854,7 @@ const uploadImage = async (formData, onProgress, altText) => {
     if (client.cache)
         ingestInCache({ files: data }, { cachedAt });
     return {
-        data,
+        data: data.map(file => fileLinkedObject(file)),
         cachedAt,
     };
 };