@amityco/ts-sdk 7.10.0 → 7.10.1-0ab8f3fc.0

package/dist/messagePreview/utils/getSubChannelMessagePreviewWithUser.d.ts

@@ -3,7 +3,7 @@ export declare const getSubChannelMessagePreviewWithUser: (subChannel: Amity.Sub
         user: Amity.InternalUser | undefined;
         messagePreviewId: string;
         subChannelName: string;
-        data?: string | Record<string, unknown> | Amity.ContentDataText | Amity.ContentDataFile | Amity.ContentDataImage | Amity.ContentDataVideo | Amity.ContentDataPoll | Amity.ContentDataStream | Amity.ContentDataClip | undefined;
+        data?: string | Record<string, unknown> | Amity.ContentDataText | Amity.ContentDataFile | Amity.ContentDataImage | Amity.ContentDataVideo | Amity.ContentDataAudio | Amity.ContentDataPoll | Amity.ContentDataStream | Amity.ContentDataClip | undefined;
         dataType?: any;
         channelId: string;
         subChannelId: string;

package/dist/postRepository/api/createAudioPost.d.ts

@@ -0,0 +1,30 @@
+/**
+ * ```js
+ * import { PostRepository } from '@amityco/ts-sdk'
+ * const created = await PostRepository.createAudioPost({
+ *   targetType: 'user',
+ *   targetId: 'foobar',
+ *   data: { text: 'Audio Post', title: 'Audio Post Title' },
+ *   attachments: [{ type: 'audio', fileId: 'fileId123'}]
+ * }))
+ * ```
+ *
+ * Creates an {@link Amity.Post}
+ *
+ * @param bundle The data necessary to create a new {@link Amity.Post}
+ * @returns The newly created {@link Amity.Post}
+ *
+ * @category Post API
+ * @async
+ */
+export declare const createAudioPost: (bundle: Pick<Amity.Post, 'targetType' | 'targetId'> & Partial<Pick<Amity.Post, 'metadata' | 'mentionees' | 'tags' | 'hashtags'>> & {
+    data?: {
+        text?: string;
+        title?: string;
+    };
+    attachments: {
+        type: Extract<Amity.MixedMediaPostContentType, 'audio'>;
+        fileId: Amity.File['fileId'];
+    }[];
+}) => Promise<Amity.Cached<Amity.Post>>;
+//# sourceMappingURL=createAudioPost.d.ts.map

package/dist/postRepository/api/createAudioPost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAudioPost.d.ts","sourceRoot":"","sources":["../../../src/postRepository/api/createAudioPost.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,eAAe,WAClB,KAAK,MAAM,IAAI,EAAE,YAAY,GAAG,UAAU,CAAC,GACjD,QAAQ,KAAK,MAAM,IAAI,EAAE,UAAU,GAAG,YAAY,GAAG,MAAM,GAAG,UAAU,CAAC,CAAC,GAAG;IAC3E,IAAI,CAAC,EAAE;QACL,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,MAAM,yBAAyB,EAAE,OAAO,CAAC,CAAC;QACxD,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;KAC9B,EAAE,CAAC;CACL,KACF,QAAQ,MAAM,MAAM,CAAC,MAAM,IAAI,CAAC,CAkBlC,CAAC"}

package/dist/postRepository/api/createMixedMediaPost.d.ts

@@ -0,0 +1,35 @@
+/**
+ * ```js
+ * import { PostRepository } from '@amityco/ts-sdk'
+ * const { data } = await PostRepository.createMixedMediaPost({
+ *   targetType: 'community',
+ *   targetId: 'community123',
+ *   data: { text: 'Check out my mixed media post!', title: 'Mixed Media Post' },
+ *   attachments: [
+ *     { fileId: "file1", type: "image" },
+ *     { fileId: "file2", type: "video" },
+ *     { fileId: "file3", type: "audio" },
+ *     { fileId: "file4", type: "file" }
+ *   ],
+ * })
+ * ```
+ *
+ * Creates an {@link Amity.Post}
+ *
+ * @param bundle The data necessary to create a new {@link Amity.Post}
+ * @returns The newly created {@link Amity.Post}
+ *
+ * @category Post API
+ * @async
+ */
+export declare const createMixedMediaPost: (bundle: Pick<Amity.Post, 'targetType' | 'targetId'> & Partial<Pick<Amity.Post, 'metadata' | 'mentionees' | 'tags' | 'hashtags'>> & {
+    data?: {
+        text?: string;
+        title?: string;
+    };
+    attachments: {
+        type: Amity.MixedMediaPostContentType;
+        fileId: Amity.File['fileId'];
+    }[];
+}) => Promise<Amity.Cached<Amity.Post>>;
+//# sourceMappingURL=createMixedMediaPost.d.ts.map

package/dist/postRepository/api/createMixedMediaPost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createMixedMediaPost.d.ts","sourceRoot":"","sources":["../../../src/postRepository/api/createMixedMediaPost.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,oBAAoB,WACvB,KAAK,MAAM,IAAI,EAAE,YAAY,GAAG,UAAU,CAAC,GACjD,QAAQ,KAAK,MAAM,IAAI,EAAE,UAAU,GAAG,YAAY,GAAG,MAAM,GAAG,UAAU,CAAC,CAAC,GAAG;IAC3E,IAAI,CAAC,EAAE;QACL,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;QAAC,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAA;KAAE,EAAE,CAAC;CACxF,KACF,QAAQ,MAAM,MAAM,CAAC,MAAM,IAAI,CAAC,CAkBlC,CAAC"}

package/dist/postRepository/api/index.d.ts

@@ -10,4 +10,6 @@ export * from './flagPost';
 export * from './unflagPost';
 export * from './isPostFlaggedByMe';
 export * from './createClipPost';
+export * from './createAudioPost';
+export * from './createMixedMediaPost';
 //# sourceMappingURL=index.d.ts.map

package/dist/postRepository/api/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/postRepository/api/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAE/B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAE3B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AAEjC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAE9B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AAEpC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/postRepository/api/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAE/B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAE3B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AAEjC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAE9B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AAEpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC"}

package/dist/postRepository/observers/getGlobalPinnedPosts/GlobalPinnedPostPaginationController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GlobalPinnedPostPaginationController.d.ts","sourceRoot":"","sources":["../../../../src/postRepository/observers/getGlobalPinnedPosts/GlobalPinnedPostPaginationController.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAGlF,qBAAa,oCAAqC,SAAQ,oBAAoB,CAC5E,YAAY,EACZ,KAAK,CAAC,8BAA8B,CACrC;IACO,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC,8BAA8B,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS;;;;;;;;;CAW9F"}
+{"version":3,"file":"GlobalPinnedPostPaginationController.d.ts","sourceRoot":"","sources":["../../../../src/postRepository/observers/getGlobalPinnedPosts/GlobalPinnedPostPaginationController.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAGlF,qBAAa,oCAAqC,SAAQ,oBAAoB,CAC5E,YAAY,EACZ,KAAK,CAAC,8BAA8B,CACrC;IACO,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC,8BAA8B,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS;;;;;;;;;CAc9F"}

package/dist/postRepository/observers/getPinnedPosts/PinnedPostPaginationController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PinnedPostPaginationController.d.ts","sourceRoot":"","sources":["../../../../src/postRepository/observers/getPinnedPosts/PinnedPostPaginationController.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAGlF,qBAAa,8BAA+B,SAAQ,oBAAoB,CACtE,YAAY,EACZ,KAAK,CAAC,wBAAwB,CAC/B;IACO,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC,wBAAwB,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS;;;;;;;;;CAexF"}
+{"version":3,"file":"PinnedPostPaginationController.d.ts","sourceRoot":"","sources":["../../../../src/postRepository/observers/getPinnedPosts/PinnedPostPaginationController.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAGlF,qBAAa,8BAA+B,SAAQ,oBAAoB,CACtE,YAAY,EACZ,KAAK,CAAC,wBAAwB,CAC/B;IACO,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC,wBAAwB,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS;;;;;;;;;CAkBxF"}

package/dist/utils/linkedObject/postLinkedObject.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"postLinkedObject.d.ts","sourceRoot":"","sources":["../../../src/utils/linkedObject/postLinkedObject.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,gBAAgB,SAAU,MAAM,YAAY,KAAG,MAAM,IAwFjE,CAAC"}
+{"version":3,"file":"postLinkedObject.d.ts","sourceRoot":"","sources":["../../../src/utils/linkedObject/postLinkedObject.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,gBAAgB,SAAU,MAAM,YAAY,KAAG,MAAM,IA8FjE,CAAC"}

package/dist/utils/postTypePredicate.d.ts

@@ -4,4 +4,5 @@ export declare function isAmityVideoPost(post: Amity.InternalPost): post is Amit
 export declare function isAmityLivestreamPost(post: Amity.InternalPost): post is Amity.Post<'liveStream'>;
 export declare function isAmityPollPost(post: Amity.InternalPost): post is Amity.Post<'poll'>;
 export declare function isAmityClipPost(post: Amity.InternalPost): post is Amity.Post<'clip'>;
+export declare function isAmityAudioPost(post: Amity.InternalPost): post is Amity.Post<'audio'>;
 //# sourceMappingURL=postTypePredicate.d.ts.map

package/dist/utils/postTypePredicate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"postTypePredicate.d.ts","sourceRoot":"","sources":["../../src/utils/postTypePredicate.ts"],"names":[],"mappings":"AAAA,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,YAAY,GAAG,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAOtF;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,YAAY,GAAG,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAOpF;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,YAAY,GAAG,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAQtF;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,KAAK,CAAC,YAAY,GAAG,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAOhG;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,YAAY,GAAG,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAOpF;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,YAAY,GAAG,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAOpF"}
+{"version":3,"file":"postTypePredicate.d.ts","sourceRoot":"","sources":["../../src/utils/postTypePredicate.ts"],"names":[],"mappings":"AAAA,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,YAAY,GAAG,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAOtF;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,YAAY,GAAG,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAOpF;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,YAAY,GAAG,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAQtF;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,KAAK,CAAC,YAAY,GAAG,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAOhG;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,YAAY,GAAG,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAOpF;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,YAAY,GAAG,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAOpF;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,YAAY,GAAG,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAOtF"}

package/dist/utils/tests/dummy/comment.d.ts

@@ -23,7 +23,7 @@ export declare const generateComment: (params?: Partial<Amity.InternalComment>)
     referenceType: Amity.CommentReferenceType;
     dataType?: any;
     dataTypes?: any[] | undefined;
-    data?: string | Record<string, unknown> | Amity.ContentDataText | Amity.ContentDataFile | Amity.ContentDataImage | Amity.ContentDataVideo | Amity.ContentDataPoll | Amity.ContentDataStream | Amity.ContentDataClip | undefined;
+    data?: string | Record<string, unknown> | Amity.ContentDataText | Amity.ContentDataFile | Amity.ContentDataImage | Amity.ContentDataVideo | Amity.ContentDataAudio | Amity.ContentDataPoll | Amity.ContentDataStream | Amity.ContentDataClip | undefined;
     metadata?: Record<string, any> | undefined;
     flagCount: number;
     hashFlag: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amityco/ts-sdk",
-  "version": "7.10.0",
+  "version": "7.10.1-0ab8f3fc.0",
   "license": "CC-BY-ND-4.0",
   "author": "amity.co <developers@amity.co> (https://amity.co)",
   "description": "Amity Social Cloud Typescript SDK",

package/src/@types/domains/content.ts

@@ -33,6 +33,7 @@ declare global {
       | 'json'
       | 'liveStream'
       | 'clip'
+      | 'audio'
       | string;
 
     type ContentFeedType = ValueOf<typeof ContentFeedType>;
@@ -71,6 +72,14 @@ declare global {
       displayMode?: Amity.ClipDisplayMode;
     };
 
+    type ContentDataAudio = {
+      fileId: Amity.File<'audio'>['fileId'];
+      fileURL: URL;
+      accessType: Amity.FileAccessType;
+      altText?: string;
+      attributes: { [key: string]: any };
+    };
+
     type ContentDataPoll = {
       pollId: Amity.Poll['pollId'];
     };
@@ -87,6 +96,8 @@ declare global {
       ? ContentDataImage
       : T extends 'video'
       ? ContentDataVideo
+      : T extends 'audio'
+      ? ContentDataAudio
       : T extends 'poll'
       ? ContentDataPoll
       : T extends 'liveStream'

package/src/@types/domains/feed.ts

@@ -5,6 +5,7 @@ export const enum FeedDataTypeEnum {
   Video = 'video',
   Image = 'image',
   File = 'file',
+  Audio = 'audio',
   LiveStream = 'liveStream',
   Clip = 'clip',
   Poll = 'poll',
@@ -39,8 +40,9 @@ declare global {
     } & Amity.Timestamps;
 
     type QueryGlobalFeed = {
-      dataTypes?: ('video' | 'image' | 'file' | 'liveStream' | 'clip')[];
+      dataTypes?: ('video' | 'image' | 'audio' | 'file' | 'poll' | 'liveStream' | 'clip')[];
       queryToken?: string;
+      includeMixedStructure?: boolean;
     };
 
     type CustomRankingGlobalFeedLiveCollection = Amity.LiveCollectionParams<
@@ -66,6 +68,7 @@ declare global {
       dataTypes?: Amity.FeedDataType[];
       matchingOnlyParentPost?: boolean;
       feedSources?: Amity.FeedSource[];
+      includeMixedStructure?: boolean;
     };
 
     type UserFeedLiveCollection = Amity.LiveCollectionParams<QueryUserFeed>;

package/src/@types/domains/file.ts

@@ -3,6 +3,7 @@ export const FileType = Object.freeze({
   IMAGE: 'image',
   VIDEO: 'video',
   CLIP: 'clip',
+  AUDIO: 'audio',
 });
 
 export const VideoResolution = Object.freeze({
@@ -58,6 +59,8 @@ declare global {
 
     type ClipMetadata = Record<string, never>;
 
+    type AudioMetadata = Record<string, never>;
+
     type MetadataFor<T extends FileType> = T extends 'file'
       ? FileMetadata
       : T extends 'image'
@@ -66,6 +69,8 @@ declare global {
       ? VideoMetadata
       : T extends 'clip'
       ? ClipMetadata
+      : T extends 'audio'
+      ? AudioMetadata
       : never;
 
     type File<T extends FileType = any> = Amity.FilePayload<T>;

package/src/@types/domains/pinnedPost.ts

@@ -17,6 +17,7 @@ declare global {
       communityId: Amity.Community['communityId'];
       placement?: string | null;
       sortBy: 'lastPinned' | 'lastCreated';
+      includeMixedStructure?: boolean;
     }>;
 
     type PinnedPostLiveCollectionCache = Omit<
@@ -29,6 +30,8 @@ declare global {
       target: Amity.PinTarget | undefined;
     };
 
-    type GlobalPinnedPostLiveCollection = Amity.LiveCollectionParams<{}>;
+    type GlobalPinnedPostLiveCollection = Amity.LiveCollectionParams<{
+      includeMixedStructure?: boolean;
+    }>;
   }
 }

package/src/@types/domains/post.ts

@@ -6,6 +6,16 @@ export const PostContentType = Object.freeze({
   LIVESTREAM: 'liveStream',
   POLL: 'poll',
   CLIP: 'clip',
+  AUDIO: 'audio',
+});
+
+export const PostStructureType = Object.freeze({
+  TEXT: 'text',
+  IMAGE: 'image',
+  VIDEO: 'video',
+  FILE: 'file',
+  AUDIO: 'audio',
+  MIXED: 'mixed',
 });
 
 declare global {
@@ -15,6 +25,11 @@ declare global {
 
     type PostContentType = ValueOf<typeof PostContentType> | string;
 
+    type MixedMediaPostContentType = Exclude<
+      ValueOf<typeof PostContentType>,
+      'text' | 'poll' | 'liveStream' | 'clip'
+    >;
+
     type PostActionType =
       | 'onFetch'
       | 'onCreate'
@@ -27,6 +42,8 @@ declare global {
       | 'onReactionAdded'
       | 'onReactionRemoved';
 
+    type PostStructureType = ValueOf<typeof PostStructureType>;
+
     type RawPost<T extends PostContentType = any> = {
       postId: string;
       postedUserId: Amity.RawUser['userId'];
@@ -67,6 +84,7 @@ declare global {
       reactions: Record<string, number>;
       myReactions?: string[];
       hashtags?: string[];
+      structureType: Amity.PostStructureType;
     } & Amity.Content<T> &
       Amity.Mentionable<'user'>;
 
@@ -88,6 +106,7 @@ declare global {
       getPollInfo: () => Amity.Poll | undefined;
       getLivestreamInfo: () => Amity.Stream | undefined;
       getClipInfo: () => Amity.File<'clip'> | undefined;
+      getAudioInfo: () => Amity.File<'audio'> | undefined;
     };
 
     type Post<T extends PostContentType = any> = Amity.InternalPost<T> & Amity.PostLinkObject;
@@ -106,6 +125,7 @@ declare global {
       matchingOnlyParentPost?: boolean;
       page?: string;
       limit?: number;
+      includeMixedStructure?: boolean;
     };
 
     type QueryPostsWithHashtags = {
@@ -115,6 +135,7 @@ declare global {
       matchingOnlyParentPost?: boolean;
       page?: string;
       limit?: number;
+      includeMixedStructure?: boolean;
     };
 
     // Omit sortBy explained in asc-3398
@@ -142,6 +163,7 @@ declare global {
       dataTypes?: string[];
       matchingOnlyParentPost?: boolean;
       limit?: number;
+      includeMixedStructure?: boolean;
     };
 
     type SemanticSearchPostLiveCollection = Amity.LiveCollectionParams<

package/src/fileRepository/api/index.ts

@@ -6,3 +6,4 @@ export * from './uploadVideo';
 export * from './uploadImage';
 export * from './updateAltText';
 export * from './uploadClip';
+export * from './uploadAudio';

package/src/fileRepository/api/uploadAudio.ts

@@ -0,0 +1,61 @@
+import { getActiveClient } from '~/client/api/activeClient';
+import { ingestInCache } from '~/cache/api/ingestInCache';
+import GlobalFileAccessType from '~/client/utils/GlobalFileAccessType';
+
+/* begin_public_function
+  id: file.upload.audio
+*/
+/**
+ * ```js
+ * import { FileRepository } from '@amityco/ts-sdk'
+ * const uploaded = await FileRepository.uploadAudio(formData, onProgress)
+ * ```
+ *
+ * Creates an {@link Amity.File<'audio'>}
+ *
+ * @param formData The data necessary to create a new {@link Amity.File<'audio'>}
+ * @param onProgress The callback to track the upload progress
+ * @returns The newly created {@link Amity.File<'audio'>}
+ *
+ * @category File API
+ * @async
+ */
+export const uploadAudio = async (
+  formData: FormData,
+  onProgress?: (percent: number) => void,
+): Promise<Amity.Cached<Amity.File<'audio'>[]>> => {
+  const client = getActiveClient();
+  client.log('file/uploadAudio', formData);
+
+  const file = formData.get('file') as File;
+
+  if (!file) throw new Error('The formData object must have a `file` key with audio file.');
+
+  const accessType = GlobalFileAccessType.getInstance().getFileAccessType();
+
+  formData.append('accessType', accessType);
+
+  formData.append('preferredFilename', file.name);
+
+  const headers = { 'content-type': 'multipart/form-data' };
+
+  const { data } = await client.upload.post<Amity.CreateFilePayload<'audio'>>(
+    '/api/v4/audios',
+    formData,
+    {
+      headers,
+      onUploadProgress({ loaded, total = 100 }) {
+        onProgress?.(Math.round((loaded * 100) / total));
+      },
+    },
+  );
+
+  const cachedAt = client.cache && Date.now();
+  if (client.cache) ingestInCache({ files: data }, { cachedAt });
+
+  return {
+    data,
+    cachedAt,
+  };
+};
+/* end_public_function */

package/src/postRepository/api/createAudioPost.ts

@@ -0,0 +1,60 @@
+import { fireEvent } from '~/core/events';
+import { postLinkedObject } from '~/utils/linkedObject/postLinkedObject';
+import { getActiveClient } from '~/client/api/activeClient';
+import { ingestInCache } from '~/cache/api/ingestInCache';
+import { preparePostPayload } from '../utils/payload';
+
+/* begin_public_function
+  id: post.create.audio_post
+*/
+/**
+ * ```js
+ * import { PostRepository } from '@amityco/ts-sdk'
+ * const created = await PostRepository.createAudioPost({
+ *   targetType: 'user',
+ *   targetId: 'foobar',
+ *   data: { text: 'Audio Post', title: 'Audio Post Title' },
+ *   attachments: [{ type: 'audio', fileId: 'fileId123'}]
+ * }))
+ * ```
+ *
+ * Creates an {@link Amity.Post}
+ *
+ * @param bundle The data necessary to create a new {@link Amity.Post}
+ * @returns The newly created {@link Amity.Post}
+ *
+ * @category Post API
+ * @async
+ */
+export const createAudioPost = async (
+  bundle: Pick<Amity.Post, 'targetType' | 'targetId'> &
+    Partial<Pick<Amity.Post, 'metadata' | 'mentionees' | 'tags' | 'hashtags'>> & {
+      data?: {
+        text?: string;
+        title?: string;
+      };
+      attachments: {
+        type: Extract<Amity.MixedMediaPostContentType, 'audio'>;
+        fileId: Amity.File['fileId'];
+      }[];
+    },
+): Promise<Amity.Cached<Amity.Post>> => {
+  const client = getActiveClient();
+  client.log('post/createAudioPost', bundle);
+
+  const { data: payload } = await client.http.post<Amity.PostPayload>('/api/v4/posts', bundle);
+
+  fireEvent('post.created', payload);
+
+  const data = preparePostPayload(payload);
+
+  const cachedAt = client.cache && Date.now();
+
+  if (client.cache) ingestInCache(data, { cachedAt });
+
+  return {
+    data: postLinkedObject(data?.posts[0]),
+    cachedAt,
+  };
+};
+/* end_public_function */

package/src/postRepository/api/createMixedMediaPost.ts

@@ -0,0 +1,62 @@
+import { fireEvent } from '~/core/events';
+import { preparePostPayload } from '../utils/payload';
+import { ingestInCache } from '~/cache/api/ingestInCache';
+import { getActiveClient } from '~/client/api/activeClient';
+import { postLinkedObject } from '~/utils/linkedObject/postLinkedObject';
+
+/* begin_public_function
+  id: post.create.mixed_media_post
+*/
+/**
+ * ```js
+ * import { PostRepository } from '@amityco/ts-sdk'
+ * const { data } = await PostRepository.createMixedMediaPost({
+ *   targetType: 'community',
+ *   targetId: 'community123',
+ *   data: { text: 'Check out my mixed media post!', title: 'Mixed Media Post' },
+ *   attachments: [
+ *     { fileId: "file1", type: "image" },
+ *     { fileId: "file2", type: "video" },
+ *     { fileId: "file3", type: "audio" },
+ *     { fileId: "file4", type: "file" }
+ *   ],
+ * })
+ * ```
+ *
+ * Creates an {@link Amity.Post}
+ *
+ * @param bundle The data necessary to create a new {@link Amity.Post}
+ * @returns The newly created {@link Amity.Post}
+ *
+ * @category Post API
+ * @async
+ */
+export const createMixedMediaPost = async (
+  bundle: Pick<Amity.Post, 'targetType' | 'targetId'> &
+    Partial<Pick<Amity.Post, 'metadata' | 'mentionees' | 'tags' | 'hashtags'>> & {
+      data?: {
+        text?: string;
+        title?: string;
+      };
+      attachments: { type: Amity.MixedMediaPostContentType; fileId: Amity.File['fileId'] }[];
+    },
+): Promise<Amity.Cached<Amity.Post>> => {
+  const client = getActiveClient();
+  client.log('post/createMixedMediaPost', bundle);
+
+  const { data: payload } = await client.http.post<Amity.PostPayload>('/api/v4/posts', bundle);
+
+  fireEvent('post.created', payload);
+
+  const data = preparePostPayload(payload);
+
+  const cachedAt = client.cache && Date.now();
+
+  if (client.cache) ingestInCache(data, { cachedAt });
+
+  return {
+    data: postLinkedObject(data?.posts?.[0]),
+    cachedAt,
+  };
+};
+/* end_public_function */

package/src/postRepository/api/index.ts

@@ -15,3 +15,5 @@ export * from './unflagPost';
 export * from './isPostFlaggedByMe';
 
 export * from './createClipPost';
+export * from './createAudioPost';
+export * from './createMixedMediaPost';

package/src/postRepository/observers/getGlobalPinnedPosts/GlobalPinnedPostPaginationController.ts

@@ -12,6 +12,9 @@ export class GlobalPinnedPostPaginationController extends PaginationController<
 
     const { data: queryResponse } = await this.http.get<Amity.PinnedPostPayload & Amity.Pagination>(
       path,
+      {
+        params: { ...params },
+      },
     );
 
     return queryResponse;

package/src/postRepository/observers/getPinnedPosts/PinnedPostPaginationController.ts

@@ -8,7 +8,7 @@ export class PinnedPostPaginationController extends PaginationController<
   async getRequest(queryParams: Amity.PinnedPostLiveCollection, token: string | undefined) {
     const { limit = COLLECTION_DEFAULT_PAGINATION_LIMIT, ...params } = queryParams;
 
-    const { communityId, placement } = params;
+    const { communityId, placement, ...rest } = params;
 
     const path = placement
       ? `/api/v1/pinned-posts/communities/${communityId}/${placement}`
@@ -16,6 +16,9 @@ export class PinnedPostPaginationController extends PaginationController<
 
     const { data: queryResponse } = await this.http.get<Amity.PinnedPostPayload & Amity.Pagination>(
       path,
+      {
+        params: { ...rest },
+      },
     );
 
     return queryResponse;

package/src/utils/linkedObject/postLinkedObject.ts

@@ -9,6 +9,7 @@ import {
   isAmityPollPost,
   isAmityVideoPost,
   isAmityClipPost,
+  isAmityAudioPost,
 } from '../postTypePredicate';
 import { shallowClone } from '../shallowClone';
 import { streamLinkedObject } from './streamLinkedObject';
@@ -101,5 +102,11 @@ export const postLinkedObject = (post: Amity.InternalPost): Amity.Post => {
         ? pullFromCache<Amity.File<'clip'>>(['file', 'get', post?.data?.fileId])?.data
         : undefined;
     },
+
+    getAudioInfo(): Amity.File<'audio'> | undefined {
+      return isAmityAudioPost(post)
+        ? pullFromCache<Amity.File<'audio'>>(['file', 'get', post?.data?.fileId])?.data
+        : undefined;
+    },
   });
 };

package/src/utils/postTypePredicate.ts

@@ -52,3 +52,12 @@ export function isAmityClipPost(post: Amity.InternalPost): post is Amity.Post<'c
     post.dataType === 'clip'
   );
 }
+
+export function isAmityAudioPost(post: Amity.InternalPost): post is Amity.Post<'audio'> {
+  return !!(
+    post.data &&
+    typeof post.data !== 'string' &&
+    'fileId' in post.data &&
+    post.dataType === 'audio'
+  );
+}