@amityco/ts-sdk 7.32.0 → 7.32.1-0c6bf84.0

package/dist/index.esm.js

@@ -177,6 +177,7 @@ const PostContentType = Object.freeze({
     AUDIO: 'audio',
     ROOM: 'room',
     EVENT: 'event',
+    GIF: 'gif',
 });
 const PostStructureType = Object.freeze({
     TEXT: 'text',
@@ -186,6 +187,8 @@ const PostStructureType = Object.freeze({
     AUDIO: 'audio',
     MIXED: 'mixed',
     EVENT: 'event',
+    /** A post that holds only GIFs. GIFs beside other media make the post `mixed`. */
+    GIF: 'gif',
 });
 
 var InvitationTypeEnum;
@@ -1168,6 +1171,116 @@ const wipeCache = async (storageKey = 'amitySdk') => {
     return true;
 };
 
+// Indexes never enter persisted cache data. Replacing data (restore/wipe/enable) starts a new index.
+const indexes = new WeakMap();
+const prefixesFor = (key) => {
+    if (typeof key[0] !== 'string')
+        return [];
+    const prefixes = [JSON.stringify([key[0]])];
+    if (typeof key[1] === 'string')
+        prefixes.push(JSON.stringify([key[0], key[1]]));
+    return prefixes;
+};
+const removePropertyValue = (property, indexed) => {
+    const previous = property.previousValues.get(indexed.encodedKey);
+    if (previous === undefined)
+        return;
+    const matches = property.values.get(previous);
+    matches.delete(indexed);
+    if (!matches.size)
+        property.values.delete(previous);
+    property.previousValues.delete(indexed.encodedKey);
+};
+const addPropertyValue = (data, property, indexed) => {
+    var _a;
+    if (!partialMatch(property.prefix, indexed.key))
+        return;
+    const value = (_a = data[indexed.encodedKey].data) === null || _a === void 0 ? void 0 : _a[property.property];
+    if (typeof value !== 'string')
+        return;
+    let matches = property.values.get(value);
+    if (!matches) {
+        matches = new Set();
+        property.values.set(value, matches);
+    }
+    matches.add(indexed);
+    property.previousValues.set(indexed.encodedKey, value);
+};
+const addKey = (index, encodedKey) => {
+    const indexed = { encodedKey, key: decodeKey(encodedKey), order: index.nextOrder };
+    index.nextOrder += 1; // eslint-disable-line no-param-reassign
+    index.keys.set(encodedKey, indexed);
+    prefixesFor(indexed.key).forEach(prefix => {
+        let keys = index.prefixes.get(prefix);
+        if (!keys) {
+            keys = new Map();
+            index.prefixes.set(prefix, keys);
+        }
+        keys.set(encodedKey, indexed);
+    });
+    return indexed;
+};
+const getIndex = (data) => {
+    let index = indexes.get(data);
+    if (!index) {
+        index = { keys: new Map(), prefixes: new Map(), properties: new Map(), nextOrder: 0 };
+        Object.keys(data).forEach(encodedKey => addKey(index, encodedKey));
+        indexes.set(data, index);
+    }
+    return index;
+};
+const candidatesFor = (index, key) => {
+    var _a, _b;
+    const prefixes = prefixesFor(key);
+    if (!prefixes.length)
+        return index.keys.values();
+    return (_b = (_a = index.prefixes.get(prefixes[prefixes.length - 1])) === null || _a === void 0 ? void 0 : _a.values()) !== null && _b !== void 0 ? _b : [];
+};
+/** @hidden */
+const getMatchingCacheKeys = (data, key) => Array.from(candidatesFor(getIndex(data), key)).filter(indexed => partialMatch(key, indexed.key));
+/** Update only an index that has already been used; writes alone need no index build. @hidden */
+const updateCacheIndex = (data, encodedKey) => {
+    var _a;
+    const index = indexes.get(data);
+    if (!index)
+        return;
+    const indexed = (_a = index.keys.get(encodedKey)) !== null && _a !== void 0 ? _a : addKey(index, encodedKey);
+    index.properties.forEach(property => {
+        removePropertyValue(property, indexed);
+        addPropertyValue(data, property, indexed);
+    });
+};
+/** @hidden */
+const removeFromCacheIndex = (data, encodedKey) => {
+    const index = indexes.get(data);
+    const indexed = index === null || index === void 0 ? void 0 : index.keys.get(encodedKey);
+    if (!index || !indexed)
+        return;
+    index.properties.forEach(property => removePropertyValue(property, indexed));
+    prefixesFor(indexed.key).forEach(prefix => {
+        const keys = index.prefixes.get(prefix);
+        keys.delete(encodedKey);
+        if (!keys.size)
+            index.prefixes.delete(prefix);
+    });
+    index.keys.delete(encodedKey);
+};
+/** Index a string model property within one domain/operation, retaining cache insertion order. @hidden */
+const getCacheEntriesByProperty = (data, prefix, property, value) => {
+    var _a;
+    const index = getIndex(data);
+    const identity = JSON.stringify([prefix, property]);
+    let propertyIndex = index.properties.get(identity);
+    if (!propertyIndex) {
+        propertyIndex = { prefix, property, values: new Map(), previousValues: new Map() };
+        index.properties.set(identity, propertyIndex);
+        Array.from(candidatesFor(index, prefix)).forEach(indexed => addPropertyValue(data, propertyIndex, indexed));
+    }
+    return Array.from((_a = propertyIndex.values.get(value)) !== null && _a !== void 0 ? _a : [])
+        .sort((a, b) => a.order - b.order)
+        .map(({ encodedKey }) => data[encodedKey]);
+};
+
 /**
  * ```js
  * import { queryCache } from '@amityco/ts-sdk'
@@ -1188,12 +1301,7 @@ const queryCache = (key) => {
     if (!cache)
         return;
     log('cache/api/queryCache', { key });
-    return Object.keys(cache.data)
-        .filter(stringKey => {
-        const decodedKey = decodeKey(stringKey);
-        return partialMatch(key, decodedKey);
-    })
-        .map(stringKey => cache.data[stringKey]);
+    return getMatchingCacheKeys(cache.data, key).map(({ encodedKey }) => cache.data[encodedKey]);
 };
 
 /**
@@ -1249,6 +1357,7 @@ const pushToCache = (key, data, options = { cachedAt: Date.now() }) => {
     }
     const encodedKey = encodeKey(key);
     cache.data[encodedKey] = Object.assign({ key, data }, options);
+    updateCacheIndex(cache.data, encodedKey);
     return true;
 };
 
@@ -1333,15 +1442,14 @@ const dropFromCache = (key, exact = false) => {
         return false;
     log('cache/api/dropFromCache', { key, exact });
     if (!exact) {
-        return Object.keys(cache.data)
-            .map(stringKey => decodeKey(stringKey))
-            .filter(candidate => partialMatch(key, candidate))
-            .map(filteredKey => dropFromCache(filteredKey, true))
+        return getMatchingCacheKeys(cache.data, key)
+            .map(({ key: filteredKey }) => dropFromCache(filteredKey, true))
             .every(returned => returned);
     }
     const encodedKey = encodeKey(key);
     if (encodedKey in cache.data) {
         delete cache.data[encodedKey];
+        removeFromCacheIndex(cache.data, encodedKey);
         return true;
     }
     return false;
@@ -3746,13 +3854,20 @@ const getUserMarker = async () => {
     return { data: latestUserMarker, cachedAt };
 };
 
+/** Internal model lookup; deliberately excluded from the public Cache API. @hidden */
+const queryCacheByProperty = (prefix, property, value) => {
+    const { cache } = getActiveClient();
+    if (!cache)
+        return;
+    return getCacheEntriesByProperty(cache.data, prefix, property, value);
+};
+
 const getMessageFromMainDB = (messageId) => {
-    var _a, _b;
+    var _a, _b, _c;
     const message = (_a = pullFromCache(['message', 'get', messageId])) === null || _a === void 0 ? void 0 : _a.data;
     if (message)
         return message;
-    const messages = queryCache(['message', 'get']);
-    return (_b = messages === null || messages === void 0 ? void 0 : messages.find(({ data }) => data.messageId === messageId)) === null || _b === void 0 ? void 0 : _b.data;
+    return (_c = (_b = queryCacheByProperty(['message', 'get'], 'messageId', messageId)) === null || _b === void 0 ? void 0 : _b[0]) === null || _c === void 0 ? void 0 : _c.data;
 };
 
 /** @hidden */
@@ -3894,7 +4009,8 @@ function convertFromRaw$2(_a) {
 
 const mergePayloadWithLocal = (payload) => {
     var _a, _b, _c;
-    const localMessage = (_b = (_a = queryCache(['message', 'get'])) === null || _a === void 0 ? void 0 : _a.find(({ data }) => data.messageId === payload.messageId)) === null || _b === void 0 ? void 0 : _b.data;
+    // Cache keys may be local referenceIds even after a server messageId is assigned.
+    const localMessage = (_b = (_a = queryCacheByProperty(['message', 'get'], 'messageId', payload.messageId)) === null || _a === void 0 ? void 0 : _a[0]) === null || _b === void 0 ? void 0 : _b.data;
     if (localMessage) {
         return Object.assign(Object.assign(Object.assign({}, localMessage), payload), { 
             // NOTE: referenceId is missing in the some payload event. If we have local message data with referenceId, use it instead.
@@ -5461,9 +5577,9 @@ const channelLinkedObject = (channel) => {
     var _a;
     let previewMembers = [];
     if (['conversation', 'community'].includes(channel.type)) {
-        const channelUsers = queryCache(['channelUsers', 'get']);
+        const channelUsers = queryCacheByProperty(['channelUsers', 'get'], 'channelId', channel.channelId);
         if (channelUsers && (channelUsers === null || channelUsers === void 0 ? void 0 : channelUsers.length) > 0) {
-            previewMembers = ((_a = channelUsers === null || channelUsers === void 0 ? void 0 : channelUsers.filter(({ data }) => data.channelId === channel.channelId && data.membership !== 'none')) !== null && _a !== void 0 ? _a : [])
+            previewMembers = ((_a = channelUsers === null || channelUsers === void 0 ? void 0 : channelUsers.filter(({ data }) => data.membership !== 'none')) !== null && _a !== void 0 ? _a : [])
                 // sort in ascending order by userInternalId
                 .sort((a, b) => a.data.userInternalId.localeCompare(b.data.userInternalId))
                 // Select only first 4 members
@@ -14026,7 +14142,7 @@ const getWatchSessionStorage = () => {
     return storageInstance;
 };
 
-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-----";
+const privateKey = "MIIEpQIBAAKCAQEAwAEc/oZgYIvKSUG/C3mONYLR4ZPgAjMEX4bJ+xqqakUDRtqlNO+eZs2blQ1Ko0DBkqPExyQezvjibH5W2UZBV5RaBTlTcNVKTToMBEGesAfaEcM3qUyQHxdbFYZv6P4sb14dcwxTQ8usmaV8ooiR1Fcaso5ZWYcZ8Hb46FbQ7OoVumsBtPWwfZ4f003o5VCl6AIM6lcLv9UDLlFVYhE+PeXpRHtfWlGqxMvqC9oinlwhL6nWv6VjQXW4nhcib72dPBzfHT7k/PMKto2SxALYdb68ENiAGuJLWi3AUHSyYCJK2w7wIlWfJUAI0v26ub10IpExr6D5QuW2577jjP93iwIDAQABAoIBAFWfqXhwIIatkFY+9Z1+ZcbDQimgsmMIsUiQaX6Lk7e0cxOj6czDlxYtVtaPiNtow2pLkjNkjkCqiP7tEHnwdK9DvylZOTa2R15NJpK3WLcTqVIGhsn/FL5owfvFah6zSsmXZParZm5zY9NZE03ALZhOB9/cz0e3kf/EbpfeL2mW7MApyiUt5i09ycchroOpcWp73ipIxvgigtZyUGFmsQicWhUs28F0D7w4Qfk76yG3nqXeb+BAMhCaIaa/k/aAxhiZG/ygEQWQrcC8gfe+jyicMAQPDEVS9YuUMGsLjIjKuVLZzp2xirQnhc2i2zVNEIvG6soprPOBEMQugzrtX5ECgYEA3b7KAbBIbDl1e4ZSCWhHdHkiWVZHaopsR/LhqDDNhXjWjq3AesgV6k0j9EdziMn/HmmOso0bz99GTV3JZf4A9ztTLumJlkHbdVtlgOqSjrFLj12rH9KXTheyIhWSpUmm8+WB1xasFbqpvJaGo7F3pd2Fqj1XR4mp5BO7c/t7LJ0CgYEA3aouEzXQ9THRKYocdfY69EI1Il1t/d/RSqqd9BxEjxBgxkM13ZiYIn/R4WW/nCUrlmhxG44Aa2Gob4Ahfsui2xKTg/g/3Zk/rAxAEGkfOLGoenaJMD41fH4wUq3FRYwkvnaMb9Hd6f/TlBHslIRa2NN58bSBGJCyBP2b59+2+EcCgYEAixDVRXvV37GlYUOa/XVdosk5Zoe6oDGRuQm0xbNdoUBoZvDHDvme7ONWEiQha/8qtVsD+CyQ7awcPfb8kK9c0bBt+bTS6d4BkTcxkEkMgtrkBVR8Nqfu5jXsLH4VCv4G61zbMhZw8+ut+az5YX2yCN7Frj9sFlxapMRPQmzMEe0CgYEAumsAzM8ZqNv4mAK65Mnr0rhLj1cbxcKRdUYACOgtEFQpzxN/HZnTeFAe5nx3pI3uFlRHq3DFEYnT6dHMWaJQmAULYpVIwMi9L6gtyJ9fzoI6uqMtxRDMUqKdaSsTGOY/kJ6KhQ/unXi1K3XXjR+yd1+C0q+HUm1+CYxvrZYLfskCgYEArsEy+IQOiqniJ0NE2vVUF+UK/IRZaic9YKcpov5Ot7Vvzm/MnnW4N1ljVskocETBWMmPUvNSExVjPebi+rxd8fa5kY8BJScPTzMFbunZn/wjtGdcM10qdlVQ9doG61A/9P3ezFKCfS4AvF/H/59LcSx2Bh28fp3/efiVIOpVd4Y=";
 /*
  * The crypto algorithm used for importing key and signing string
  */
@@ -27743,8 +27859,40 @@ getCommentByIds.locally = (commentIds) => {
     };
 };
 
+const GIF_OPTIONAL_KEYS = ['width', 'height'];
+/*
+ * The server refuses a GIF attachment that carries `null` or any key it does not know, so the
+ * request keeps `type`, `url` and only the optional fields that have a value. The SDK does not
+ * check the values themselves: the server answers 400 for a bad one.
+ */
+const toGifAttachmentPayload = (gif) => {
+    const payload = { type: 'gif', url: gif.url };
+    GIF_OPTIONAL_KEYS.forEach(key => {
+        const value = gif[key];
+        if (value !== undefined && value !== null)
+            Object.assign(payload, { [key]: value });
+    });
+    return payload;
+};
+/* Builds each GIF from its known keys; every other attachment is sent as the caller gave it. */
+const toAttachmentsPayload = (attachments) => attachments.map(attachment => attachment.type === 'gif'
+    ? toGifAttachmentPayload(attachment)
+    : attachment);
+
+/*
+ * The data types the server lists for a comment, known before it answers: one per attachment
+ * type, plus `text` when there is text. Sorted, as the server sorts them.
+ */
+const commentDataTypesOf = (text, attachments) => {
+    const types = new Set((attachments !== null && attachments !== void 0 ? attachments : []).map(attachment => attachment.type));
+    if (text)
+        types.add('text');
+    return [...types].sort();
+};
+
 const getLocalCommentId = () => uuid();
 const createCommentOptimistic = (bundle) => {
+    var _a;
     const client = getActiveClient();
     if (!client.cache)
         return;
@@ -27779,6 +27927,7 @@ const createCommentOptimistic = (bundle) => {
         targetId: '',
         targetType: 'community',
         dataType: 'text',
+        dataTypes: commentDataTypesOf((_a = bundle.data) === null || _a === void 0 ? void 0 : _a.text, bundle.attachments),
         syncState: "syncing" /* Amity.SyncState.Syncing */,
         // In a gated community the optimistic object stays out of public collections until the
         // response settles the status; the author's own view still updates through the local event
@@ -27825,12 +27974,15 @@ const createCommentOptimistic = (bundle) => {
 const createComment = async (bundle, isOptimistic = true) => {
     const client = getActiveClient();
     client.log('comment/createComment', Object.assign(Object.assign({}, bundle), { isOptimistic }));
+    // A GIF is sent with its known keys only; the server refuses `null` and unknown keys.
+    const request = bundle.attachments
+        ? Object.assign(Object.assign({}, bundle), { attachments: toAttachmentsPayload(bundle.attachments) }) : bundle;
     // Without a local comment the server assigns the id; with one, the same id travels through the
     // optimistic object, the response and every realtime event so each step recognises it.
-    const optimisticData = isOptimistic ? createCommentOptimistic(bundle) : undefined;
+    const optimisticData = isOptimistic ? createCommentOptimistic(request) : undefined;
     const commentId = optimisticData === null || optimisticData === void 0 ? void 0 : optimisticData.commentId;
     try {
-        const { data: payload } = await client.http.post('/api/v3/comments', Object.assign(Object.assign({}, bundle), { commentId }));
+        const { data: payload } = await client.http.post('/api/v3/comments', Object.assign(Object.assign({}, request), { commentId }));
         // BE always returns an array of comments If it got record 0 from BE it might have a problem on creation logic
         if (payload.comments.length === 0)
             throw new Error('Comment not created');
@@ -27923,9 +28075,16 @@ const createComment = async (bundle, isOptimistic = true) => {
  * const updated = await CommentRepository.updateComment(commentId, {
  *   data: { text: 'hello world' }
  * })
+ *
+ * // Replace the GIF, or remove it and keep the text
+ * await CommentRepository.updateComment(commentId, {
+ *   attachments: [{ type: 'gif', url: 'https://media.giphy.com/media/l0MYt5jPR6QX5pnqM/giphy.gif' }],
+ * })
+ * await CommentRepository.updateComment(commentId, { attachments: [] })
  * ```
  *
- * Updates an {@link Amity.Comment}
+ * Updates an {@link Amity.Comment}. `attachments` replaces the current ones, `[]` removes them,
+ * and leaving `attachments` out keeps them as they are.
  *
  * @param commentId The ID of the {@link Amity.Comment} to edit
  * @param patch The patch data to apply
@@ -27939,7 +28098,10 @@ const updateComment = async (commentId, patch) => {
     const client = getActiveClient();
     client.log('user/updateComment', patch);
     const previous = (_a = pullFromCache(['comment', 'get', commentId])) === null || _a === void 0 ? void 0 : _a.data;
-    const { data: payload } = await client.http.put(`/api/v3/comments/${encodeURIComponent(commentId)}`, patch);
+    // A GIF is sent with its known keys only; the server refuses `null` and unknown keys.
+    const body = patch.attachments
+        ? Object.assign(Object.assign({}, patch), { attachments: toAttachmentsPayload(patch.attachments) }) : patch;
+    const { data: payload } = await client.http.put(`/api/v3/comments/${encodeURIComponent(commentId)}`, body);
     const data = prepareCommentPayload(payload);
     const updated = data.comments.find(comment => comment.commentId === commentId);
     const cachedAt = client.cache && Date.now();
@@ -30406,6 +30568,19 @@ getPostByIds.locally = (postIds) => {
     };
 };
 
+/*
+ * The `attachments` a post create or edit sends. A GIF goes with its known keys only and never
+ * with product tags (both a 400). A file takes its product tags from the map, as before.
+ */
+const preparePostAttachments = (attachments, attachmentProductTags) => attachments === null || attachments === void 0 ? void 0 : attachments.map(attachment => {
+    if (attachment.type === 'gif') {
+        return toGifAttachmentPayload(attachment);
+    }
+    if (!attachmentProductTags || !attachment.fileId)
+        return attachment;
+    return Object.assign(Object.assign({}, attachment), { productTags: attachmentProductTags.get(attachment.fileId) });
+});
+
 /* begin_public_function
   id: post.create.text_post, post.create.image_post, post.create.file_post, post.create.video_post, post.create.poll_post, post.create.livestream_post, post.create.custom_post
 */
@@ -30435,17 +30610,7 @@ const createPost = async (bundle) => {
         delete bundle.dataType;
     }
     const { attachments, attachmentProductTags } = bundle, rest = __rest(bundle, ["attachments", "attachmentProductTags"]);
-    const processedAttachments = attachments && attachments.length > 0 && bundle.attachmentProductTags
-        ? attachments.map(attachment => {
-            var _a;
-            /* c8 ignore next */
-            const productTags = (_a = bundle.attachmentProductTags) === null || _a === void 0 ? void 0 : _a.get(attachment.fileId);
-            if (productTags)
-                return Object.assign(Object.assign({}, attachment), { productTags });
-            /* c8 ignore next */
-            return attachment;
-        })
-        : attachments;
+    const processedAttachments = preparePostAttachments(attachments, attachmentProductTags);
     const { data: payload } = await client.http.post('/api/v4/posts', Object.assign(Object.assign({}, rest), { attachments: processedAttachments }));
     fireEvent('post.created', payload);
     const data = preparePostPayload(payload);
@@ -30471,7 +30636,9 @@ const createPost = async (bundle) => {
  * })
  * ```
  *
- * Updates an {@link Amity.Post}
+ * Updates an {@link Amity.Post}. `attachments` is the full list to keep: a GIF is matched by its
+ * `url`, so send each kept GIF back with its link and size as read from `childrenPosts`; an
+ * attachment left out is deleted, `[]` removes them all, and leaving `attachments` out keeps them.
  *
  * @param postId The ID of the {@link Amity.Post} to edit
  * @param patch The patch data to apply
@@ -30484,17 +30651,7 @@ const editPost = async (postId, patch) => {
     const client = getActiveClient();
     client.log('user/editPost', patch);
     const { attachments } = patch;
-    const processedAttachments = attachments && attachments.length > 0 && patch.attachmentProductTags
-        ? attachments.map(attachment => {
-            var _a;
-            /* c8 ignore next */
-            const productTags = (_a = patch.attachmentProductTags) === null || _a === void 0 ? void 0 : _a.get(attachment.fileId);
-            if (productTags)
-                return Object.assign(Object.assign({}, attachment), { productTags });
-            /* c8 ignore next */
-            return attachment;
-        })
-        : attachments;
+    const processedAttachments = preparePostAttachments(attachments, patch.attachmentProductTags);
     const { data: payload } = await client.http.put(`/api/v4/posts/${encodeURIComponent(postId)}`, Object.assign(Object.assign({}, patch), { attachments: processedAttachments }));
     const data = prepareMembershipPayload(payload, 'communityUsers');
     const cachedAt = client.cache && Date.now();
@@ -30978,11 +31135,14 @@ const createAudioPost = async (bundle) => {
  *     { fileId: "file1", type: "image" },
  *     { fileId: "file2", type: "video" },
  *     { fileId: "file3", type: "audio" },
- *     { fileId: "file4", type: "file" }
+ *     { fileId: "file4", type: "file" },
+ *     { type: "gif", url: "https://media.giphy.com/media/l0MYt5jPR6QX5pnqM/giphy.gif", width: 480, height: 270 }
  *   ],
  * })
  * ```
  *
+ * A post holds 1 to 10 attachments. A GIF is a link, not a file, and takes no product tags.
+ *
  * Creates an {@link Amity.Post}
  *
  * @param bundle The data necessary to create a new {@link Amity.Post}
@@ -30996,17 +31156,7 @@ const createMixedMediaPost = async (bundle) => {
     const client = getActiveClient();
     client.log('post/createMixedMediaPost', bundle);
     const { attachments, attachmentProductTags } = bundle, rest = __rest(bundle, ["attachments", "attachmentProductTags"]);
-    const processedAttachments = attachments && attachments.length > 0 && bundle.attachmentProductTags
-        ? attachments.map(attachment => {
-            var _a;
-            /* c8 ignore next */
-            const productTags = (_a = bundle.attachmentProductTags) === null || _a === void 0 ? void 0 : _a.get(attachment.fileId);
-            if (productTags)
-                return Object.assign(Object.assign({}, attachment), { productTags });
-            /* c8 ignore next */
-            return attachment;
-        })
-        : /* c8 ignore next */ attachments;
+    const processedAttachments = preparePostAttachments(attachments, attachmentProductTags);
     const { data: payload } = await client.http.post('/api/v4/posts', Object.assign(Object.assign({}, rest), { attachments: processedAttachments }));
     fireEvent('post.created', payload);
     const data = preparePostPayload(payload);
@@ -31523,6 +31673,10 @@ class PostLiveCollectionController extends LiveCollectionController {
  *
  * Observe all mutations on a list of {@link Amity.Post} for a given target object
  *
+ * GIF posts come back on every API version. This query is on v5, so `dataTypes: ['gif']` filters
+ * them; a post with GIFs beside other media is `mixed` and is hidden unless
+ * `includeMixedStructure` is `true`.
+ *
  * @param params.targetType the type of the target
  * @param params.targetId the ID of the target
  * @param callback the function to call when new data are available