@youmind-openlab/rettiwt-api 1.0.0

package/dist/browser/models/data/DirectMessage.js

@@ -0,0 +1,280 @@
+/**
+ * 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 IConversationTimelineResponse
+ */
+function isConversationTimelineResponse(response) {
+    return 'conversation_timeline' in response;
+}
+/**
+ * Type guard to check if the response is an IInboxTimelineResponse
+ */
+function isInboxTimelineResponse(response) {
+    return 'inbox_timeline' in response;
+}
+/**
+ * The details of a single direct message.
+ *
+ * @public
+ */
+export class DirectMessage {
+    /** The raw message details. */
+    _raw;
+    conversationId;
+    createdAt;
+    editCount;
+    id;
+    mediaUrls;
+    read;
+    recipientId;
+    senderId;
+    text;
+    /**
+     * @param message - The raw message details from the API response.
+     */
+    constructor(message) {
+        this._raw = message;
+        const parsedData = this._parseMessageData(message);
+        this.id = parsedData.id;
+        this.conversationId = parsedData.conversationId;
+        this.senderId = parsedData.senderId;
+        this.recipientId = parsedData.recipientId;
+        this.text = parsedData.text;
+        this.createdAt = parsedData.createdAt;
+        this.editCount = parsedData.editCount ?? 0;
+        this.mediaUrls = this._extractMediaUrls(message);
+        this.read = true; // Default to true, can be enhanced later
+    }
+    /** The raw message details. */
+    get raw() {
+        return this._raw;
+    }
+    /**
+     * Extract messages from conversation timeline response
+     */
+    static _extractFromConversationTimeline(response) {
+        const messages = [];
+        const entries = response.conversation_timeline?.entries ?? [];
+        for (const entry of entries) {
+            if ('message' in entry && entry.message) {
+                messages.push(new DirectMessage(entry.message));
+            }
+        }
+        return messages;
+    }
+    /**
+     * Extract messages from inbox initial response
+     */
+    static _extractFromInboxInitial(response) {
+        const messages = [];
+        const entries = response.inbox_initial_state?.entries ?? [];
+        for (const entry of entries) {
+            if ('message' in entry && entry.message) {
+                messages.push(new DirectMessage(entry.message));
+            }
+        }
+        return messages;
+    }
+    /**
+     * Extract messages from inbox timeline response
+     */
+    static _extractFromInboxTimeline(response) {
+        const messages = [];
+        const entries = response.inbox_timeline?.entries ?? [];
+        for (const entry of entries) {
+            if ('message' in entry && entry.message) {
+                messages.push(new DirectMessage(entry.message));
+            }
+        }
+        return messages;
+    }
+    /**
+     * Extract media URLs from message attachment data with proper type safety.
+     */
+    _extractMediaUrls(message) {
+        const urls = [];
+        const msg = message;
+        const messageData = msg.message_data;
+        // Check for card attachments with images
+        const attachment = messageData?.attachment;
+        const card = attachment?.card;
+        const bindingValues = card?.binding_values;
+        if (bindingValues) {
+            // Extract URLs from various image binding values
+            const imageBindings = [
+                'thumbnail_image',
+                'photo_image_full_size',
+                'summary_photo_image',
+                'thumbnail_image_original',
+                'summary_photo_image_original',
+                'photo_image_full_size_original',
+            ];
+            for (const bindingKey of imageBindings) {
+                const imageBinding = bindingValues[bindingKey];
+                const imageValue = imageBinding?.image_value;
+                if (imageValue?.url && typeof imageValue.url === 'string') {
+                    urls.push(imageValue.url);
+                }
+            }
+        }
+        // Check for tweet attachments
+        const tweet = attachment?.tweet;
+        if (tweet?.expanded_url && typeof tweet.expanded_url === 'string') {
+            urls.push(tweet.expanded_url);
+        }
+        return urls.length > 0 ? [...new Set(urls)] : undefined; // Remove duplicates
+    }
+    /**
+     * Safely extract number value
+     */
+    _extractNumberValue(value) {
+        if (typeof value === 'number') {
+            return value;
+        }
+        if (typeof value === 'string') {
+            const parsed = Number(value);
+            return isNaN(parsed) ? undefined : parsed;
+        }
+        return undefined;
+    }
+    /**
+     * Safely extract string value with fallback
+     */
+    _extractStringValue(...values) {
+        for (const value of values) {
+            if (typeof value === 'string' && value.length > 0) {
+                return value;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Parse message data with proper type safety
+     */
+    _parseMessageData(message) {
+        const msg = message;
+        const messageData = msg.message_data;
+        const id = this._extractStringValue(messageData?.id, msg.id) ?? '';
+        const conversationId = this._extractStringValue(msg.conversation_id, messageData?.conversation_id) ?? '';
+        const senderId = this._extractStringValue(messageData?.sender_id, msg.sender_id) ?? '';
+        const recipientId = this._extractStringValue(messageData?.recipient_id, msg.recipient_id);
+        const text = this._extractStringValue(messageData?.text, msg.text) ?? '';
+        const createdAt = this._parseTimestamp(this._extractStringValue(messageData?.time, msg.time) ?? '');
+        const editCount = this._extractNumberValue(messageData?.edit_count);
+        return {
+            id,
+            conversationId,
+            senderId,
+            recipientId,
+            createdAt,
+            text,
+            editCount,
+        };
+    }
+    /**
+     * Parse timestamp with proper validation
+     */
+    _parseTimestamp(timestamp) {
+        const numericTimestamp = Number(timestamp);
+        if (!isNaN(numericTimestamp)) {
+            const date = new Date(numericTimestamp);
+            if (!isNaN(date.getTime())) {
+                return date.toISOString();
+            }
+        }
+        return new Date().toISOString();
+    }
+    /**
+     * Filter messages by conversation ID
+     */
+    static filterByConversation(messages, conversationId) {
+        return messages.filter((message) => message.conversationId === conversationId);
+    }
+    /**
+     * Filter messages by sender ID
+     */
+    static filterBySender(messages, senderId) {
+        return messages.filter((message) => message.isFromSender(senderId));
+    }
+    /**
+     * 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) {
+        const messages = [];
+        if (isInboxInitialResponse(response)) {
+            return DirectMessage._extractFromInboxInitial(response);
+        }
+        else if (isConversationTimelineResponse(response)) {
+            return DirectMessage._extractFromConversationTimeline(response);
+        }
+        else if (isInboxTimelineResponse(response)) {
+            return DirectMessage._extractFromInboxTimeline(response);
+        }
+        return messages;
+    }
+    /**
+     * Generic method to extract messages from any supported response type
+     */
+    static listFromResponse(response) {
+        return DirectMessage.list(response);
+    }
+    /**
+     * Sort messages by creation time (oldest to newest)
+     */
+    static sortByTime(messages, ascending = true) {
+        return [...messages].sort((a, b) => {
+            const timeA = new Date(a.createdAt).getTime();
+            const timeB = new Date(b.createdAt).getTime();
+            return ascending ? timeA - timeB : timeB - timeA;
+        });
+    }
+    /**
+     * Get the age of this message in milliseconds
+     */
+    getAgeInMs() {
+        return Date.now() - new Date(this.createdAt).getTime();
+    }
+    /**
+     * Check if this message has media attachments
+     */
+    hasMedia() {
+        return Boolean(this.mediaUrls && this.mediaUrls.length > 0);
+    }
+    /**
+     * Check if this message is from a specific sender
+     */
+    isFromSender(senderId) {
+        return this.senderId === senderId;
+    }
+    /**
+     * @returns A serializable JSON representation of `this` object.
+     */
+    toJSON() {
+        return {
+            conversationId: this.conversationId,
+            createdAt: this.createdAt,
+            editCount: this.editCount,
+            id: this.id,
+            mediaUrls: this.mediaUrls,
+            read: this.read,
+            recipientId: this.recipientId,
+            senderId: this.senderId,
+            text: this.text,
+        };
+    }
+    /**
+     * Check if this message was edited
+     */
+    wasEdited() {
+        return Boolean(this.editCount && this.editCount > 0);
+    }
+}
+//# sourceMappingURL=DirectMessage.js.map

package/dist/browser/models/data/DirectMessage.js.map

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

package/dist/browser/models/data/Inbox.d.ts

@@ -0,0 +1,44 @@
+import { IInbox } from '../../types/data/Inbox';
+import { IInboxInitialResponse } from '../../types/raw/dm/InboxInitial';
+import { IInboxTimelineResponse } from '../../types/raw/dm/InboxTimeline';
+import { Conversation } from './Conversation';
+/**
+ * The details of a DM inbox containing conversations and metadata.
+ *
+ * @public
+ */
+export declare class Inbox implements IInbox {
+    /** The raw inbox details. */
+    private readonly _raw;
+    conversations: Conversation[];
+    cursor: string;
+    lastSeenEventId: string;
+    trustedLastSeenEventId: string;
+    untrustedLastSeenEventId: string;
+    /**
+     * @param response - The raw inbox response from the API.
+     */
+    constructor(response: IInboxInitialResponse | IInboxTimelineResponse);
+    /** The raw inbox details. */
+    get raw(): IInboxInitialResponse | IInboxTimelineResponse;
+    /**
+     * Get the raw inbox initial state if this inbox was created from one
+     */
+    getInitialState(): IInboxInitialResponse | undefined;
+    /**
+     * Get the raw inbox timeline if this inbox was created from one
+     */
+    getTimeline(): IInboxTimelineResponse | undefined;
+    /**
+     * Check if this inbox was created from an initial state response
+     */
+    isInitialState(): boolean;
+    /**
+     * Check if this inbox was created from a timeline response
+     */
+    isTimeline(): boolean;
+    /**
+     * @returns A serializable JSON representation of `this` object.
+     */
+    toJSON(): IInbox;
+}

package/dist/browser/models/data/Inbox.js

@@ -0,0 +1,102 @@
+import { Conversation } from './Conversation';
+/**
+ * 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;
+}
+/**
+ * The details of a DM inbox containing conversations and metadata.
+ *
+ * @public
+ */
+export class Inbox {
+    /** The raw inbox details. */
+    _raw;
+    conversations;
+    cursor;
+    lastSeenEventId;
+    trustedLastSeenEventId;
+    untrustedLastSeenEventId;
+    /**
+     * @param response - The raw inbox response from the API.
+     */
+    constructor(response) {
+        this._raw = response;
+        // Handle inbox initial state response
+        if (isInboxInitialResponse(response)) {
+            const inboxState = response.inbox_initial_state;
+            this.cursor = inboxState.cursor ?? '';
+            this.lastSeenEventId = inboxState.last_seen_event_id ?? '';
+            this.trustedLastSeenEventId = inboxState.trusted_last_seen_event_id ?? '';
+            this.untrustedLastSeenEventId = inboxState.untrusted_last_seen_event_id ?? '';
+            // Parse conversations from inbox initial state
+            this.conversations = Conversation.listFromInboxInitial(response);
+        }
+        // Handle inbox timeline response
+        else if (isInboxTimelineResponse(response)) {
+            const inboxTimeline = response.inbox_timeline;
+            this.cursor = inboxTimeline.min_entry_id ?? '';
+            this.lastSeenEventId = '';
+            this.trustedLastSeenEventId = '';
+            this.untrustedLastSeenEventId = '';
+            // Parse conversations from inbox timeline
+            this.conversations = Conversation.listFromInboxTimeline(response);
+        }
+        else {
+            // Fallback defaults (this should never happen with proper typing)
+            this.cursor = '';
+            this.lastSeenEventId = '';
+            this.trustedLastSeenEventId = '';
+            this.untrustedLastSeenEventId = '';
+            this.conversations = [];
+        }
+    }
+    /** The raw inbox details. */
+    get raw() {
+        return this._raw;
+    }
+    /**
+     * Get the raw inbox initial state if this inbox was created from one
+     */
+    getInitialState() {
+        return this.isInitialState() ? this._raw : undefined;
+    }
+    /**
+     * Get the raw inbox timeline if this inbox was created from one
+     */
+    getTimeline() {
+        return this.isTimeline() ? this._raw : undefined;
+    }
+    /**
+     * Check if this inbox was created from an initial state response
+     */
+    isInitialState() {
+        return isInboxInitialResponse(this._raw);
+    }
+    /**
+     * Check if this inbox was created from a timeline response
+     */
+    isTimeline() {
+        return isInboxTimelineResponse(this._raw);
+    }
+    /**
+     * @returns A serializable JSON representation of `this` object.
+     */
+    toJSON() {
+        return {
+            conversations: this.conversations.map((conv) => conv.toJSON()),
+            cursor: this.cursor,
+            lastSeenEventId: this.lastSeenEventId,
+            trustedLastSeenEventId: this.trustedLastSeenEventId,
+            untrustedLastSeenEventId: this.untrustedLastSeenEventId,
+        };
+    }
+}
+//# sourceMappingURL=Inbox.js.map

package/dist/browser/models/data/Inbox.js.map

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

package/dist/browser/models/data/List.d.ts

@@ -0,0 +1,48 @@
+import { IList } from '../../types/data/List';
+import { IList as IRawList } from '../../types/raw/base/List';
+import { IListDetailsResponse } from '../../types/raw/list/Details';
+/**
+ * The details of a single Twitter List.
+ *
+ * @public
+ */
+export declare class List implements IList {
+    /** The raw list details. */
+    private readonly _raw;
+    createdAt: string;
+    createdBy: string;
+    description?: string;
+    id: string;
+    isFollowing: boolean;
+    isMember: boolean;
+    memberCount: number;
+    name: string;
+    subscriberCount: number;
+    /**
+     * @param list - The raw list details.
+     */
+    constructor(list: IRawList);
+    /** The raw list details. */
+    get raw(): IRawList;
+    /**
+     * Extracts and deserializes a single target list from the given raw response data.
+     *
+     * @param response - The raw response data.
+     * @param id - The id of the target list.
+     *
+     * @returns The target deserialized list.
+     */
+    static single(response: IListDetailsResponse, id: string): List | undefined;
+    /**
+     * Extracts and deserializes the timeline of lists followed from the given raw response data.
+     *
+     * @param response - The raw response data.
+     *
+     * @returns The deserialized timeline of lists.
+     */
+    static timeline(response: NonNullable<unknown>): List[];
+    /**
+     * @returns A serializable JSON representation of `this` object.
+     */
+    toJSON(): IList;
+}

package/dist/browser/models/data/List.js

@@ -0,0 +1,97 @@
+import { LogActions } from '../../enums/Logging';
+import { findByFilter } from '../../helper/JsonUtils';
+import { LogService } from '../../services/internal/LogService';
+/**
+ * The details of a single Twitter List.
+ *
+ * @public
+ */
+export class List {
+    /** The raw list details. */
+    _raw;
+    createdAt;
+    createdBy;
+    description;
+    id;
+    isFollowing;
+    isMember;
+    memberCount;
+    name;
+    subscriberCount;
+    /**
+     * @param list - The raw list details.
+     */
+    constructor(list) {
+        this._raw = { ...list };
+        this.id = list.id_str;
+        this.name = list.name;
+        this.createdAt = new Date(list.created_at).toISOString();
+        this.description = list.description.length ? list.description : undefined;
+        this.isFollowing = list.following;
+        this.isMember = list.is_member;
+        this.memberCount = list.member_count;
+        this.subscriberCount = list.subscriber_count;
+        this.createdBy = list.user_results.result.rest_id;
+    }
+    /** The raw list details. */
+    get raw() {
+        return { ...this._raw };
+    }
+    /**
+     * Extracts and deserializes a single target list from the given raw response data.
+     *
+     * @param response - The raw response data.
+     * @param id - The id of the target list.
+     *
+     * @returns The target deserialized list.
+     */
+    static single(response, id) {
+        // If list found
+        if (response.data.list.id_str === id) {
+            return new List(response.data.list);
+        }
+        // If not found
+        else {
+            return undefined;
+        }
+    }
+    /**
+     * Extracts and deserializes the timeline of lists followed from the given raw response data.
+     *
+     * @param response - The raw response data.
+     *
+     * @returns The deserialized timeline of lists.
+     */
+    static timeline(response) {
+        const lists = [];
+        // Extracting the matching data
+        const extract = findByFilter(response, '__typename', 'TimelineTwitterList').map((item) => item.list);
+        // Deserializing valid data
+        for (const item of extract) {
+            // If valid list
+            if (item !== undefined && item.id !== undefined && item.following === true) {
+                // Logging
+                LogService.log(LogActions.DESERIALIZE, { id: item.id });
+                lists.push(new List(item));
+            }
+        }
+        return lists;
+    }
+    /**
+     * @returns A serializable JSON representation of `this` object.
+     */
+    toJSON() {
+        return {
+            createdAt: this.createdAt,
+            createdBy: this.createdBy,
+            description: this.description,
+            id: this.id,
+            isFollowing: this.isFollowing,
+            isMember: this.isMember,
+            memberCount: this.memberCount,
+            name: this.name,
+            subscriberCount: this.subscriberCount,
+        };
+    }
+}
+//# sourceMappingURL=List.js.map

package/dist/browser/models/data/List.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"List.js","sourceRoot":"","sources":["../../../../src/models/data/List.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAMhE;;;;GAIG;AACH,MAAM,OAAO,IAAI;IAChB,4BAA4B;IACX,IAAI,CAAW;IAEzB,SAAS,CAAS;IAClB,SAAS,CAAS;IAClB,WAAW,CAAU;IACrB,EAAE,CAAS;IACX,WAAW,CAAU;IACrB,QAAQ,CAAU;IAClB,WAAW,CAAS;IACpB,IAAI,CAAS;IACb,eAAe,CAAS;IAE/B;;OAEG;IACH,YAAmB,IAAc;QAChC,IAAI,CAAC,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;QACxB,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;QACzD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1E,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAC/B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC;QACrC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,gBAAgB,CAAC;QAC7C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC;IACnD,CAAC;IAED,4BAA4B;IAC5B,IAAW,GAAG;QACb,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;IAED;;;;;;;OAOG;IACI,MAAM,CAAC,MAAM,CAAC,QAA8B,EAAE,EAAU;QAC9D,gBAAgB;QAChB,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;YACtC,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAA2B,CAAC,CAAC;QAC5D,CAAC;QACD,eAAe;aACV,CAAC;YACL,OAAO,SAAS,CAAC;QAClB,CAAC;IACF,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,QAAQ,CAAC,QAA8B;QACpD,MAAM,KAAK,GAAW,EAAE,CAAC;QAEzB,+BAA+B;QAC/B,MAAM,OAAO,GAAG,YAAY,CAAgB,QAAQ,EAAE,YAAY,EAAE,qBAAqB,CAAC,CAAC,GAAG,CAC7F,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CACnB,CAAC;QAEF,2BAA2B;QAC3B,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC5B,gBAAgB;YAChB,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,EAAE,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;gBAC5E,UAAU;gBACV,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;gBAExD,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAC5B,CAAC;QACF,CAAC;QAED,OAAO,KAAK,CAAC;IACd,CAAC;IAED;;OAEG;IACI,MAAM;QACZ,OAAO;YACN,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,eAAe,EAAE,IAAI,CAAC,eAAe;SACrC,CAAC;IACH,CAAC;CACD"}

package/dist/browser/models/data/Notification.d.ts

@@ -0,0 +1,36 @@
+import { NotificationType } from '../../enums/Notification';
+import { INotification } from '../../types/data/Notification';
+import { INotification as IRawNotification } from '../../types/raw/base/Notification';
+/**
+ * The details of a single notification.
+ *
+ * @public
+ */
+export declare class Notification implements INotification {
+    /** The raw notification details. */
+    private readonly _raw;
+    from: string[];
+    id: string;
+    message: string;
+    receivedAt: string;
+    target: string[];
+    type?: NotificationType;
+    /**
+     * @param notification - The raw notification details.
+     */
+    constructor(notification: IRawNotification);
+    /** The raw notification details. */
+    get raw(): IRawNotification;
+    /**
+     * Extracts and deserializes the list of notifications from the given raw response data.
+     *
+     * @param response - The raw response data.
+     *
+     * @returns The deserialized list of notifications.
+     */
+    static list(response: NonNullable<unknown>): Notification[];
+    /**
+     * @returns A serializable JSON representation of `this` object.
+     */
+    toJSON(): INotification;
+}