@youmind-openlab/rettiwt-api 1.0.0

package/dist/models/data/Conversation.js

@@ -0,0 +1,293 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Conversation = void 0;
+const DirectMessage_1 = require("./DirectMessage");
+/**
+ * Type guard to check if the response is an IConversationTimelineResponse
+ */
+function isConversationTimelineResponse(response) {
+    return 'conversation_timeline' in response;
+}
+/**
+ * Type guard to check if the response is an IInboxInitialResponse
+ */
+function isInboxInitialResponse(response) {
+    return 'inbox_initial_state' in response;
+}
+/**
+ * Type guard to check if the response is an IInboxTimelineResponse
+ */
+function isInboxTimelineResponse(response) {
+    return 'inbox_timeline' in response;
+}
+/**
+ * Extract typed conversation data from raw conversations object
+ */
+function extractConversationData(rawConversations) {
+    return Object.entries(rawConversations);
+}
+/**
+ * The details of a single conversation.
+ *
+ * @public
+ */
+class Conversation {
+    /** The raw conversation details. */
+    _raw;
+    avatarUrl;
+    hasMore;
+    id;
+    lastActivityAt;
+    lastMessageId;
+    messages;
+    muted;
+    name;
+    notificationsDisabled;
+    participants;
+    trusted;
+    type;
+    /**
+     * @param conversation - The raw conversation details from the API response.
+     * @param messages - Array of messages in this conversation.
+     */
+    constructor(conversation, messages = []) {
+        this._raw = conversation;
+        const conv = conversation;
+        this.id = conv.conversation_id && typeof conv.conversation_id === 'string' ? conv.conversation_id : '';
+        this.type = this._parseConversationType(conv.type);
+        this.participants = this._parseParticipants(conv.participants);
+        this.name = conv.name && typeof conv.name === 'string' ? conv.name : undefined;
+        this.avatarUrl = this._parseAvatarUrl(conv);
+        this.trusted = Boolean(conv.trusted);
+        this.muted = Boolean(conv.muted);
+        this.notificationsDisabled = Boolean(conv.notifications_disabled);
+        this.lastActivityAt = this._parseTimestamp(conv.sort_timestamp);
+        this.lastMessageId =
+            conv.sort_event_id && typeof conv.sort_event_id === 'string' ? conv.sort_event_id : undefined;
+        this.hasMore = conv.status === 'HAS_MORE';
+        this.messages = messages;
+    }
+    /** The raw conversation details. */
+    get raw() {
+        return this._raw;
+    }
+    /**
+     * Parse avatar URL from conversation data
+     */
+    _parseAvatarUrl(conv) {
+        // Try avatar_image_https first
+        if (conv.avatar_image_https && typeof conv.avatar_image_https === 'string') {
+            return conv.avatar_image_https;
+        }
+        // Try nested avatar.image.original_info.url
+        const avatar = conv.avatar;
+        const image = avatar?.image;
+        const originalInfo = image?.original_info;
+        if (originalInfo?.url && typeof originalInfo.url === 'string') {
+            return originalInfo.url;
+        }
+        return undefined;
+    }
+    /**
+     * Parse conversation type with proper fallback
+     */
+    _parseConversationType(type) {
+        if (type === 'ONE_TO_ONE' || type === 'GROUP_DM') {
+            return type;
+        }
+        return 'ONE_TO_ONE';
+    }
+    /**
+     * Parse participants array with type safety
+     */
+    _parseParticipants(participants) {
+        if (!Array.isArray(participants)) {
+            return [];
+        }
+        return participants
+            .map((p) => {
+            if (p && typeof p === 'object' && 'user_id' in p) {
+                // eslint-disable-next-line @typescript-eslint/naming-convention
+                const participantObj = p;
+                if (typeof participantObj.user_id === 'string') {
+                    return participantObj.user_id;
+                }
+            }
+            return '';
+        })
+            .filter(Boolean);
+    }
+    /**
+     * Parse timestamp with proper fallback
+     */
+    _parseTimestamp(timestamp) {
+        if (timestamp && (typeof timestamp === 'string' || typeof timestamp === 'number')) {
+            const date = new Date(Number(timestamp));
+            if (!isNaN(date.getTime())) {
+                return date.toISOString();
+            }
+        }
+        return new Date().toISOString();
+    }
+    /**
+     * Extracts a single conversation from conversation timeline response.
+     *
+     * @param response - The raw response data.
+     *
+     * @returns The deserialized conversation with full message history.
+     */
+    static fromConversationTimeline(response) {
+        if (!response.conversation_timeline?.conversations) {
+            return undefined;
+        }
+        const rawConversations = response.conversation_timeline.conversations;
+        const entries = response.conversation_timeline.entries ?? [];
+        // Extract messages from entries
+        const messages = [];
+        for (const entry of entries) {
+            if ('message' in entry && entry.message) {
+                messages.push(new DirectMessage_1.DirectMessage(entry.message));
+            }
+        }
+        // Get the first (and typically only) conversation
+        const conversationEntries = extractConversationData(rawConversations);
+        const firstEntry = conversationEntries[0];
+        if (firstEntry) {
+            const [, conversationData] = firstEntry;
+            return new Conversation(conversationData, messages);
+        }
+        return undefined;
+    }
+    /**
+     * Extracts conversations from inbox initial state response.
+     *
+     * @param response - The raw response data.
+     *
+     * @returns The deserialized list of conversations with their preview messages.
+     */
+    static listFromInboxInitial(response) {
+        const conversations = [];
+        if (!response.inbox_initial_state?.conversations) {
+            return conversations;
+        }
+        const rawConversations = response.inbox_initial_state.conversations;
+        const entries = response.inbox_initial_state.entries ?? [];
+        // Group messages by conversation ID
+        const messagesByConversation = new Map();
+        for (const entry of entries) {
+            if ('message' in entry && entry.message) {
+                const message = new DirectMessage_1.DirectMessage(entry.message);
+                const convId = message.conversationId;
+                if (convId) {
+                    if (!messagesByConversation.has(convId)) {
+                        messagesByConversation.set(convId, []);
+                    }
+                    messagesByConversation.get(convId).push(message);
+                }
+            }
+        }
+        // Create conversations with their messages
+        const conversationEntries = extractConversationData(rawConversations);
+        for (const [, conversation] of conversationEntries) {
+            const convId = conversation.conversation_id;
+            const messages = messagesByConversation.get(convId) ?? [];
+            conversations.push(new Conversation(conversation, messages));
+        }
+        return conversations;
+    }
+    /**
+     * Extracts conversations from inbox timeline response.
+     *
+     * @param response - The raw response data.
+     *
+     * @returns The deserialized list of conversations with their messages.
+     */
+    static listFromInboxTimeline(response) {
+        const conversations = [];
+        if (!response.inbox_timeline?.conversations) {
+            return conversations;
+        }
+        const rawConversations = response.inbox_timeline.conversations;
+        const entries = response.inbox_timeline.entries ?? [];
+        // Group messages by conversation ID
+        const messagesByConversation = new Map();
+        for (const entry of entries) {
+            if ('message' in entry && entry.message) {
+                const message = new DirectMessage_1.DirectMessage(entry.message);
+                const convId = message.conversationId;
+                if (convId) {
+                    if (!messagesByConversation.has(convId)) {
+                        messagesByConversation.set(convId, []);
+                    }
+                    messagesByConversation.get(convId).push(message);
+                }
+            }
+        }
+        // Create conversations with their messages
+        const conversationEntries = extractConversationData(rawConversations);
+        for (const [, conversation] of conversationEntries) {
+            const convId = conversation.conversation_id;
+            const messages = messagesByConversation.get(convId) ?? [];
+            conversations.push(new Conversation(conversation, messages));
+        }
+        return conversations;
+    }
+    /**
+     * Generic method to extract conversations from any supported response type
+     */
+    static listFromResponse(response) {
+        if (isConversationTimelineResponse(response)) {
+            const conversation = Conversation.fromConversationTimeline(response);
+            return conversation ? [conversation] : [];
+        }
+        else if (isInboxInitialResponse(response)) {
+            return Conversation.listFromInboxInitial(response);
+        }
+        else if (isInboxTimelineResponse(response)) {
+            return Conversation.listFromInboxTimeline(response);
+        }
+        return [];
+    }
+    /**
+     * Get the other participant's ID (only for one-to-one conversations)
+     */
+    getOtherParticipant(currentUserId) {
+        if (!this.isOneToOne() || this.participants.length !== 2) {
+            return undefined;
+        }
+        return this.participants.find((id) => id !== currentUserId);
+    }
+    /**
+     * Check if this conversation is a group DM
+     */
+    isGroupDM() {
+        return this.type === 'GROUP_DM';
+    }
+    /**
+     * Check if this conversation is one-to-one
+     */
+    isOneToOne() {
+        return this.type === 'ONE_TO_ONE';
+    }
+    /**
+     * @returns A serializable JSON representation of `this` object.
+     */
+    toJSON() {
+        return {
+            avatarUrl: this.avatarUrl,
+            hasMore: this.hasMore,
+            id: this.id,
+            lastActivityAt: this.lastActivityAt,
+            lastMessageId: this.lastMessageId,
+            messages: this.messages.map((msg) => msg.toJSON()),
+            muted: this.muted,
+            name: this.name,
+            notificationsDisabled: this.notificationsDisabled,
+            participants: this.participants,
+            trusted: this.trusted,
+            type: this.type,
+        };
+    }
+}
+exports.Conversation = Conversation;
+//# sourceMappingURL=Conversation.js.map

package/dist/models/data/Conversation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Conversation.js","sourceRoot":"","sources":["../../../src/models/data/Conversation.ts"],"names":[],"mappings":"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"}

package/dist/models/data/CursoredData.d.ts

@@ -0,0 +1,27 @@
+import { BaseType } from '../../enums/Data';
+import { ICursoredData } from '../../types/data/CursoredData';
+import { BookmarkFolder } from './BookmarkFolder';
+import { List } from './List';
+import { Notification } from './Notification';
+import { Tweet } from './Tweet';
+import { User } from './User';
+/**
+ * The data that is fetched batch-wise using a cursor.
+ *
+ * @typeParam T - Type of data to be stored.
+ *
+ * @public
+ */
+export declare class CursoredData<T extends Notification | Tweet | User | List | BookmarkFolder> implements ICursoredData<T> {
+    list: T[];
+    next: string;
+    /**
+     * @param response - The raw response.
+     * @param type - The base type of the data included in the batch.
+     */
+    constructor(response: NonNullable<unknown>, type: BaseType);
+    /**
+     * @returns A serializable JSON representation of `this` object.
+     */
+    toJSON(): ICursoredData<T>;
+}

package/dist/models/data/CursoredData.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CursoredData = void 0;
+const Data_1 = require("../../enums/Data");
+const JsonUtils_1 = require("../../helper/JsonUtils");
+const BookmarkFolder_1 = require("./BookmarkFolder");
+const List_1 = require("./List");
+const Notification_1 = require("./Notification");
+const Tweet_1 = require("./Tweet");
+const User_1 = require("./User");
+/**
+ * The data that is fetched batch-wise using a cursor.
+ *
+ * @typeParam T - Type of data to be stored.
+ *
+ * @public
+ */
+class CursoredData {
+    list;
+    next;
+    /**
+     * @param response - The raw response.
+     * @param type - The base type of the data included in the batch.
+     */
+    constructor(response, type) {
+        // Initializing defaults
+        this.list = [];
+        this.next = '';
+        if (type == Data_1.BaseType.TWEET) {
+            this.list = Tweet_1.Tweet.timeline(response);
+            this.next = (0, JsonUtils_1.findByFilter)(response, 'cursorType', 'Bottom')[0]?.value ?? '';
+        }
+        else if (type == Data_1.BaseType.USER) {
+            this.list = User_1.User.timeline(response);
+            this.next = (0, JsonUtils_1.findByFilter)(response, 'cursorType', 'Bottom')[0]?.value ?? '';
+        }
+        else if (type == Data_1.BaseType.LIST) {
+            this.list = List_1.List.timeline(response);
+            this.next = (0, JsonUtils_1.findByFilter)(response, 'cursorType', 'Bottom')[0]?.value ?? '';
+        }
+        else if (type == Data_1.BaseType.NOTIFICATION) {
+            this.list = Notification_1.Notification.list(response);
+            this.next = (0, JsonUtils_1.findByFilter)(response, 'cursorType', 'Bottom')[0]?.value ?? '';
+        }
+        else if (type == Data_1.BaseType.BOOKMARK_FOLDER) {
+            this.list = BookmarkFolder_1.BookmarkFolder.list(response);
+            const sliceInfo = response?.data?.viewer?.user_results?.result
+                ?.bookmark_collections_slice?.slice_info;
+            this.next = sliceInfo?.next_cursor ?? '';
+        }
+    }
+    /**
+     * @returns A serializable JSON representation of `this` object.
+     */
+    toJSON() {
+        return {
+            list: this.list.map((item) => item.toJSON()),
+            next: this.next,
+        };
+    }
+}
+exports.CursoredData = CursoredData;
+//# sourceMappingURL=CursoredData.js.map

package/dist/models/data/CursoredData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CursoredData.js","sourceRoot":"","sources":["../../../src/models/data/CursoredData.ts"],"names":[],"mappings":";;;AAAA,2CAA4C;AAE5C,sDAAsD;AAMtD,qDAAkD;AAClD,iCAA8B;AAC9B,iDAA8C;AAC9C,mCAAgC;AAChC,iCAA8B;AAE9B;;;;;;GAMG;AACH,MAAa,YAAY;IACjB,IAAI,CAAM;IACV,IAAI,CAAS;IAEpB;;;OAGG;IACH,YAAmB,QAA8B,EAAE,IAAc;QAChE,wBAAwB;QACxB,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;QAEf,IAAI,IAAI,IAAI,eAAQ,CAAC,KAAK,EAAE,CAAC;YAC5B,IAAI,CAAC,IAAI,GAAG,aAAK,CAAC,QAAQ,CAAC,QAAQ,CAAQ,CAAC;YAC5C,IAAI,CAAC,IAAI,GAAG,IAAA,wBAAY,EAAa,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;QACxF,CAAC;aAAM,IAAI,IAAI,IAAI,eAAQ,CAAC,IAAI,EAAE,CAAC;YAClC,IAAI,CAAC,IAAI,GAAG,WAAI,CAAC,QAAQ,CAAC,QAAQ,CAAQ,CAAC;YAC3C,IAAI,CAAC,IAAI,GAAG,IAAA,wBAAY,EAAa,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;QACxF,CAAC;aAAM,IAAI,IAAI,IAAI,eAAQ,CAAC,IAAI,EAAE,CAAC;YAClC,IAAI,CAAC,IAAI,GAAG,WAAI,CAAC,QAAQ,CAAC,QAAQ,CAAQ,CAAC;YAC3C,IAAI,CAAC,IAAI,GAAG,IAAA,wBAAY,EAAa,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;QACxF,CAAC;aAAM,IAAI,IAAI,IAAI,eAAQ,CAAC,YAAY,EAAE,CAAC;YAC1C,IAAI,CAAC,IAAI,GAAG,2BAAY,CAAC,IAAI,CAAC,QAAQ,CAAQ,CAAC;YAC/C,IAAI,CAAC,IAAI,GAAG,IAAA,wBAAY,EAAa,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;QACxF,CAAC;aAAM,IAAI,IAAI,IAAI,eAAQ,CAAC,eAAe,EAAE,CAAC;YAC7C,IAAI,CAAC,IAAI,GAAG,+BAAc,CAAC,IAAI,CAAC,QAAQ,CAAQ,CAAC;YACjD,MAAM,SAAS,GAAI,QAAyC,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM;gBAC/F,EAAE,0BAA0B,EAAE,UAAU,CAAC;YAC1C,IAAI,CAAC,IAAI,GAAG,SAAS,EAAE,WAAW,IAAI,EAAE,CAAC;QAC1C,CAAC;IACF,CAAC;IAED;;OAEG;IACI,MAAM;QACZ,OAAO;YACN,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAO,CAAC;YACjD,IAAI,EAAE,IAAI,CAAC,IAAI;SACf,CAAC;IACH,CAAC;CACD;AA1CD,oCA0CC"}

package/dist/models/data/DirectMessage.d.ts

@@ -0,0 +1,105 @@
+import { IDirectMessage } from '../../types/data/DirectMessage';
+import { IMessage as IRawMessage } from '../../types/raw/base/Message';
+import { IConversationTimelineResponse } from '../../types/raw/dm/Conversation';
+import { IInboxInitialResponse } from '../../types/raw/dm/InboxInitial';
+import { IInboxTimelineResponse } from '../../types/raw/dm/InboxTimeline';
+/**
+ * The details of a single direct message.
+ *
+ * @public
+ */
+export declare class DirectMessage implements IDirectMessage {
+    /** The raw message details. */
+    private readonly _raw;
+    conversationId: string;
+    createdAt: string;
+    editCount?: number;
+    id: string;
+    mediaUrls?: string[];
+    read?: boolean;
+    recipientId?: string;
+    senderId: string;
+    text: string;
+    /**
+     * @param message - The raw message details from the API response.
+     */
+    constructor(message: unknown);
+    /** The raw message details. */
+    get raw(): IRawMessage;
+    /**
+     * Extract messages from conversation timeline response
+     */
+    private static _extractFromConversationTimeline;
+    /**
+     * Extract messages from inbox initial response
+     */
+    private static _extractFromInboxInitial;
+    /**
+     * Extract messages from inbox timeline response
+     */
+    private static _extractFromInboxTimeline;
+    /**
+     * Extract media URLs from message attachment data with proper type safety.
+     */
+    private _extractMediaUrls;
+    /**
+     * Safely extract number value
+     */
+    private _extractNumberValue;
+    /**
+     * Safely extract string value with fallback
+     */
+    private _extractStringValue;
+    /**
+     * Parse message data with proper type safety
+     */
+    private _parseMessageData;
+    /**
+     * Parse timestamp with proper validation
+     */
+    private _parseTimestamp;
+    /**
+     * Filter messages by conversation ID
+     */
+    static filterByConversation(messages: DirectMessage[], conversationId: string): DirectMessage[];
+    /**
+     * Filter messages by sender ID
+     */
+    static filterBySender(messages: DirectMessage[], senderId: string): DirectMessage[];
+    /**
+     * Extracts and deserializes the list of direct messages from the given raw response data.
+     *
+     * @param response - The raw response data.
+     *
+     * @returns The deserialized list of direct messages.
+     */
+    static list(response: IInboxInitialResponse | IConversationTimelineResponse | IInboxTimelineResponse): DirectMessage[];
+    /**
+     * Generic method to extract messages from any supported response type
+     */
+    static listFromResponse(response: IInboxInitialResponse | IConversationTimelineResponse | IInboxTimelineResponse): DirectMessage[];
+    /**
+     * Sort messages by creation time (oldest to newest)
+     */
+    static sortByTime(messages: DirectMessage[], ascending?: boolean): DirectMessage[];
+    /**
+     * Get the age of this message in milliseconds
+     */
+    getAgeInMs(): number;
+    /**
+     * Check if this message has media attachments
+     */
+    hasMedia(): boolean;
+    /**
+     * Check if this message is from a specific sender
+     */
+    isFromSender(senderId: string): boolean;
+    /**
+     * @returns A serializable JSON representation of `this` object.
+     */
+    toJSON(): IDirectMessage;
+    /**
+     * Check if this message was edited
+     */
+    wasEdited(): boolean;
+}