@linqapp/sdk 0.81.0 → 0.82.0

package/src/resources/messages/messages.ts

@@ -238,7 +238,8 @@ export class Messages extends APIResource {
    * - laugh 😂
    * - emphasize ‼️
    * - question ❓
-   * - custom - any emoji as a tapback (use `custom_emoji` field to specify)
+   * - custom - any emoji or image as a tapback (use `custom_emoji` for an emoji, or
+   *   `url` / `attachment_id` for an image)
    * - sticker - an emoji or image peeled onto the message (use `emoji`, `url` or
    *   `attachment_id`)
    *
@@ -247,6 +248,9 @@ export class Messages extends APIResource {
    * `sticker` is peeled onto the bubble itself, and can be dragged, resized and
    * rotated. Both accept an emoji; they do not look alike.
    *
+   * **Image tapbacks** are iMessage-only. Remove one with `operation: "remove"` and
+   * `type: "custom"`; no image is needed.
+   *
    * **Stickers** are iMessage-only and cannot be removed, so `operation: "remove"`
    * with `type: "sticker"` is rejected. Position, size and rotation are optional via
    * `placement`, and can be changed afterwards with
@@ -932,15 +936,17 @@ export interface MessageAddReactionParams {
 
   /**
    * Type of reaction. Standard iMessage tapbacks are love, like, dislike, laugh,
-   * emphasize, question. Custom emoji reactions have type "custom" with the actual
-   * emoji in the custom_emoji field. Sticker reactions have type "sticker" with
-   * sticker attachment details in the sticker field.
+   * emphasize, question. Custom tapbacks have type "custom": an emoji tapback
+   * carries the emoji in the custom_emoji field, and an image tapback carries the
+   * image in the sticker field. Sticker reactions have type "sticker" with sticker
+   * attachment details in the sticker field.
    */
   type: Shared.ReactionType;
 
   /**
-   * Reference to a sticker image pre-uploaded via `POST /v3/attachments`. Only valid
-   * when type is "sticker".
+   * Reference to an image pre-uploaded via `POST /v3/attachments`. Valid when type
+   * is "sticker", or when adding a type "custom" reaction to make it an image
+   * tapback.
    *
    * Exactly one of `emoji`, `url` or `attachment_id` is required when type is
    * "sticker".
@@ -948,7 +954,9 @@ export interface MessageAddReactionParams {
   attachment_id?: string;
 
   /**
-   * Custom emoji string. Required when type is "custom".
+   * Custom emoji string. When adding a type "custom" reaction, provide exactly one
+   * of `custom_emoji`, `url` or `attachment_id`. To remove an emoji reaction, pass
+   * the same `custom_emoji`.
    *
    * This is a **tapback** — the emoji sits in the tapback bubble on the corner of
    * the message. To peel an emoji onto the message as a draggable sticker instead,
@@ -983,11 +991,12 @@ export interface MessageAddReactionParams {
   placement?: MessageAddReactionParams.Placement;
 
   /**
-   * Linq attachment URL of the sticker image — the `download_url` returned by
-   * `POST /v3/attachments`. Only valid when type is "sticker".
+   * Linq attachment URL of the image — the `download_url` returned by
+   * `POST /v3/attachments`. Valid when type is "sticker", or when adding a type
+   * "custom" reaction to make it an image tapback.
    *
-   * The image must already be stored with us. To send a sticker from elsewhere,
-   * upload it with `POST /v3/attachments` first and pass `attachment_id`.
+   * The image must already be stored with us. To use an image from elsewhere, upload
+   * it with `POST /v3/attachments` first and pass `attachment_id`.
    *
    * Exactly one of `emoji`, `url` or `attachment_id` is required when type is
    * "sticker".

package/src/resources/shared.ts

@@ -153,9 +153,10 @@ export interface Reaction {
 
   /**
    * Type of reaction. Standard iMessage tapbacks are love, like, dislike, laugh,
-   * emphasize, question. Custom emoji reactions have type "custom" with the actual
-   * emoji in the custom_emoji field. Sticker reactions have type "sticker" with
-   * sticker attachment details in the sticker field.
+   * emphasize, question. Custom tapbacks have type "custom": an emoji tapback
+   * carries the emoji in the custom_emoji field, and an image tapback carries the
+   * image in the sticker field. Sticker reactions have type "sticker" with sticker
+   * attachment details in the sticker field.
    */
   type: ReactionType;
 
@@ -172,21 +173,21 @@ export interface Reaction {
   id?: string;
 
   /**
-   * Custom emoji if type is "custom", null otherwise
+   * Custom emoji if type is "custom" and the tapback is an emoji, null otherwise
    */
   custom_emoji?: string | null;
 
   /**
-   * Sticker attachment details when reaction_type is "sticker". Null for non-sticker
-   * reactions.
+   * The image when type is "sticker", or when type is "custom" and the tapback is an
+   * image. Null otherwise.
    */
   sticker?: Reaction.Sticker | null;
 }
 
 export namespace Reaction {
   /**
-   * Sticker attachment details when reaction_type is "sticker". Null for non-sticker
-   * reactions.
+   * The image when type is "sticker", or when type is "custom" and the tapback is an
+   * image. Null otherwise.
    */
   export interface Sticker {
     /**
@@ -218,9 +219,10 @@ export namespace Reaction {
 
 /**
  * Type of reaction. Standard iMessage tapbacks are love, like, dislike, laugh,
- * emphasize, question. Custom emoji reactions have type "custom" with the actual
- * emoji in the custom_emoji field. Sticker reactions have type "sticker" with
- * sticker attachment details in the sticker field.
+ * emphasize, question. Custom tapbacks have type "custom": an emoji tapback
+ * carries the emoji in the custom_emoji field, and an image tapback carries the
+ * image in the sticker field. Sticker reactions have type "sticker" with sticker
+ * attachment details in the sticker field.
  */
 export type ReactionType =
   | 'love'

package/src/resources/webhooks.ts

@@ -649,9 +649,10 @@ export interface ReactionEventBase {
 
   /**
    * Type of reaction. Standard iMessage tapbacks are love, like, dislike, laugh,
-   * emphasize, question. Custom emoji reactions have type "custom" with the actual
-   * emoji in the custom_emoji field. Sticker reactions have type "sticker" with
-   * sticker attachment details in the sticker field.
+   * emphasize, question. Custom tapbacks have type "custom": an emoji tapback
+   * carries the emoji in the custom_emoji field, and an image tapback carries the
+   * image in the sticker field. Sticker reactions have type "sticker" with sticker
+   * attachment details in the sticker field.
    */
   reaction_type: Shared.ReactionType;
 
@@ -661,7 +662,8 @@ export interface ReactionEventBase {
   chat_id?: string;
 
   /**
-   * The actual emoji when reaction_type is "custom". Null for standard tapbacks.
+   * The actual emoji when reaction_type is "custom" and the tapback is an emoji.
+   * Null otherwise.
    */
   custom_emoji?: string | null;
 
@@ -709,16 +711,16 @@ export interface ReactionEventBase {
   service?: Shared.ServiceType;
 
   /**
-   * Sticker attachment details when reaction_type is "sticker". Null for non-sticker
-   * reactions.
+   * The image when reaction_type is "sticker", or when reaction_type is "custom" and
+   * the tapback is an image. Null otherwise.
    */
   sticker?: ReactionEventBase.Sticker | null;
 }
 
 export namespace ReactionEventBase {
   /**
-   * Sticker attachment details when reaction_type is "sticker". Null for non-sticker
-   * reactions.
+   * The image when reaction_type is "sticker", or when reaction_type is "custom" and
+   * the tapback is an image. Null otherwise.
    */
   export interface Sticker {
     /**

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.81.0'; // x-release-please-version
+export const VERSION = '0.82.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.81.0";
+export declare const VERSION = "0.82.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.81.0";
+export declare const VERSION = "0.82.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.81.0'; // x-release-please-version
+exports.VERSION = '0.82.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.81.0'; // x-release-please-version
+export const VERSION = '0.82.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map