rettiwt-api 1.0.5 → 1.0.7

package/dist/types/HTTP.js

@@ -1,15 +1,6 @@
 "use strict";
 exports.__esModule = true;
-exports.HttpStatus = exports.HttpMethods = void 0;
-/**
- * @summary Stores all the different type of http requests
- */
-var HttpMethods;
-(function (HttpMethods) {
-    HttpMethods["POST"] = "POST";
-    HttpMethods["GET"] = "GET";
-})(HttpMethods = exports.HttpMethods || (exports.HttpMethods = {}));
-;
+exports.HttpStatus = void 0;
 /**
  * @summary Stores the different types of http status codes
  */

package/dist/types/HTTP.js.map

@@ -1 +1 @@
-{"version":3,"file":"HTTP.js","sourceRoot":"","sources":["../../src/types/HTTP.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,IAAY,WAGX;AAHD,WAAY,WAAW;IACnB,4BAAa,CAAA;IACb,0BAAW,CAAA;AACf,CAAC,EAHW,WAAW,GAAX,mBAAW,KAAX,mBAAW,QAGtB;AAAA,CAAC;AAEF;;GAEG;AACH,IAAY,UAWX;AAXD,WAAY,UAAU;IAClB,yDAAgB,CAAA;IAChB,6DAAkB,CAAA;IAClB,uDAAe,CAAA;IACf,qDAAc,CAAA;IACd,qEAAsB,CAAA;IACtB,iEAAoB,CAAA;IACpB,mEAAqB,CAAA;IACrB,2EAAyB,CAAA;IACzB,yDAAgB,CAAA;IAChB,yEAAwB,CAAA;AAC5B,CAAC,EAXW,UAAU,GAAV,kBAAU,KAAV,kBAAU,QAWrB;AAAA,CAAC"}
+{"version":3,"file":"HTTP.js","sourceRoot":"","sources":["../../src/types/HTTP.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,IAAY,UAWX;AAXD,WAAY,UAAU;IAClB,yDAAgB,CAAA;IAChB,6DAAkB,CAAA;IAClB,uDAAe,CAAA;IACf,qDAAc,CAAA;IACd,qEAAsB,CAAA;IACtB,iEAAoB,CAAA;IACpB,mEAAqB,CAAA;IACrB,2EAAyB,CAAA;IACzB,yDAAgB,CAAA;IAChB,yEAAwB,CAAA;AAC5B,CAAC,EAXW,UAAU,GAAV,kBAAU,KAAV,kBAAU,QAWrB;AAAA,CAAC"}

package/dist/types/Resolvers.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @summary Stores the data returned from extractors
+ */
+export interface DataExtract {
+    required: any;
+    cursor: string;
+    users: any;
+    tweets: any;
+}

package/dist/types/Resolvers.js

@@ -0,0 +1,3 @@
+"use strict";
+exports.__esModule = true;
+//# sourceMappingURL=Resolvers.js.map

package/dist/types/Resolvers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Resolvers.js","sourceRoot":"","sources":["../../src/types/Resolvers.ts"],"names":[],"mappings":""}

package/dist/types/Service.d.ts

@@ -1,3 +1,4 @@
+import { AccountService } from "../services/accounts/AccountService";
 import { TweetService } from "../services/data/TweetService";
 import { UserAccountService } from "../services/data/UserAccountService";
 /**
@@ -25,4 +26,5 @@ export interface CursoredData<Type> {
 export interface DataContext {
     users: UserAccountService;
     tweets: TweetService;
+    account: AccountService;
 }

package/dist/types/Service.js.map

@@ -1 +1 @@
-{"version":3,"file":"Service.js","sourceRoot":"","sources":["../../src/types/Service.ts"],"names":[],"mappings":";;;AAIA;;GAEG;AACH;IAII,cAAc;IACd;;;OAGG;IACH,gBAAY,SAAiB;QACzB,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;IAC3B,CAAC;IACL,aAAC;AAAD,CAAC,AAZD,IAYC;AAZY,wBAAM"}
+{"version":3,"file":"Service.js","sourceRoot":"","sources":["../../src/types/Service.ts"],"names":[],"mappings":";;;AAKA;;GAEG;AACH;IAII,cAAc;IACd;;;OAGG;IACH,gBAAY,SAAiB;QACzB,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;IAC3B,CAAC;IACL,aAAC;AAAD,CAAC,AAZD,IAYC;AAZY,wBAAM"}

package/dist/types/Tweet.d.ts

@@ -9,6 +9,7 @@ export interface TweetFilter {
     mentions?: string[];
     startDate?: string;
     endDate?: string;
+    sinceId?: string;
     quoted?: string;
     links?: boolean;
 }

package/dist/types/Tweet.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tweet.js","sourceRoot":"","sources":["../../src/types/Tweet.ts"],"names":[],"mappings":";AAAA,kFAAkF;;AAejF,CAAC"}
+{"version":3,"file":"Tweet.js","sourceRoot":"","sources":["../../src/types/Tweet.ts"],"names":[],"mappings":";AAAA,kFAAkF;;AAgBjF,CAAC"}

package/dist/types/User.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @summary Stores the complete details of the given user's account
+ */
+export interface User {
+    id: string;
+    userName: string;
+    fullName: string;
+    createdAt: string;
+    description: string;
+    isVerified: boolean;
+    favouritesCount: number;
+    followersCount: number;
+    followingsCount: number;
+    statusesCount: number;
+    location: string;
+    pinnedTweet: string;
+    profileBanner: string;
+    profileImage: string;
+}

package/dist/types/User.js

@@ -0,0 +1,4 @@
+"use strict";
+// This file contains various objects for handling data related to User Account
+exports.__esModule = true;
+//# sourceMappingURL=User.js.map

package/dist/types/User.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"User.js","sourceRoot":"","sources":["../../src/types/User.ts"],"names":[],"mappings":";AAAA,+EAA+E"}

package/dist/types/data/Errors.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @summary Stores different types of error messages related to authentication
+ */
+export declare enum AuthenticationErrors {
+    NotAuthenticated = "Cannot fetch this data without authentication"
+}
+/**
+ * @summary Stores different types error messages for validation errors
+ */
+export declare enum ValidationErrors {
+    InvalidTweetFilter = "Atleast one of fromUsers/toUsers/mentions/hashtags/words argument is required",
+    NoUserIdentification = "Either userName or id must be given",
+    InvalidCount = "Invalid count provided"
+}
+/**
+ * @summary Stores all the different type of error messages that are returned by services
+ */
+export declare enum DataErrors {
+    UserNotFound = "An account with given username/id was not found",
+    TweetNotFound = "A tweet with the given id was not found",
+    NoTweetsFound = "No tweets matching the given criteria found",
+    NoLikersFound = "No likers found for the tweet with the given id",
+    NoRetweetersFound = "No retweeters found for the tweet with the given id",
+    NoFollowsFound = "No follow details were found for the user with the given id",
+    NoLikedTweetsFound = "No liked tweets were found for the user with the given id"
+}

package/dist/types/data/Errors.js

@@ -0,0 +1,36 @@
+"use strict";
+exports.__esModule = true;
+exports.DataErrors = exports.ValidationErrors = exports.AuthenticationErrors = void 0;
+/**
+ * @summary Stores different types of error messages related to authentication
+ */
+var AuthenticationErrors;
+(function (AuthenticationErrors) {
+    AuthenticationErrors["NotAuthenticated"] = "Cannot fetch this data without authentication";
+})(AuthenticationErrors = exports.AuthenticationErrors || (exports.AuthenticationErrors = {}));
+;
+/**
+ * @summary Stores different types error messages for validation errors
+ */
+var ValidationErrors;
+(function (ValidationErrors) {
+    ValidationErrors["InvalidTweetFilter"] = "Atleast one of fromUsers/toUsers/mentions/hashtags/words argument is required";
+    ValidationErrors["NoUserIdentification"] = "Either userName or id must be given";
+    ValidationErrors["InvalidCount"] = "Invalid count provided";
+})(ValidationErrors = exports.ValidationErrors || (exports.ValidationErrors = {}));
+;
+/**
+ * @summary Stores all the different type of error messages that are returned by services
+ */
+var DataErrors;
+(function (DataErrors) {
+    DataErrors["UserNotFound"] = "An account with given username/id was not found";
+    DataErrors["TweetNotFound"] = "A tweet with the given id was not found";
+    DataErrors["NoTweetsFound"] = "No tweets matching the given criteria found";
+    DataErrors["NoLikersFound"] = "No likers found for the tweet with the given id";
+    DataErrors["NoRetweetersFound"] = "No retweeters found for the tweet with the given id";
+    DataErrors["NoFollowsFound"] = "No follow details were found for the user with the given id";
+    DataErrors["NoLikedTweetsFound"] = "No liked tweets were found for the user with the given id";
+})(DataErrors = exports.DataErrors || (exports.DataErrors = {}));
+;
+//# sourceMappingURL=Errors.js.map

package/dist/types/data/Errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Errors.js","sourceRoot":"","sources":["../../../src/types/data/Errors.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,IAAY,oBAEX;AAFD,WAAY,oBAAoB;IAC5B,0FAAkE,CAAA;AACtE,CAAC,EAFW,oBAAoB,GAApB,4BAAoB,KAApB,4BAAoB,QAE/B;AAAA,CAAC;AAEF;;GAEG;AACH,IAAY,gBAIX;AAJD,WAAY,gBAAgB;IACxB,wHAAoG,CAAA;IACpG,gFAA4D,CAAA;IAC5D,2DAAuC,CAAA;AAC3C,CAAC,EAJW,gBAAgB,GAAhB,wBAAgB,KAAhB,wBAAgB,QAI3B;AAAA,CAAC;AAEF;;GAEG;AACH,IAAY,UAQX;AARD,WAAY,UAAU;IAClB,8EAAgE,CAAA;IAChE,uEAAyD,CAAA;IACzD,2EAA6D,CAAA;IAC7D,+EAAiE,CAAA;IACjE,uFAAyE,CAAA;IACzE,4FAA8E,CAAA;IAC9E,8FAAgF,CAAA;AACpF,CAAC,EARW,UAAU,GAAV,kBAAU,KAAV,kBAAU,QAQrB;AAAA,CAAC"}

package/dist/types/data/Service.d.ts

@@ -0,0 +1,29 @@
+import { AccountService } from "../../services/accounts/AccountService";
+import { TweetService } from "../../services/data/TweetService";
+import { UserService } from "../../services/data/UserService";
+/**
+ * @summary Stores the cursor to the batch of data
+ */
+export declare class Cursor {
+    value: string;
+    /**
+     * @summary Initializes a new cursor from the given cursor string
+     * @param cursorStr The string representation of the cursor
+     */
+    constructor(cursorStr: string);
+}
+/**
+ * @summary Stores cursored data that is returned by services
+ */
+export interface CursoredData<Type> {
+    list?: Type[];
+    next?: Cursor;
+}
+/**
+ * @summary Stores the data context from where data is to be fetched
+ */
+export interface DataContext {
+    users: UserService;
+    tweets: TweetService;
+    account: AccountService;
+}

package/dist/types/data/Service.js

@@ -0,0 +1,19 @@
+"use strict";
+exports.__esModule = true;
+exports.Cursor = void 0;
+/**
+ * @summary Stores the cursor to the batch of data
+ */
+var Cursor = /** @class */ (function () {
+    // MEMBER DATA
+    /**
+     * @summary Initializes a new cursor from the given cursor string
+     * @param cursorStr The string representation of the cursor
+     */
+    function Cursor(cursorStr) {
+        this.value = cursorStr;
+    }
+    return Cursor;
+}());
+exports.Cursor = Cursor;
+//# sourceMappingURL=Service.js.map

package/dist/types/data/Service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Service.js","sourceRoot":"","sources":["../../../src/types/data/Service.ts"],"names":[],"mappings":";;;AAKA;;GAEG;AACH;IAII,cAAc;IACd;;;OAGG;IACH,gBAAY,SAAiB;QACzB,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;IAC3B,CAAC;IACL,aAAC;AAAD,CAAC,AAZD,IAYC;AAZY,wBAAM"}

package/dist/types/data/Tweet.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @summary Stores the filter to be used for fetching tweets from TwitterAPI
+ */
+export interface TweetFilter {
+    words?: string[];
+    hashtags?: string[];
+    fromUsers?: string[];
+    toUsers?: string[];
+    mentions?: string[];
+    startDate?: string;
+    endDate?: string;
+    sinceId?: string;
+    quoted?: string;
+    links?: boolean;
+}
+/**
+ * @summary Stores the different types of tweet elements like urls, media, mentions, hashtags, etc
+ */
+export interface TweetEntities {
+    hashtags: string[];
+    urls: string[];
+    mentionedUsers: string[];
+    media: string[];
+}
+/**
+ * @summary Stores a single tweet
+ */
+export interface Tweet {
+    id: string;
+    tweetBy: string;
+    createdAt: string;
+    entities: TweetEntities;
+    quoted: string;
+    fullText: string;
+    replyTo: string;
+    lang: string;
+    quoteCount: number;
+    replyCount: number;
+    retweetCount: number;
+    likeCount: number;
+}

package/dist/types/data/Tweet.js

@@ -0,0 +1,5 @@
+"use strict";
+// This file contains various objects related to handling of Tweets made by a user
+exports.__esModule = true;
+;
+//# sourceMappingURL=Tweet.js.map

package/dist/types/data/Tweet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tweet.js","sourceRoot":"","sources":["../../../src/types/data/Tweet.ts"],"names":[],"mappings":";AAAA,kFAAkF;;AAgBjF,CAAC"}

package/dist/types/data/User.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @summary Stores the complete details of the given user's account
+ */
+export interface User {
+    id: string;
+    userName: string;
+    fullName: string;
+    createdAt: string;
+    description: string;
+    isVerified: boolean;
+    favouritesCount: number;
+    followersCount: number;
+    followingsCount: number;
+    statusesCount: number;
+    location: string;
+    pinnedTweet: string;
+    profileBanner: string;
+    profileImage: string;
+}

package/dist/types/data/User.js

@@ -0,0 +1,4 @@
+"use strict";
+// This file contains various objects for handling data related to User Account
+exports.__esModule = true;
+//# sourceMappingURL=User.js.map

package/dist/types/data/User.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"User.js","sourceRoot":"","sources":["../../../src/types/data/User.ts"],"names":[],"mappings":";AAAA,+EAA+E"}

package/dist/types/raw/http/Error.d.ts

@@ -0,0 +1,34 @@
+export interface Root {
+    errors: Error[];
+    data: Data;
+}
+export interface Error {
+    message: string;
+    locations: Location[];
+    path: string[];
+    extensions: Extensions;
+    code: number;
+    kind: string;
+    name: string;
+    source: string;
+    tracing: Tracing2;
+}
+export interface Location {
+    line: number;
+    column: number;
+}
+export interface Extensions {
+    name: string;
+    source: string;
+    code: number;
+    kind: string;
+    tracing: Tracing;
+}
+export interface Tracing {
+    trace_id: string;
+}
+export interface Tracing2 {
+    trace_id: string;
+}
+export interface Data {
+}

package/dist/types/raw/{user/Users.js → http/Error.js}

@@ -1,3 +1,3 @@
 "use strict";
 exports.__esModule = true;
-//# sourceMappingURL=Users.js.map
+//# sourceMappingURL=Error.js.map

package/dist/types/raw/http/Error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Error.js","sourceRoot":"","sources":["../../../../src/types/raw/http/Error.ts"],"names":[],"mappings":""}

package/dist/types/raw/http/Response.d.ts

@@ -0,0 +1,34 @@
+export default interface Reponse<Type> {
+    errors: Error[];
+    data: Type;
+}
+export interface Error {
+    message: string;
+    locations: Location[];
+    path: string[];
+    extensions: Extensions;
+    code: number;
+    kind: string;
+    name: string;
+    source: string;
+    tracing: Tracing2;
+}
+export interface Location {
+    line: number;
+    column: number;
+}
+export interface Extensions {
+    name: string;
+    source: string;
+    code: number;
+    kind: string;
+    tracing: Tracing;
+}
+export interface Tracing {
+    trace_id: string;
+}
+export interface Tracing2 {
+    trace_id: string;
+}
+export interface Data {
+}

package/dist/types/raw/http/Response.js

@@ -0,0 +1,3 @@
+"use strict";
+exports.__esModule = true;
+//# sourceMappingURL=Response.js.map

package/dist/types/raw/http/Response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Response.js","sourceRoot":"","sources":["../../../../src/types/raw/http/Response.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "rettiwt-api",
-	"version": "1.0.5",
+	"version": "1.0.7",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
 	"description": "An API for fetching data from TwitterAPI, without any rate limits!",
@@ -24,13 +24,15 @@
 	"homepage": "https://github.com/Rishikant181/Rettiwt-API#readme",
 	"dependencies": {
 		"axios": "^1.3.2",
-		"express": "^4.18.2",
+		"cookiejar": "2.1.4",
+		"express": "4.18.2",
 		"express-graphql": "0.12.0",
 		"graphql": "14.7.0",
 		"node-cache": "5.1.2",
 		"node-libcurl": "3.0.0"
 	},
 	"devDependencies": {
+		"@types/cookiejar": "^2.1.2",
 		"@types/express": "4.17.13",
 		"@types/graphql": "14.5.0",
 		"@types/node": "17.0.24",

package/src/{queries → graphql/queries}/RootQuery.ts

@@ -2,13 +2,14 @@
 import { GraphQLBoolean, GraphQLInt, GraphQLList, GraphQLObjectType, GraphQLString } from 'graphql'
 
 // TYPES
-import { User } from '../models/graphql/UserTypes';
-import { Tweet, TweetList } from '../models/graphql/TweetTypes';
-import { TweetFilter } from '../types/Tweet';
+import { User } from '../types/UserTypes';
+import { Tweet, TweetList } from '../types/TweetTypes';
+import { TweetFilter } from '../../types/data/Tweet';
 
 // RESOLVERS
 import UserResolver from '../resolvers/UserResolver';
 import TweetResolver from '../resolvers/TweetResolver';
+import AccountResolver from '../resolvers/AccountResolver';
 
 export const rootQuery = new GraphQLObjectType({
     name: 'Root',
@@ -45,12 +46,23 @@ export const rootQuery = new GraphQLObjectType({
                 words: { type: new GraphQLList(GraphQLString) },
                 startDate: { type: GraphQLString },
                 endDate: { type: GraphQLString },
+                sinceId: { type: GraphQLString },
                 quoted: { type: GraphQLString },
                 links: { type: GraphQLBoolean, defaultValue: false },
-                count: { type: GraphQLInt, defaultValue: 20 },
+                count: { type: GraphQLInt, defaultValue: 10 },
                 cursor: { type: GraphQLString, defaultValue: '' }
             },
             resolve: (parent, args, context) => new TweetResolver(context).resolveTweets(args as TweetFilter, args.count, args.cursor)
+        },
+        Login: {
+            type: GraphQLString,
+            description: "Returns the cookies that can be used to fetch data from twitter",
+            args: {
+                email: { type: GraphQLString },
+                userName: { type: GraphQLString },
+                password: { type: GraphQLString }
+            },
+            resolve: (parent, args, context) => new AccountResolver(context).resolveLogin(args.email, args.userName, args.password)
         }
     }
 })

package/src/graphql/resolvers/AccountResolver.ts

@@ -0,0 +1,22 @@
+// RESOLVERS
+import ResolverBase from './ResolverBase';
+
+// TYPES
+import { DataContext } from '../../types/data/Service';
+
+export default class AccountResolver extends ResolverBase {
+    // MEMBER METHODS
+    constructor(context: DataContext) {
+        super(context);
+    }
+
+    /**
+     * @param email The email of the account to be logged into
+     * @param userName The username associated with the account
+     * @param password The password to the account
+     * @returns The cookie string that can be used to authenticate against twitter
+     */
+    async resolveLogin(email: string, userName: string, password: string): Promise<string> {
+        return await this.context.account.login(email, userName, password);
+    }
+}

package/src/{resolvers → graphql/resolvers}/ResolverBase.ts

@@ -1,5 +1,5 @@
 // TYPES
-import { DataContext } from '../types/Service';
+import { DataContext } from '../../types/data/Service';
 
 export default class ResolverBase {
     // MEMBER DATA