@the-convocation/twitter-scraper 0.0.8

package/dist/search.js

@@ -0,0 +1,84 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { addApiParams, requestApi } from './api';
+import { parseTweets, parseUsers, } from './timeline';
+import { getTweetTimeline, getUserTimeline } from './timeline-async';
+/**
+ * The categories that can be used in Twitter searches.
+ */
+export var SearchMode;
+(function (SearchMode) {
+    SearchMode[SearchMode["Top"] = 0] = "Top";
+    SearchMode[SearchMode["Latest"] = 1] = "Latest";
+    SearchMode[SearchMode["Photos"] = 2] = "Photos";
+    SearchMode[SearchMode["Videos"] = 3] = "Videos";
+    SearchMode[SearchMode["Users"] = 4] = "Users";
+})(SearchMode || (SearchMode = {}));
+export function searchTweets(query, maxTweets, includeReplies, searchMode, auth) {
+    return getTweetTimeline(query, maxTweets, (q, mt, c) => {
+        return fetchSearchTweets(q, mt, includeReplies, searchMode, auth, c);
+    });
+}
+export function searchProfiles(query, maxProfiles, auth) {
+    return getUserTimeline(query, maxProfiles, (q, mt, c) => {
+        return fetchSearchProfiles(q, mt, auth, c);
+    });
+}
+export function fetchSearchTweets(query, maxTweets, includeReplies, searchMode, auth, cursor) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const timeline = yield getSearchTimeline(query, maxTweets, includeReplies, searchMode, auth, cursor);
+        return parseTweets(timeline);
+    });
+}
+export function fetchSearchProfiles(query, maxProfiles, auth, cursor) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const timeline = yield getSearchTimeline(query, maxProfiles, false, SearchMode.Users, auth, cursor);
+        return parseUsers(timeline);
+    });
+}
+function getSearchTimeline(query, maxItems, includeReplies, searchMode, auth, cursor) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (maxItems > 50) {
+            maxItems = 50;
+        }
+        const params = new URLSearchParams();
+        addApiParams(params, includeReplies);
+        params.set('q', query);
+        params.set('count', `${maxItems}`);
+        params.set('query_source', 'typed_query');
+        params.set('pc', '1');
+        params.set('spelling_corrections', '1');
+        if (cursor != null && cursor != '') {
+            params.set('cursor', cursor);
+        }
+        switch (searchMode) {
+            case SearchMode.Latest:
+                params.set('tweet_search_mode', 'live');
+                break;
+            case SearchMode.Photos:
+                params.set('result_filter', 'image');
+                break;
+            case SearchMode.Videos:
+                params.set('result_filter', 'video');
+                break;
+            case SearchMode.Users:
+                params.set('result_filter', 'user');
+                break;
+            default:
+                break;
+        }
+        const res = yield requestApi(`https://twitter.com/i/api/2/search/adaptive.json?${params.toString()}`, auth);
+        if (!res.success) {
+            throw res.err;
+        }
+        return res.value;
+    });
+}
+//# sourceMappingURL=search.js.map

package/dist/search.js.map

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

package/dist/timeline-async.js

@@ -0,0 +1,59 @@
+var __await = (this && this.__await) || function (v) { return this instanceof __await ? (this.v = v, this) : new __await(v); }
+var __asyncGenerator = (this && this.__asyncGenerator) || function (thisArg, _arguments, generator) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var g = generator.apply(thisArg, _arguments || []), i, q = [];
+    return i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i;
+    function verb(n) { if (g[n]) i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; }
+    function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }
+    function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }
+    function fulfill(value) { resume("next", value); }
+    function reject(value) { resume("throw", value); }
+    function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }
+};
+export function getUserTimeline(query, maxProfiles, fetchFunc) {
+    return __asyncGenerator(this, arguments, function* getUserTimeline_1() {
+        let nProfiles = 0;
+        let cursor = undefined;
+        while (nProfiles < maxProfiles) {
+            const batch = yield __await(fetchFunc(query, maxProfiles, cursor));
+            const { profiles, next } = batch;
+            if (profiles.length === 0) {
+                break;
+            }
+            for (const profile of profiles) {
+                if (nProfiles < maxProfiles) {
+                    cursor = next;
+                    yield yield __await(profile);
+                }
+                else {
+                    break;
+                }
+                nProfiles++;
+            }
+        }
+    });
+}
+export function getTweetTimeline(query, maxTweets, fetchFunc) {
+    return __asyncGenerator(this, arguments, function* getTweetTimeline_1() {
+        let nTweets = 0;
+        let cursor = undefined;
+        while (nTweets < maxTweets) {
+            const batch = yield __await(fetchFunc(query, maxTweets, cursor));
+            const { tweets, next } = batch;
+            if (tweets.length === 0) {
+                break;
+            }
+            for (const tweet of tweets) {
+                if (nTweets < maxTweets) {
+                    cursor = next;
+                    yield yield __await(tweet);
+                }
+                else {
+                    break;
+                }
+                nTweets++;
+            }
+        }
+    });
+}
+//# sourceMappingURL=timeline-async.js.map

package/dist/timeline-async.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-async.js","sourceRoot":"","sources":["../src/timeline-async.ts"],"names":[],"mappings":";;;;;;;;;;;;AAyBA,MAAM,UAAiB,eAAe,CACpC,KAAa,EACb,WAAmB,EACnB,SAAwB;;QAExB,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,MAAM,GAAuB,SAAS,CAAC;QAC3C,OAAO,SAAS,GAAG,WAAW,EAAE;YAC9B,MAAM,KAAK,GAA0B,cAAM,SAAS,CAClD,KAAK,EACL,WAAW,EACX,MAAM,CACP,CAAA,CAAC;YAEF,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;YAEjC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE;gBACzB,MAAM;aACP;YAED,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE;gBAC9B,IAAI,SAAS,GAAG,WAAW,EAAE;oBAC3B,MAAM,GAAG,IAAI,CAAC;oBACd,oBAAM,OAAO,CAAA,CAAC;iBACf;qBAAM;oBACL,MAAM;iBACP;gBAED,SAAS,EAAE,CAAC;aACb;SACF;IACH,CAAC;CAAA;AAED,MAAM,UAAiB,gBAAgB,CACrC,KAAa,EACb,SAAiB,EACjB,SAAsB;;QAEtB,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,IAAI,MAAM,GAAuB,SAAS,CAAC;QAC3C,OAAO,OAAO,GAAG,SAAS,EAAE;YAC1B,MAAM,KAAK,GAAwB,cAAM,SAAS,CAChD,KAAK,EACL,SAAS,EACT,MAAM,CACP,CAAA,CAAC;YAEF,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;YAE/B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE;gBACvB,MAAM;aACP;YAED,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE;gBAC1B,IAAI,OAAO,GAAG,SAAS,EAAE;oBACvB,MAAM,GAAG,IAAI,CAAC;oBACd,oBAAM,KAAK,CAAA,CAAC;iBACb;qBAAM;oBACL,MAAM;iBACP;gBAED,OAAO,EAAE,CAAC;aACX;SACF;IACH,CAAC;CAAA"}

package/dist/timeline.js

@@ -0,0 +1,228 @@
+import { parseProfile } from './profile';
+const reHashtag = /\B(\#\S+\b)/g;
+const reTwitterUrl = /https:(\/\/t\.co\/([A-Za-z0-9]|[A-Za-z]){10})/g;
+const reUsername = /\B(\@\S{1,15}\b)/g;
+export function parseTweet(timeline, id) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q;
+    const tweets = (_b = (_a = timeline.globalObjects) === null || _a === void 0 ? void 0 : _a.tweets) !== null && _b !== void 0 ? _b : {};
+    const tweet = tweets[id];
+    if (tweet == null || tweet.user_id_str == null) {
+        return null;
+    }
+    const users = (_d = (_c = timeline.globalObjects) === null || _c === void 0 ? void 0 : _c.users) !== null && _d !== void 0 ? _d : {};
+    const user = users[tweet.user_id_str];
+    const username = user === null || user === void 0 ? void 0 : user.screen_name;
+    if (user == null || username == null) {
+        // TODO: change the return type to a result, and return an error; this shouldn't happen, but we don't know what data we're dealing with.
+        return null;
+    }
+    const tw = {
+        id,
+        hashtags: [],
+        likes: tweet.favorite_count,
+        permanentUrl: `https://twitter.com/${username}/status/${id}`,
+        photos: [],
+        replies: tweet.reply_count,
+        retweets: tweet.retweet_count,
+        text: tweet.full_text,
+        urls: [],
+        userId: tweet.user_id_str,
+        username,
+        videos: [],
+    };
+    if (tweet.created_at != null) {
+        tw.timeParsed = new Date(Date.parse(tweet.created_at));
+        tw.timestamp = Math.floor(tw.timeParsed.valueOf() / 1000);
+    }
+    if (((_e = tweet.place) === null || _e === void 0 ? void 0 : _e.id) != null) {
+        tw.place = tweet.place;
+    }
+    if (tweet.quoted_status_id_str != null) {
+        const quotedStatus = parseTweet(timeline, tweet.quoted_status_id_str);
+        if (quotedStatus != null) {
+            tw.isQuoted = true;
+            tw.quotedStatus = quotedStatus;
+        }
+    }
+    if (tweet.in_reply_to_status_id_str != null) {
+        const replyStatus = parseTweet(timeline, tweet.in_reply_to_status_id_str);
+        if (replyStatus != null) {
+            tw.isReply = true;
+            tw.inReplyToStatus = replyStatus;
+        }
+    }
+    if (tweet.retweeted_status_id_str != null) {
+        const retweetedStatus = parseTweet(timeline, tweet.retweeted_status_id_str);
+        if (retweetedStatus != null) {
+            tw.isRetweet = true;
+            tw.retweetedStatus = retweetedStatus;
+        }
+    }
+    const pinnedTweets = (_f = user.pinned_tweet_ids_str) !== null && _f !== void 0 ? _f : [];
+    for (const pinned of pinnedTweets) {
+        if (tweet.conversation_id_str == pinned) {
+            tw.isPin = true;
+            break;
+        }
+    }
+    const hashtags = (_h = (_g = tweet.entities) === null || _g === void 0 ? void 0 : _g.hashtags) !== null && _h !== void 0 ? _h : [];
+    for (const hashtag of hashtags) {
+        if (hashtag.text != null) {
+            tw.hashtags.push(hashtag.text);
+        }
+    }
+    const media = (_k = (_j = tweet.extended_entities) === null || _j === void 0 ? void 0 : _j.media) !== null && _k !== void 0 ? _k : [];
+    for (const m of media) {
+        if (m.media_url_https == null) {
+            continue;
+        }
+        if (m.type === 'photo') {
+            tw.photos.push(m.media_url_https);
+        }
+        else if (m.type === 'video' && m.id_str != null) {
+            const video = {
+                id: m.id_str,
+                preview: m.media_url_https,
+            };
+            let maxBitrate = 0;
+            const variants = (_m = (_l = m.video_info) === null || _l === void 0 ? void 0 : _l.variants) !== null && _m !== void 0 ? _m : [];
+            for (const variant of variants) {
+                const bitrate = variant.bitrate;
+                if (bitrate != null && bitrate > maxBitrate && variant.url != null) {
+                    let variantUrl = variant.url;
+                    const stringStart = 0;
+                    const tagSuffixIdx = variantUrl.indexOf('?tag=10');
+                    if (tagSuffixIdx !== -1) {
+                        variantUrl = variantUrl.substring(stringStart, tagSuffixIdx + 1);
+                    }
+                    video.url = variantUrl;
+                    maxBitrate = bitrate;
+                }
+            }
+            tw.photos.push(video.preview);
+            tw.videos.push(video);
+        }
+        const sensitive = m.ext_sensitive_media_warning;
+        if (sensitive != null) {
+            tw.sensitiveContent =
+                sensitive.adult_content ||
+                    sensitive.graphic_violence ||
+                    sensitive.other;
+        }
+    }
+    const urls = (_p = (_o = tweet.entities) === null || _o === void 0 ? void 0 : _o.urls) !== null && _p !== void 0 ? _p : [];
+    for (const url of urls) {
+        if ((url === null || url === void 0 ? void 0 : url.expanded_url) != null) {
+            tw.urls.push(url.expanded_url);
+        }
+    }
+    // HTML parsing with regex :)
+    let html = (_q = tweet.full_text) !== null && _q !== void 0 ? _q : '';
+    html = html.replace(reHashtag, (hashtag) => {
+        return `<a href="https://twitter.com/hashtag/${hashtag.replace('#', '')}">${hashtag}</a>`;
+    });
+    html = html.replace(reUsername, (username) => {
+        return `<a href="https://twitter.com/${username[0].replace('@', '')}">${username[0]}</a>`;
+    });
+    const foundedMedia = [];
+    html = html.replace(reTwitterUrl, (tco) => {
+        var _a, _b, _c, _d;
+        for (const entity of (_b = (_a = tweet.entities) === null || _a === void 0 ? void 0 : _a.urls) !== null && _b !== void 0 ? _b : []) {
+            if (tco === entity.url && entity.expanded_url != null) {
+                return `<a href="${entity.expanded_url}">${tco}</a>`;
+            }
+        }
+        for (const entity of (_d = (_c = tweet.extended_entities) === null || _c === void 0 ? void 0 : _c.media) !== null && _d !== void 0 ? _d : []) {
+            if (tco === entity.url && entity.media_url_https != null) {
+                foundedMedia.push(entity.media_url_https);
+                return `<br><a href="${tco}"><img src="${entity.media_url_https}"/></a>`;
+            }
+        }
+        return tco;
+    });
+    for (const url of tw.photos) {
+        if (foundedMedia.indexOf(url) !== -1) {
+            continue;
+        }
+        html += `<br><img src="${url}"/>`;
+    }
+    html = html.replace(/\n/g, '<br>');
+    tw.html = html;
+    return tw;
+}
+export function parseTweets(timeline) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w;
+    let cursor;
+    let pinnedTweet;
+    let orderedTweets = [];
+    for (const instruction of (_b = (_a = timeline.timeline) === null || _a === void 0 ? void 0 : _a.instructions) !== null && _b !== void 0 ? _b : []) {
+        const pinnedTweetId = (_h = (_g = (_f = (_e = (_d = (_c = instruction.pinEntry) === null || _c === void 0 ? void 0 : _c.entry) === null || _d === void 0 ? void 0 : _d.content) === null || _e === void 0 ? void 0 : _e.item) === null || _f === void 0 ? void 0 : _f.content) === null || _g === void 0 ? void 0 : _g.tweet) === null || _h === void 0 ? void 0 : _h.id;
+        if (pinnedTweetId != null) {
+            const tweet = parseTweet(timeline, pinnedTweetId);
+            if (tweet != null) {
+                pinnedTweet = tweet;
+            }
+        }
+        for (const entry of (_k = (_j = instruction.addEntries) === null || _j === void 0 ? void 0 : _j.entries) !== null && _k !== void 0 ? _k : []) {
+            const tweetId = (_p = (_o = (_m = (_l = entry.content) === null || _l === void 0 ? void 0 : _l.item) === null || _m === void 0 ? void 0 : _m.content) === null || _o === void 0 ? void 0 : _o.tweet) === null || _p === void 0 ? void 0 : _p.id;
+            if (tweetId != null) {
+                const tweet = parseTweet(timeline, tweetId);
+                if (tweet != null) {
+                    orderedTweets.push(tweet);
+                }
+            }
+            const operation = (_q = entry.content) === null || _q === void 0 ? void 0 : _q.operation;
+            if (((_r = operation === null || operation === void 0 ? void 0 : operation.cursor) === null || _r === void 0 ? void 0 : _r.cursorType) === 'Bottom') {
+                cursor = (_s = operation === null || operation === void 0 ? void 0 : operation.cursor) === null || _s === void 0 ? void 0 : _s.value;
+            }
+        }
+        const operation = (_v = (_u = (_t = instruction.replaceEntry) === null || _t === void 0 ? void 0 : _t.entry) === null || _u === void 0 ? void 0 : _u.content) === null || _v === void 0 ? void 0 : _v.operation;
+        if (((_w = operation === null || operation === void 0 ? void 0 : operation.cursor) === null || _w === void 0 ? void 0 : _w.cursorType) === 'Bottom') {
+            cursor = operation.cursor.value;
+        }
+    }
+    if (pinnedTweet != null && orderedTweets.length > 0) {
+        orderedTweets = [pinnedTweet, ...orderedTweets];
+    }
+    return {
+        tweets: orderedTweets,
+        next: cursor,
+    };
+}
+export function parseUsers(timeline) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s;
+    const users = new Map();
+    const userObjects = (_b = (_a = timeline.globalObjects) === null || _a === void 0 ? void 0 : _a.users) !== null && _b !== void 0 ? _b : {};
+    for (const id in userObjects) {
+        const legacy = userObjects[id];
+        if (legacy == null) {
+            continue;
+        }
+        const user = parseProfile(legacy);
+        users.set(id, user);
+    }
+    let cursor;
+    const orderedProfiles = [];
+    for (const instruction of (_d = (_c = timeline.timeline) === null || _c === void 0 ? void 0 : _c.instructions) !== null && _d !== void 0 ? _d : []) {
+        for (const entry of (_f = (_e = instruction.addEntries) === null || _e === void 0 ? void 0 : _e.entries) !== null && _f !== void 0 ? _f : []) {
+            const userId = (_k = (_j = (_h = (_g = entry.content) === null || _g === void 0 ? void 0 : _g.item) === null || _h === void 0 ? void 0 : _h.content) === null || _j === void 0 ? void 0 : _j.user) === null || _k === void 0 ? void 0 : _k.id;
+            const profile = users.get(userId);
+            if (profile != null) {
+                orderedProfiles.push(profile);
+            }
+            const operation = (_l = entry.content) === null || _l === void 0 ? void 0 : _l.operation;
+            if (((_m = operation === null || operation === void 0 ? void 0 : operation.cursor) === null || _m === void 0 ? void 0 : _m.cursorType) === 'Bottom') {
+                cursor = (_o = operation === null || operation === void 0 ? void 0 : operation.cursor) === null || _o === void 0 ? void 0 : _o.value;
+            }
+        }
+        const operation = (_r = (_q = (_p = instruction.replaceEntry) === null || _p === void 0 ? void 0 : _p.entry) === null || _q === void 0 ? void 0 : _q.content) === null || _r === void 0 ? void 0 : _r.operation;
+        if (((_s = operation === null || operation === void 0 ? void 0 : operation.cursor) === null || _s === void 0 ? void 0 : _s.cursorType) === 'Bottom') {
+            cursor = operation.cursor.value;
+        }
+    }
+    return {
+        profiles: orderedProfiles,
+        next: cursor,
+    };
+}
+//# sourceMappingURL=timeline.js.map

package/dist/timeline.js.map

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

package/dist/trends.js

@@ -0,0 +1,46 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { addApiParams, requestApi } from './api';
+export function getTrends(auth) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o;
+    return __awaiter(this, void 0, void 0, function* () {
+        const params = new URLSearchParams();
+        addApiParams(params, false);
+        params.set('count', '20');
+        params.set('candidate_source', 'trends');
+        params.set('include_page_configuration', 'false');
+        params.set('entity_tokens', 'false');
+        const res = yield requestApi(`https://twitter.com/i/api/2/guide.json?${params.toString()}`, auth);
+        if (!res.success) {
+            throw res.err;
+        }
+        const instructions = (_b = (_a = res.value.timeline) === null || _a === void 0 ? void 0 : _a.instructions) !== null && _b !== void 0 ? _b : [];
+        if (instructions.length < 2) {
+            throw new Error('No trend entries found.');
+        }
+        // Some of this is silly, but for now we're assuming we know nothing about the
+        // data, and that anything can be missing. Go has non-nilable strings and empty
+        // slices are nil, so it largely doesn't need to worry about this.
+        const entries = (_d = (_c = instructions[1].addEntries) === null || _c === void 0 ? void 0 : _c.entries) !== null && _d !== void 0 ? _d : [];
+        if (entries.length < 2) {
+            throw new Error('No trend entries found.');
+        }
+        const items = (_g = (_f = (_e = entries[1].content) === null || _e === void 0 ? void 0 : _e.timelineModule) === null || _f === void 0 ? void 0 : _f.items) !== null && _g !== void 0 ? _g : [];
+        const trends = [];
+        for (const item of items) {
+            const trend = (_o = (_m = (_l = (_k = (_j = (_h = item.item) === null || _h === void 0 ? void 0 : _h.clientEventInfo) === null || _j === void 0 ? void 0 : _j.details) === null || _k === void 0 ? void 0 : _k.guideDetails) === null || _l === void 0 ? void 0 : _l.transparentGuideDetails) === null || _m === void 0 ? void 0 : _m.trendMetadata) === null || _o === void 0 ? void 0 : _o.trendName;
+            if (trend != null) {
+                trends.push(trend);
+            }
+        }
+        return trends;
+    });
+}
+//# sourceMappingURL=trends.js.map

package/dist/trends.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trends.js","sourceRoot":"","sources":["../src/trends.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAIjD,MAAM,UAAgB,SAAS,CAAC,IAAsB;;;QACpD,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAE5B,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC1B,MAAM,CAAC,GAAG,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;QACzC,MAAM,CAAC,GAAG,CAAC,4BAA4B,EAAE,OAAO,CAAC,CAAC;QAClD,MAAM,CAAC,GAAG,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;QAErC,MAAM,GAAG,GAAG,MAAM,UAAU,CAC1B,0CAA0C,MAAM,CAAC,QAAQ,EAAE,EAAE,EAC7D,IAAI,CACL,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE;YAChB,MAAM,GAAG,CAAC,GAAG,CAAC;SACf;QAED,MAAM,YAAY,GAAG,MAAA,MAAA,GAAG,CAAC,KAAK,CAAC,QAAQ,0CAAE,YAAY,mCAAI,EAAE,CAAC;QAC5D,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE;YAC3B,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;SAC5C;QAED,8EAA8E;QAC9E,+EAA+E;QAC/E,kEAAkE;QAClE,MAAM,OAAO,GAAG,MAAA,MAAA,YAAY,CAAC,CAAC,CAAC,CAAC,UAAU,0CAAE,OAAO,mCAAI,EAAE,CAAC;QAC1D,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE;YACtB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;SAC5C;QAED,MAAM,KAAK,GAAG,MAAA,MAAA,MAAA,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,0CAAE,cAAc,0CAAE,KAAK,mCAAI,EAAE,CAAC;QAC9D,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE;YACxB,MAAM,KAAK,GACT,MAAA,MAAA,MAAA,MAAA,MAAA,MAAA,IAAI,CAAC,IAAI,0CAAE,eAAe,0CAAE,OAAO,0CAAE,YAAY,0CAAE,uBAAuB,0CACtE,aAAa,0CAAE,SAAS,CAAC;YAC/B,IAAI,KAAK,IAAI,IAAI,EAAE;gBACjB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;aACpB;SACF;QAED,OAAO,MAAM,CAAC;;CACf"}

package/dist/tweets.js

@@ -0,0 +1,59 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { addApiParams, requestApi } from './api';
+import { getUserIdByScreenName } from './profile';
+import { parseTweets } from './timeline';
+import { getTweetTimeline } from './timeline-async';
+export function fetchTweets(user, maxTweets, includeReplies, cursor, auth) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (maxTweets > 200) {
+            maxTweets = 200;
+        }
+        const userIdRes = yield getUserIdByScreenName(user, auth);
+        if (!userIdRes.success) {
+            throw userIdRes.err;
+        }
+        const params = new URLSearchParams();
+        addApiParams(params, includeReplies);
+        params.set('count', `${maxTweets}`);
+        params.set('userId', userIdRes.value);
+        if (cursor != null && cursor != '') {
+            params.set('cursor', cursor);
+        }
+        const res = yield requestApi(`https://api.twitter.com/2/timeline/profile/${userIdRes.value}.json?${params.toString()}`, auth);
+        if (!res.success) {
+            throw res.err;
+        }
+        return parseTweets(res.value);
+    });
+}
+export function getTweets(user, maxTweets, includeReplies, auth) {
+    return getTweetTimeline(user, maxTweets, (q, mt, c) => {
+        return fetchTweets(q, mt, includeReplies, c, auth);
+    });
+}
+export function getTweet(id, includeReplies, auth) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const params = new URLSearchParams();
+        addApiParams(params, includeReplies);
+        const res = yield requestApi(`https://twitter.com/i/api/2/timeline/conversation/${id}.json?${params.toString()}`, auth);
+        if (!res.success) {
+            throw res.err;
+        }
+        const { tweets } = parseTweets(res.value);
+        for (const tweet of tweets) {
+            if (tweet.id === id) {
+                return tweet;
+            }
+        }
+        return null;
+    });
+}
+//# sourceMappingURL=tweets.js.map

package/dist/tweets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tweets.js","sourceRoot":"","sources":["../src/tweets.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAEjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAe,WAAW,EAAuB,MAAM,YAAY,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAmDpD,MAAM,UAAgB,WAAW,CAC/B,IAAY,EACZ,SAAiB,EACjB,cAAuB,EACvB,MAA0B,EAC1B,IAAsB;;QAEtB,IAAI,SAAS,GAAG,GAAG,EAAE;YACnB,SAAS,GAAG,GAAG,CAAC;SACjB;QAED,MAAM,SAAS,GAAG,MAAM,qBAAqB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC1D,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE;YACtB,MAAM,SAAS,CAAC,GAAG,CAAC;SACrB;QAED,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,YAAY,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QAErC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;QACpC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,IAAI,EAAE,EAAE;YAClC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;SAC9B;QAED,MAAM,GAAG,GAAG,MAAM,UAAU,CAC1B,8CACE,SAAS,CAAC,KACZ,SAAS,MAAM,CAAC,QAAQ,EAAE,EAAE,EAC5B,IAAI,CACL,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE;YAChB,MAAM,GAAG,CAAC,GAAG,CAAC;SACf;QAED,OAAO,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;CAAA;AAED,MAAM,UAAU,SAAS,CACvB,IAAY,EACZ,SAAiB,EACjB,cAAuB,EACvB,IAAsB;IAEtB,OAAO,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE;QACpD,OAAO,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,cAAc,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAgB,QAAQ,CAC5B,EAAU,EACV,cAAuB,EACvB,IAAsB;;QAEtB,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,YAAY,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QAErC,MAAM,GAAG,GAAG,MAAM,UAAU,CAC1B,qDAAqD,EAAE,SAAS,MAAM,CAAC,QAAQ,EAAE,EAAE,EACnF,IAAI,CACL,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE;YAChB,MAAM,GAAG,CAAC,GAAG,CAAC;SACf;QAED,MAAM,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC1C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE;YAC1B,IAAI,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE;gBACnB,OAAO,KAAK,CAAC;aACd;SACF;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CAAA"}

package/dist/types/api.d.ts

@@ -0,0 +1,16 @@
+import { TwitterGuestAuth } from './auth';
+export declare const bearerToken = "AAAAAAAAAAAAAAAAAAAAAPYXBAAAAAAACLXUNDekMxqa8h%2F40K4moUkGsoc%3DTYfbDKbT3jJPCEVnMYqilB28NHfOPqkca3qaAxGfsyKCs0wRbw";
+export declare const bearerToken2 = "AAAAAAAAAAAAAAAAAAAAANRILgAAAAAAnNwIzUejRCOuH5E6I8xnZz4puTs%3D1Zv7ttfk8LF81IUq16cHjhLTvJu4FA33AGWWjCpTnA";
+/**
+ * An API result container.
+ */
+export declare type RequestApiResult<T> = {
+    success: true;
+    value: T;
+} | {
+    success: false;
+    err: Error;
+};
+export declare function requestApi<T>(url: string, auth: TwitterGuestAuth): Promise<RequestApiResult<T>>;
+export declare function addApiParams(params: URLSearchParams, includeTweetReplies: boolean): URLSearchParams;
+//# sourceMappingURL=api.d.ts.map

package/dist/types/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/api.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAE1C,eAAO,MAAM,WAAW,uHAC8F,CAAC;AACvH,eAAO,MAAM,YAAY,6GACmF,CAAC;AAE7G;;GAEG;AACH,oBAAY,gBAAgB,CAAC,CAAC,IAC1B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAC3B;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,KAAK,CAAA;CAAE,CAAC;AAEnC,wBAAsB,UAAU,CAAC,CAAC,EAChC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAmC9B;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,eAAe,EACvB,mBAAmB,EAAE,OAAO,GAC3B,eAAe,CA8BjB"}

package/dist/types/auth.d.ts

@@ -0,0 +1,55 @@
+/**
+ * A guest authentication token manager. Automatically handles token refreshes.
+ */
+export declare class TwitterGuestAuth {
+    private bearerToken;
+    private cookie?;
+    private guestToken?;
+    private guestCreatedAt?;
+    private xCsrfToken?;
+    constructor(bearerToken: string, cookie?: string, xCsrfToken?: string);
+    /**
+     * Deletes the authentication token.
+     */
+    deleteToken(): void;
+    /**
+     * Returns if the authentication state has a token.
+     * @returns `true` if the authentication state has a token; `false` otherwise.
+     */
+    hasToken(): boolean;
+    /**
+     * Returns the time that authentication was performed.
+     * @returns The time at which the authentication token was created, or `null` if it hasn't been created yet.
+     */
+    authenticatedAt(): Date | null;
+    /**
+     * Sets a cookie string for use in requests.
+     * @param value The new cookie to use in requests.
+     */
+    useCookie(value: string): void;
+    /**
+     * Sets a new CSRF token for use in requests.
+     * @param value The new CSRF token to use in requests.
+     */
+    useCsrfToken(value: string): void;
+    /**
+     * Installs the authentication information into a headers-like object. If needed, the
+     * authentication token will be updated from the API automatically.
+     * @param headers A key-value object representing a request's headers.
+     * @returns A builder that can be used to add or override other relevant data, or to
+     * complete the task.
+     */
+    installTo(headers: {
+        [key: string]: unknown;
+    }): Promise<void>;
+    /**
+     * Updates the authentication state with a new guest token from the Twitter API.
+     */
+    updateToken(): Promise<void>;
+    /**
+     * Returns if the authentication token needs to be updated or not.
+     * @returns `true` if the token needs to be updated; `false` otherwise.
+     */
+    private shouldUpdate;
+}
+//# sourceMappingURL=auth.d.ts.map

package/dist/types/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/auth.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,cAAc,CAAC,CAAO;IAC9B,OAAO,CAAC,UAAU,CAAC,CAAS;gBAEhB,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;IAMrE;;OAEG;IACH,WAAW;IAKX;;;OAGG;IACH,QAAQ,IAAI,OAAO;IAInB;;;OAGG;IACH,eAAe,IAAI,IAAI,GAAG,IAAI;IAQ9B;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM;IAIvB;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM;IAI1B;;;;;;OAMG;IACG,SAAS,CAAC,OAAO,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBnE;;OAEG;IACG,WAAW;IA0BjB;;;OAGG;IACH,OAAO,CAAC,YAAY;CAQrB"}