@amityco/ts-sdk 7.29.0 → 7.29.1-0bbc9cd8.0

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

@@ -23,6 +23,7 @@ export declare const getChannelMessagePreviewWithUser: (channel: Amity.StaticInt
     pinnedMessage?: Amity.RawPinnedMessage<any> | null | undefined;
     isPublic?: boolean | undefined;
     lastActivity: string;
+    lastMessageAt: string | null;
     attachedTo?: {
         postId?: string | undefined;
         videoStreamId?: string | undefined;

package/dist/messagePreview/utils/getChannelMessagePreviewWithUser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getChannelMessagePreviewWithUser.d.ts","sourceRoot":"","sources":["../../../src/messagePreview/utils/getChannelMessagePreviewWithUser.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,gCAAgC,YAClC,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAEpB,MAAM,cAAc,GAAG,IAAI;CAoB5C,CAAC"}
+{"version":3,"file":"getChannelMessagePreviewWithUser.d.ts","sourceRoot":"","sources":["../../../src/messagePreview/utils/getChannelMessagePreviewWithUser.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,gCAAgC,YAClC,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAEpB,MAAM,cAAc,GAAG,IAAI;CAoB5C,CAAC"}

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

@@ -1,6 +1,6 @@
 export declare const getSubChannelMessagePreviewWithUser: (subChannel: Amity.SubChannel) => {
     messagePreview: {
-        user: Amity.InternalUser | undefined;
+        user: Amity.User | undefined;
         messagePreviewId: string;
         subChannelName: string;
         data?: string | Record<string, unknown> | Amity.ContentDataText | Amity.ContentDataFile | Amity.ContentDataImage | Amity.ContentDataVideo | Amity.ContentDataAudio | Amity.ContentDataPoll | Amity.ContentDataStream | Amity.ContentDataClip | Amity.ContentDataRoom | Amity.ContentDataEvent | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"getSubChannelMessagePreviewWithUser.d.ts","sourceRoot":"","sources":["../../../src/messagePreview/utils/getSubChannelMessagePreviewWithUser.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,mCAAmC,eAAgB,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAa/E,CAAC"}
+{"version":3,"file":"getSubChannelMessagePreviewWithUser.d.ts","sourceRoot":"","sources":["../../../src/messagePreview/utils/getSubChannelMessagePreviewWithUser.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,mCAAmC,eAAgB,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoB/E,CAAC"}

package/dist/messageRepository/api/createMessage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createMessage.d.ts","sourceRoot":"","sources":["../../../src/messageRepository/api/createMessage.ts"],"names":[],"mappings":"AAmBA,aAAK,kBAAkB,CAAC,CAAC,SAAS,KAAK,CAAC,kBAAkB,IAAI,IAAI,CAChE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAChB,cAAc,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,YAAY,CAC9E,GAAG;IACF,IAAI,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAqEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,aAAa,yEAEvB,QAAQ,MAAM,MAAM,CAAC,MAAM,OAAO,CAAC,CAuCrC,CAAC"}
+{"version":3,"file":"createMessage.d.ts","sourceRoot":"","sources":["../../../src/messageRepository/api/createMessage.ts"],"names":[],"mappings":"AAwBA,aAAK,kBAAkB,CAAC,CAAC,SAAS,KAAK,CAAC,kBAAkB,IAAI,IAAI,CAChE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAChB,cAAc,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,YAAY,CAC9E,GAAG;IACF,IAAI,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAiFF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,aAAa,yEAEvB,QAAQ,MAAM,MAAM,CAAC,MAAM,OAAO,CAAC,CA2CrC,CAAC"}

package/dist/messageRepository/api/flagMessage.d.ts

@@ -1,15 +1,82 @@
+declare type FlagMessage = {
+    /**
+     * ```js
+     * import { MessageRepository } from '@amityco/ts-sdk'
+     * const flagged = await MessageRepository.flagMessage(messageId)
+     * ```
+     *
+     * Flags a message without a reason. The report is sent as `Others`; no detail is serialized.
+     *
+     * @param messageId The ID of the message to flag
+     * @returns `true` when the report was created
+     */
+    (messageId: Amity.Message['messageId'], reason?: undefined): Promise<boolean>;
+    /**
+     * ```js
+     * import { MessageRepository, ContentFlagReasonEnum } from '@amityco/ts-sdk'
+     * const flagged = await MessageRepository.flagMessage(messageId, {
+     *   reason: ContentFlagReasonEnum.SpamOrScams,
+     *   detail: 'Repeated promotional links',
+     * })
+     * ```
+     *
+     * Flags a message with a category and optional reporter context. Any category,
+     * including `Others`, may carry a `detail`. `detail` is sent unchanged and omitted
+     * when not supplied; the backend enforces its 300-character limit.
+     *
+     * @param messageId The ID of the message to flag
+     * @param options `reason` is a `ContentFlagReasonEnum` value; `detail` is optional free text
+     * @returns `true` when the report was created
+     * @throws {ASCInvalidParameterError} `INVALID_PARAMETERS` when `options` is malformed, before any request is made
+     */
+    (messageId: Amity.Message['messageId'], options: Amity.ContentFlagOptions): Promise<boolean>;
+    /**
+     * ```js
+     * import { MessageRepository } from '@amityco/ts-sdk'
+     * const flagged = await MessageRepository.flagMessage(messageId, reason)
+     * ```
+     *
+     * @deprecated Pass an options object instead: `flagMessage(messageId, { reason, detail })`.
+     * A predefined string maps to `{ reason: <value>, detail: '' }`; a custom string maps to
+     * `{ reason: 'Others', detail: <string> }`. Migrate a custom string to
+     * `{ reason: ContentFlagReasonEnum.Others, detail: customString }`. This mapping is
+     * unchanged and stays available throughout the current major version.
+     *
+     * @param messageId The ID of the message to flag
+     * @param reason a predefined `ContentFlagReasonEnum` value or a custom string
+     * @returns `true` when the report was created
+     */
+    (messageId: Amity.Message['messageId'], reason?: Amity.ContentFlagReason): Promise<boolean>;
+};
 /**
  * ```js
- * import { MessageRepository } from '@amityco/ts-sdk'
- * const flagged = await MessageRepository.flagMessage(messageId, reason)
+ * import { MessageRepository, ContentFlagReasonEnum } from '@amityco/ts-sdk'
+ *
+ * // No reason.
+ * await MessageRepository.flagMessage(messageId)
+ *
+ * // Category plus optional reporter context (any category, including Others).
+ * await MessageRepository.flagMessage(messageId, {
+ *   reason: ContentFlagReasonEnum.SpamOrScams,
+ *   detail: 'Repeated promotional links',
+ * })
  * ```
  *
- * @param messageId of the message to flag
- * @param reason the reason to flag the message
- * @returns the created report result
+ * Reports a message to moderation. Three call shapes are accepted (see the overloads):
+ * id-only, an options object, and the deprecated legacy reason string. The public
+ * name only dispatches on the input shape; the two implementations are kept separate
+ * so the legacy path is untouched by the new contract:
+ *
+ * - `undefined` or a string → `flagMessageWithReasonString` (unchanged legacy mapping)
+ * - anything else → `flagMessageWithOptions` (validated `{ reason, detail? }`)
+ *
+ * @param messageId The ID of the message to flag
+ * @param input an options object `{ reason, detail? }`, a legacy reason string, or nothing
+ * @returns `true` when the report was created
  *
  * @category Message API
  * @async
  * */
-export declare const flagMessage: (messageId: Amity.Message['messageId'], reason?: Amity.ContentFlagReason) => Promise<boolean>;
+export declare const flagMessage: FlagMessage;
+export {};
 //# sourceMappingURL=flagMessage.d.ts.map

package/dist/messageRepository/api/flagMessage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flagMessage.d.ts","sourceRoot":"","sources":["../../../src/messageRepository/api/flagMessage.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;KAYK;AACL,eAAO,MAAM,WAAW,cACX,MAAM,OAAO,CAAC,WAAW,CAAC,WAC5B,MAAM,iBAAiB,KAC/B,QAAQ,OAAO,CA4BjB,CAAC"}
+{"version":3,"file":"flagMessage.d.ts","sourceRoot":"","sources":["../../../src/messageRepository/api/flagMessage.ts"],"names":[],"mappings":"AAIA,aAAK,WAAW,GAAG;IACjB;;;;;;;;;;OAUG;IACH,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9E;;;;;;;;;;;;;;;;;OAiBG;IACH,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7F;;;;;;;;;;;;;;;OAeG;IACH,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7F,CAAC;AAKF;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA4BK;AACL,eAAO,MAAM,WAAW,EAAE,WAMoB,CAAC"}

package/dist/messageRepository/api/tests/integration/flagMessage.overloads.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=flagMessage.overloads.integration.test.d.ts.map

package/dist/messageRepository/api/tests/integration/flagMessage.overloads.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flagMessage.overloads.integration.test.d.ts","sourceRoot":"","sources":["../../../../../src/messageRepository/api/tests/integration/flagMessage.overloads.integration.test.ts"],"names":[],"mappings":""}

package/dist/messageRepository/internalApi/flagMessageWithOptions.d.ts

@@ -0,0 +1,13 @@
+/**
+ * New `flagMessage(messageId, { reason, detail? })` implementation. Any category,
+ * including `Others`, may carry a `detail`. `detail` is forwarded unchanged (empty and
+ * whitespace-only strings included) and omitted from the request body when `undefined`;
+ * the backend enforces the 300-character limit.
+ *
+ * Not exported from the public API. It is reached through the
+ * `MessageRepository.flagMessage(messageId, options)` overload; see `api/flagMessage.ts`.
+ *
+ * @throws {ASCInvalidParameterError} `INVALID_PARAMETERS` when `options` is malformed, before any request is made
+ */
+export declare const flagMessageWithOptions: (messageId: Amity.Message['messageId'], options: Amity.ContentFlagOptions) => Promise<boolean>;
+//# sourceMappingURL=flagMessageWithOptions.d.ts.map

package/dist/messageRepository/internalApi/flagMessageWithOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flagMessageWithOptions.d.ts","sourceRoot":"","sources":["../../../src/messageRepository/internalApi/flagMessageWithOptions.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,cACtB,MAAM,OAAO,CAAC,WAAW,CAAC,WAC5B,MAAM,kBAAkB,KAChC,QAAQ,OAAO,CAqBjB,CAAC"}

package/dist/messageRepository/internalApi/flagMessageWithReasonString.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Legacy `flagMessage(messageId, reason?)` implementation, kept verbatim so existing
+ * callers keep the exact request body they had before the options contract existed:
+ *
+ * - predefined `ContentFlagReasonEnum` value → `{ reason: <value>, detail: '' }`
+ * - any other non-empty string (including the literal `'Others'`) → `{ reason: 'Others', detail: <string> }`
+ * - `undefined` or `''` → `{ reason: 'Others', detail: '' }`
+ *   (for `undefined` the message body carries `detail: undefined`, which JSON serialization omits)
+ *
+ * Not exported from the public API. It is reached through the deprecated
+ * `MessageRepository.flagMessage(messageId, reason)` overload; see `api/flagMessage.ts`.
+ *
+ * Not itself deprecated: it implements the deprecated legacy-string overload of the public
+ * `flagMessage`, which carries the deprecation tag. New code should use `flagMessageWithOptions`
+ * (the `{ reason, detail? }` contract). This path stays available throughout the current major version.
+ */
+export declare const flagMessageWithReasonString: (messageId: Amity.Message['messageId'], reason?: Amity.ContentFlagReason) => Promise<boolean>;
+//# sourceMappingURL=flagMessageWithReasonString.d.ts.map

package/dist/messageRepository/internalApi/flagMessageWithReasonString.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flagMessageWithReasonString.d.ts","sourceRoot":"","sources":["../../../src/messageRepository/internalApi/flagMessageWithReasonString.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,2BAA2B,cAC3B,MAAM,OAAO,CAAC,WAAW,CAAC,WAC5B,MAAM,iBAAiB,KAC/B,QAAQ,OAAO,CA4BjB,CAAC"}

package/dist/messageRepository/internalApi/tests/integration/flagMessageWithOptions.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=flagMessageWithOptions.integration.test.d.ts.map

package/dist/messageRepository/internalApi/tests/integration/flagMessageWithOptions.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flagMessageWithOptions.integration.test.d.ts","sourceRoot":"","sources":["../../../../../src/messageRepository/internalApi/tests/integration/flagMessageWithOptions.integration.test.ts"],"names":[],"mappings":""}

package/dist/messageRepository/internalApi/tests/integration/flagMessageWithReasonString.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=flagMessageWithReasonString.integration.test.d.ts.map

package/dist/messageRepository/internalApi/tests/integration/flagMessageWithReasonString.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flagMessageWithReasonString.integration.test.d.ts","sourceRoot":"","sources":["../../../../../src/messageRepository/internalApi/tests/integration/flagMessageWithReasonString.integration.test.ts"],"names":[],"mappings":""}

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

@@ -1,15 +1,82 @@
+declare type FlagPost = {
+    /**
+     * ```js
+     * import { PostRepository } from '@amityco/ts-sdk'
+     * const flagged = await PostRepository.flagPost(postId)
+     * ```
+     *
+     * Flags a post without a reason. The report is sent as `Others` with an empty detail.
+     *
+     * @param postId The ID of the post to flag
+     * @returns `true` when the report was created
+     */
+    (postId: Amity.Post['postId'], reason?: undefined): Promise<boolean>;
+    /**
+     * ```js
+     * import { PostRepository, ContentFlagReasonEnum } from '@amityco/ts-sdk'
+     * const flagged = await PostRepository.flagPost(postId, {
+     *   reason: ContentFlagReasonEnum.SpamOrScams,
+     *   detail: 'Repeated promotional links',
+     * })
+     * ```
+     *
+     * Flags a post with a category and optional reporter context. Any category,
+     * including `Others`, may carry a `detail`. `detail` is sent unchanged and omitted
+     * when not supplied; the backend enforces its 300-character limit.
+     *
+     * @param postId The ID of the post to flag
+     * @param options `reason` is a `ContentFlagReasonEnum` value; `detail` is optional free text
+     * @returns `true` when the report was created
+     * @throws {ASCInvalidParameterError} `INVALID_PARAMETERS` when `options` is malformed, before any request is made
+     */
+    (postId: Amity.Post['postId'], options: Amity.ContentFlagOptions): Promise<boolean>;
+    /**
+     * ```js
+     * import { PostRepository } from '@amityco/ts-sdk'
+     * const flagged = await PostRepository.flagPost(postId, reason)
+     * ```
+     *
+     * @deprecated Pass an options object instead: `flagPost(postId, { reason, detail })`.
+     * A predefined string maps to `{ reason: <value>, detail: '' }`; a custom string maps to
+     * `{ reason: 'Others', detail: <string> }`. Migrate a custom string to
+     * `{ reason: ContentFlagReasonEnum.Others, detail: customString }`. This mapping is
+     * unchanged and stays available throughout the current major version.
+     *
+     * @param postId The ID of the post to flag
+     * @param reason a predefined `ContentFlagReasonEnum` value or a custom string
+     * @returns `true` when the report was created
+     */
+    (postId: Amity.Post['postId'], reason?: Amity.ContentFlagReason): Promise<boolean>;
+};
 /**
  * ```js
- * import { PostRepository } from '@amityco/ts-sdk'
- * const flagged = await PostRepository.flagPost(postId, reason)
+ * import { PostRepository, ContentFlagReasonEnum } from '@amityco/ts-sdk'
+ *
+ * // No reason.
+ * await PostRepository.flagPost(postId)
+ *
+ * // Category plus optional reporter context (any category, including Others).
+ * await PostRepository.flagPost(postId, {
+ *   reason: ContentFlagReasonEnum.SpamOrScams,
+ *   detail: 'Repeated promotional links',
+ * })
  * ```
  *
- * @param postId of the post to flag
- * @param reason the reason to flag the post
- * @returns a boolean
+ * Reports a post to moderation. Three call shapes are accepted (see the overloads):
+ * id-only, an options object, and the deprecated legacy reason string. The public
+ * name only dispatches on the input shape; the two implementations are kept separate
+ * so the legacy path is untouched by the new contract:
+ *
+ * - `undefined` or a string → `flagPostWithReasonString` (unchanged legacy mapping)
+ * - anything else → `flagPostWithOptions` (validated `{ reason, detail? }`)
+ *
+ * @param postId The ID of the post to flag
+ * @param input an options object `{ reason, detail? }`, a legacy reason string, or nothing
+ * @returns `true` when the report was created
  *
  * @category Post API
  * @async
  * */
-export declare const flagPost: (postId: Amity.Post['postId'], reason?: Amity.ContentFlagReason) => Promise<boolean>;
+export declare const flagPost: FlagPost;
+export {};
 //# sourceMappingURL=flagPost.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"flagPost.d.ts","sourceRoot":"","sources":["../../../src/postRepository/api/flagPost.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;KAYK;AACL,eAAO,MAAM,QAAQ,WACX,MAAM,IAAI,CAAC,QAAQ,CAAC,WACnB,MAAM,iBAAiB,KAC/B,QAAQ,OAAO,CA2BjB,CAAC"}
+{"version":3,"file":"flagPost.d.ts","sourceRoot":"","sources":["../../../src/postRepository/api/flagPost.ts"],"names":[],"mappings":"AAIA,aAAK,QAAQ,GAAG;IACd;;;;;;;;;;OAUG;IACH,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrE;;;;;;;;;;;;;;;;;OAiBG;IACH,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpF;;;;;;;;;;;;;;;OAeG;IACH,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpF,CAAC;AAKF;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA4BK;AACL,eAAO,MAAM,QAAQ,EAAE,QAMiB,CAAC"}

package/dist/postRepository/api/tests/integration/flagPost.overloads.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=flagPost.overloads.integration.test.d.ts.map

package/dist/postRepository/api/tests/integration/flagPost.overloads.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flagPost.overloads.integration.test.d.ts","sourceRoot":"","sources":["../../../../../src/postRepository/api/tests/integration/flagPost.overloads.integration.test.ts"],"names":[],"mappings":""}

package/dist/postRepository/api/tests/integration/setup.d.ts

@@ -15,7 +15,7 @@ export declare const roomPostWithProductTags: Amity.InternalPost<any>;
 export declare const roomPostWithPinnedProduct: Amity.InternalPost<any>;
 export declare const createPostPayload: {
     posts: Amity.Post<any>[];
-    users: Amity.User[];
+    users: Amity.InternalUser[];
     postChildren: never[];
     communities: never[];
     communityUsers: never[];
@@ -30,7 +30,7 @@ export declare const createPostPayload: {
 };
 export declare const getPostPayload: {
     posts: Amity.Post<any>[];
-    users: Amity.User[];
+    users: Amity.InternalUser[];
     postChildren: never[];
     communities: never[];
     communityUsers: never[];
@@ -45,7 +45,7 @@ export declare const getPostPayload: {
 };
 export declare const queryPostsPayload: {
     posts: Amity.Post<any>[];
-    users: Amity.User[];
+    users: Amity.InternalUser[];
     paging: {
         next: undefined;
     };

package/dist/postRepository/internalApi/flagPostWithOptions.d.ts

@@ -0,0 +1,13 @@
+/**
+ * New `flagPost(postId, { reason, detail? })` implementation. Any category, including
+ * `Others`, may carry a `detail`. `detail` is forwarded unchanged (empty and
+ * whitespace-only strings included) and omitted from the request body when `undefined`;
+ * the backend enforces the 300-character limit.
+ *
+ * Not exported from the public API. It is reached through the
+ * `PostRepository.flagPost(postId, options)` overload; see `api/flagPost.ts`.
+ *
+ * @throws {ASCInvalidParameterError} `INVALID_PARAMETERS` when `options` is malformed, before any request is made
+ */
+export declare const flagPostWithOptions: (postId: Amity.Post['postId'], options: Amity.ContentFlagOptions) => Promise<boolean>;
+//# sourceMappingURL=flagPostWithOptions.d.ts.map

package/dist/postRepository/internalApi/flagPostWithOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flagPostWithOptions.d.ts","sourceRoot":"","sources":["../../../src/postRepository/internalApi/flagPostWithOptions.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,WACtB,MAAM,IAAI,CAAC,QAAQ,CAAC,WACnB,MAAM,kBAAkB,KAChC,QAAQ,OAAO,CAoBjB,CAAC"}

package/dist/postRepository/internalApi/flagPostWithReasonString.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Legacy `flagPost(postId, reason?)` implementation, kept verbatim so existing
+ * callers keep the exact request body they had before the options contract existed:
+ *
+ * - predefined `ContentFlagReasonEnum` value → `{ reason: <value>, detail: '' }`
+ * - any other non-empty string (including the literal `'Others'`) → `{ reason: 'Others', detail: <string> }`
+ * - `undefined` or `''` → `{ reason: 'Others', detail: '' }`
+ *
+ * Not exported from the public API. It is reached through the deprecated
+ * `PostRepository.flagPost(postId, reason)` overload; see `api/flagPost.ts`.
+ *
+ * Not itself deprecated: it implements the deprecated legacy-string overload of the public
+ * `flagPost`, which carries the deprecation tag. New code should use `flagPostWithOptions`
+ * (the `{ reason, detail? }` contract). This path stays available throughout the current major version.
+ */
+export declare const flagPostWithReasonString: (postId: Amity.Post['postId'], reason?: Amity.ContentFlagReason) => Promise<boolean>;
+//# sourceMappingURL=flagPostWithReasonString.d.ts.map

package/dist/postRepository/internalApi/flagPostWithReasonString.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flagPostWithReasonString.d.ts","sourceRoot":"","sources":["../../../src/postRepository/internalApi/flagPostWithReasonString.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,wBAAwB,WAC3B,MAAM,IAAI,CAAC,QAAQ,CAAC,WACnB,MAAM,iBAAiB,KAC/B,QAAQ,OAAO,CA2BjB,CAAC"}

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

@@ -1,2 +1,4 @@
 export * from './getPost';
+export * from './flagPostWithReasonString';
+export * from './flagPostWithOptions';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/postRepository/internalApi/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/postRepository/internalApi/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAE1B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC"}

package/dist/postRepository/internalApi/tests/integration/flagPostWithOptions.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=flagPostWithOptions.integration.test.d.ts.map

package/dist/postRepository/internalApi/tests/integration/flagPostWithOptions.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flagPostWithOptions.integration.test.d.ts","sourceRoot":"","sources":["../../../../../src/postRepository/internalApi/tests/integration/flagPostWithOptions.integration.test.ts"],"names":[],"mappings":""}

package/dist/postRepository/internalApi/tests/integration/flagPostWithReasonString.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=flagPostWithReasonString.integration.test.d.ts.map

package/dist/postRepository/internalApi/tests/integration/flagPostWithReasonString.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flagPostWithReasonString.integration.test.d.ts","sourceRoot":"","sources":["../../../../../src/postRepository/internalApi/tests/integration/flagPostWithReasonString.integration.test.ts"],"names":[],"mappings":""}

package/dist/postRepository/utils/payload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../../src/postRepository/utils/payload.ts"],"names":[],"mappings":"AAyBA,eAAO,MAAM,kBAAkB,YAAa,MAAM,WAAW,KAAG,MAAM,oBAiFrE,CAAC;AAEF,eAAO,MAAM,gCAAgC,4CAI1C,MAAM,yBAAyB,KAAG,MAAM,kCAO1C,CAAC"}
+{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../../src/postRepository/utils/payload.ts"],"names":[],"mappings":"AA2BA,eAAO,MAAM,kBAAkB,YAAa,MAAM,WAAW,KAAG,MAAM,oBAiFrE,CAAC;AAEF,eAAO,MAAM,gCAAgC,4CAI1C,MAAM,yBAAyB,KAAG,MAAM,kCAO1C,CAAC"}

package/dist/report/api/isReportedByMe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"isReportedByMe.d.ts","sourceRoot":"","sources":["../../../src/report/api/isReportedByMe.ts"],"names":[],"mappings":"AAgEA;;;;;;;;;;;;KAYK;AACL,eAAO,MAAM,cAAc,kBACV,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,eACzC,MAAM,KAClB,QAAQ,OAAO,CAqBjB,CAAC"}
+{"version":3,"file":"isReportedByMe.d.ts","sourceRoot":"","sources":["../../../src/report/api/isReportedByMe.ts"],"names":[],"mappings":"AAmEA;;;;;;;;;;;;KAYK;AACL,eAAO,MAAM,cAAc,kBACV,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,eACzC,MAAM,KAClB,QAAQ,OAAO,CAqBjB,CAAC"}

package/dist/userRepository/api/flagUser.d.ts

@@ -1,22 +1,63 @@
+declare type FlagUser = {
+    /**
+     * ```js
+     * import { UserRepository } from '@amityco/ts-sdk'
+     * const flagged = await UserRepository.flagUser('userId')
+     * ```
+     *
+     * Flags a user with a typeless report. No request body is sent.
+     *
+     * To report a specific profile field use `flagUserProfile(userId, { field, comment })`;
+     * to report behavior use `flagUserBehavior(userId, { reason, comment })`.
+     *
+     * @param userId The ID of the user to be flagged
+     * @returns the flagged {@link Amity.User}
+     */
+    (userId: Amity.User['userId'], options?: undefined): Promise<Amity.User>;
+    /**
+     * ```js
+     * import { UserRepository } from '@amityco/ts-sdk'
+     * const flaggedBehavior = await UserRepository.flagUser('userId', {
+     *   reportType: 'behavior',
+     *   reason: 'Harassment or bullying',
+     *   comment: 'optional free-text',
+     * })
+     * ```
+     *
+     * @deprecated Use `flagUserProfile(userId, { field, comment })` to report a profile
+     * field, or `flagUserBehavior(userId, { reason, comment })` to report behavior. For a
+     * custom `Others` reason, pass `reason: ContentFlagReasonEnum.Others` and put the text
+     * in `comment`. `flagUser(userId)` without options stays supported. This overload's
+     * request mapping is unchanged and stays available throughout the current major version.
+     *
+     * @param userId The ID of the user to be flagged
+     * @param options Optional report metadata forwarded to the server as the request
+     *   body: `reportType`, `reason`, `comment`. Only non-undefined fields are included.
+     *   All validation is server-side; a bodyless call produces a typeless report.
+     * @returns the flagged {@link Amity.User}
+     */
+    (userId: Amity.User['userId'], options?: Amity.UserReportOptions): Promise<Amity.User>;
+};
 /**
  * ```js
  * import { UserRepository } from '@amityco/ts-sdk'
+ *
+ * // Typeless report (supported).
  * const flagged = await UserRepository.flagUser('userId')
- * const flaggedBehavior = await UserRepository.flagUser('userId', {
- *   reportType: 'behavior',
- *   reason: 'Harassment or bullying',
- *   comment: 'optional free-text',
- * })
  * ```
  *
+ * Flags a user. Two call shapes are accepted (see the overloads): id-only, which
+ * sends no body and stays supported, and the deprecated structured options object,
+ * whose request mapping is unchanged. New code reporting a profile field or behavior
+ * should use `flagUserProfile` or `flagUserBehavior`.
+ *
  * @param userId The ID of the user to be flagged
- * @param options Optional report metadata forwarded to the server as the request
- *   body: `reportType`, `reason`, `comment`. Only non-null fields are included.
- *   All validation is server-side; a bodyless call produces a typeless report.
+ * @param options Deprecated report metadata; omit for a typeless report
  * @returns the flagged {@link Amity.User}
  *
  * @category User API
  * @async
  * */
-export declare const flagUser: (userId: Amity.User['userId'], options?: Amity.UserReportOptions) => Promise<Amity.User>;
+export declare const flagUser: FlagUser;
+export {};
 //# sourceMappingURL=flagUser.d.ts.map

package/dist/userRepository/api/flagUser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flagUser.d.ts","sourceRoot":"","sources":["../../../src/userRepository/api/flagUser.ts"],"names":[],"mappings":"AAoBA;;;;;;;;;;;;;;;;;;;KAmBK;AACL,eAAO,MAAM,QAAQ,WACX,MAAM,IAAI,CAAC,QAAQ,CAAC,YAClB,MAAM,iBAAiB,KAChC,QAAQ,MAAM,IAAI,CAoBpB,CAAC"}
+{"version":3,"file":"flagUser.d.ts","sourceRoot":"","sources":["../../../src/userRepository/api/flagUser.ts"],"names":[],"mappings":"AAkBA,aAAK,QAAQ,GAAG;IACd;;;;;;;;;;;;;OAaG;IACH,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzE;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,iBAAiB,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;CACxF,CAAC;AAKF;;;;;;;;;;;;;;;;;;;KAmBK;AACL,eAAO,MAAM,QAAQ,EAAE,QAuBtB,CAAC"}

package/dist/userRepository/api/flagUserBehavior.d.ts

@@ -0,0 +1,29 @@
+/**
+ * ```js
+ * import { UserRepository, ContentFlagReasonEnum } from '@amityco/ts-sdk'
+ * const flagged = await UserRepository.flagUserBehavior('userId', {
+ *   reason: ContentFlagReasonEnum.Others,
+ *   comment: 'Impersonating our brand',
+ * })
+ * ```
+ *
+ * Reports a user's behavior. `reason` is required and is one of the nine
+ * `ContentFlagReasonEnum` values, sent as its canonical label. Reporter text, including
+ * the explanation for `Others`, always travels in `comment`; the reason never carries text.
+ *
+ * `comment` is trimmed; a blank comment is omitted from the request; a comment longer
+ * than 300 characters after trimming is rejected before any request. Otherwise the
+ * trimmed text is sent unchanged.
+ *
+ * Sends `POST /api/v4/me/flags/:userId` with `{ reportType: 'behavior', reason, comment? }`.
+ *
+ * @param userId The ID of the user to be reported
+ * @param options `reason` is a `ContentFlagReasonEnum` value; `comment` is optional free text
+ * @returns the flagged {@link Amity.User}
+ * @throws {ASCInvalidParameterError} `INVALID_PARAMETERS` when `options` is missing or malformed, `reason` is missing or unknown, or `comment` is over 300 characters, before any request is made
+ *
+ * @category User API
+ * @async
+ * */
+export declare const flagUserBehavior: (userId: Amity.User['userId'], options: Amity.UserBehaviorReportOptions) => Promise<Amity.User>;
+//# sourceMappingURL=flagUserBehavior.d.ts.map

package/dist/userRepository/api/flagUserBehavior.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flagUserBehavior.d.ts","sourceRoot":"","sources":["../../../src/userRepository/api/flagUserBehavior.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;;;;;;KA0BK;AACL,eAAO,MAAM,gBAAgB,WACnB,MAAM,IAAI,CAAC,QAAQ,CAAC,WACnB,MAAM,yBAAyB,KACvC,QAAQ,MAAM,IAAI,CAC4D,CAAC"}

package/dist/userRepository/api/flagUserProfile.d.ts

@@ -0,0 +1,29 @@
+/**
+ * ```js
+ * import { UserRepository, UserProfileFieldEnum } from '@amityco/ts-sdk'
+ * const flagged = await UserRepository.flagUserProfile('userId', {
+ *   field: UserProfileFieldEnum.AVATAR,
+ *   comment: 'Nudity in profile photo',
+ * })
+ * ```
+ *
+ * Reports one of a user's profile fields (display name, description or avatar). The
+ * call has no reason: profile reports never carry one, so the backend's reason rules
+ * cannot be violated from here. A `reason` key passed at runtime is ignored and never sent.
+ *
+ * `comment` is trimmed; a blank comment is omitted from the request; a comment longer
+ * than 300 characters after trimming is rejected before any request. Otherwise the
+ * trimmed text is sent unchanged.
+ *
+ * Sends `POST /api/v4/me/flags/:userId` with `{ reportType: <field>, comment? }`.
+ *
+ * @param userId The ID of the user to be reported
+ * @param options `field` is a `UserProfileFieldEnum` value; `comment` is optional free text
+ * @returns the flagged {@link Amity.User}
+ * @throws {ASCInvalidParameterError} `INVALID_PARAMETERS` when `options` is missing or malformed, or `comment` is over 300 characters, before any request is made
+ *
+ * @category User API
+ * @async
+ * */
+export declare const flagUserProfile: (userId: Amity.User['userId'], options: Amity.UserProfileReportOptions) => Promise<Amity.User>;
+//# sourceMappingURL=flagUserProfile.d.ts.map

package/dist/userRepository/api/flagUserProfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flagUserProfile.d.ts","sourceRoot":"","sources":["../../../src/userRepository/api/flagUserProfile.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;;;;;;KA0BK;AACL,eAAO,MAAM,eAAe,WAClB,MAAM,IAAI,CAAC,QAAQ,CAAC,WACnB,MAAM,wBAAwB,KACtC,QAAQ,MAAM,IAAI,CAC0D,CAAC"}

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

@@ -1,6 +1,8 @@
 export { getUserByIds } from './getUserByIds';
 export { updateUser } from './updateUser';
 export { flagUser } from './flagUser';
+export { flagUserProfile } from './flagUserProfile';
+export { flagUserBehavior } from './flagUserBehavior';
 export { unflagUser } from './unflagUser';
 export { isUserFlaggedByMe } from './isUserFlaggedByMe';
 export { getAllBlockedUsers } from './getAllBlockedUsers';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/userRepository/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/userRepository/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/userRepository/api/isUserFlaggedByMe.d.ts

@@ -1,14 +1,36 @@
 /**
  * ```js
  * import { UserRepository } from '@amityco/ts-sdk'
- * const isFlagged = await UserRepository.isUserFlaggedByMe(postId)
+ *
+ * const { isFlagByMe, flags } = await UserRepository.isUserFlaggedByMe('userId')
+ *
+ * // Grey out the report options already used; null marks the typeless report.
+ * const used = new Set(flags.map(flag => flag.reportType))
  * ```
  *
- * @param userId The ID of the thing to check a report to.
- * @returns `true` if the report is created by me, `false` if doesn't.
+ * Returns whether the caller has reported a user, with each of the caller's own reports
+ * on that user, exactly as `GET /api/v4/users/:userId/isFlagByMe` answers. Each report
+ * carries `reportType`, `reason`, `comment` and `createdAt`; a field the report does not
+ * have is `null`. `reportType: null` is the typeless (legacy) report, which `unflagUser`
+ * withdraws with `UserReportTypeFilterEnum.UNTYPED`. Only the caller's reports come back.
+ *
+ * This is the only source of per-type state. Nothing is filtered, cached or persisted:
+ * the call reads the server every time and does not consult `hashFlag`, which is a
+ * type-blind bloom filter. Call it again after a flag or unflag when the UI needs the
+ * updated per-type state.
+ *
+ * Breaking change: earlier versions returned a boolean from the v3 endpoint, which the
+ * backend has deprecated. Read `isFlagByMe` on the result for the same answer.
+ *
+ * @deprecated On an {@link Amity.User} you already hold, read `user.isFlaggedByMe` for a
+ * request-free badge and call `user.getUserFlagsByMe()` for the reports; it skips the request
+ * when the Bloom test says the user is not flagged. This function remains the underlying request.
+ *
+ * @param userId The ID of the user to check
+ * @returns the caller's {@link Amity.UserFlagByMe} on that user
  *
  * @category Report API
  * @async
  * */
-export declare const isUserFlaggedByMe: (userId: Amity.User['userId']) => Promise<boolean>;
+export declare const isUserFlaggedByMe: (userId: Amity.User['userId']) => Promise<Amity.UserFlagByMe>;
 //# sourceMappingURL=isUserFlaggedByMe.d.ts.map

package/dist/userRepository/api/isUserFlaggedByMe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"isUserFlaggedByMe.d.ts","sourceRoot":"","sources":["../../../src/userRepository/api/isUserFlaggedByMe.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;KAWK;AACL,eAAO,MAAM,iBAAiB,WAAkB,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAG,QAAQ,OAAO,CASrF,CAAC"}
+{"version":3,"file":"isUserFlaggedByMe.d.ts","sourceRoot":"","sources":["../../../src/userRepository/api/isUserFlaggedByMe.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAiCK;AACL,eAAO,MAAM,iBAAiB,WACpB,MAAM,IAAI,CAAC,QAAQ,CAAC,KAC3B,QAAQ,MAAM,YAAY,CAK5B,CAAC"}