rettiwt-api 5.0.0-alpha.0 → 5.0.0-alpha.2

package/src/types/raw/user/Unfollow.ts

@@ -0,0 +1,280 @@
+/* eslint-disable */
+
+/**
+ * The raw data received when unfollowing a given user.
+ *
+ * @public
+ */
+export interface IUserUnfollowResponse {
+	id: number;
+	id_str: string;
+	name: string;
+	screen_name: string;
+	location: string;
+	description: string;
+	url: any;
+	entities: Entities;
+	protected: boolean;
+	followers_count: number;
+	fast_followers_count: number;
+	normal_followers_count: number;
+	friends_count: number;
+	listed_count: number;
+	created_at: string;
+	favourites_count: number;
+	utc_offset: any;
+	time_zone: any;
+	geo_enabled: boolean;
+	verified: boolean;
+	statuses_count: number;
+	media_count: number;
+	lang: any;
+	status: Status;
+	contributors_enabled: boolean;
+	is_translator: boolean;
+	is_translation_enabled: boolean;
+	profile_background_color: string;
+	profile_background_image_url: string;
+	profile_background_image_url_https: string;
+	profile_background_tile: boolean;
+	profile_image_url: string;
+	profile_image_url_https: string;
+	profile_banner_url: string;
+	profile_link_color: string;
+	profile_sidebar_border_color: string;
+	profile_sidebar_fill_color: string;
+	profile_text_color: string;
+	profile_use_background_image: boolean;
+	has_extended_profile: boolean;
+	default_profile: boolean;
+	default_profile_image: boolean;
+	pinned_tweet_ids: number[];
+	pinned_tweet_ids_str: string[];
+	has_custom_timelines: boolean;
+	can_media_tag: boolean;
+	followed_by: boolean;
+	following: boolean;
+	follow_request_sent: boolean;
+	notifications: boolean;
+	muting: boolean;
+	advertiser_account_type: string;
+	advertiser_account_service_levels: any[];
+	business_profile_state: string;
+	translator_type: string;
+	withheld_in_countries: any[];
+	require_some_consent: boolean;
+}
+
+interface Entities {
+	description: Description;
+}
+
+interface Description {
+	urls: any[];
+}
+
+interface Status {
+	created_at: string;
+	id: number;
+	id_str: string;
+	text: string;
+	truncated: boolean;
+	entities: Entities2;
+	extended_entities: ExtendedEntities;
+	source: string;
+	in_reply_to_status_id: any;
+	in_reply_to_status_id_str: any;
+	in_reply_to_user_id: any;
+	in_reply_to_user_id_str: any;
+	in_reply_to_screen_name: any;
+	geo: any;
+	coordinates: any;
+	place: any;
+	contributors: any;
+	is_quote_status: boolean;
+	retweet_count: number;
+	favorite_count: number;
+	favorited: boolean;
+	retweeted: boolean;
+	possibly_sensitive: boolean;
+	possibly_sensitive_editable: boolean;
+	lang: string;
+	supplemental_language: any;
+}
+
+interface Entities2 {
+	hashtags: any[];
+	symbols: any[];
+	user_mentions: any[];
+	urls: any[];
+	media: Medum[];
+}
+
+interface Medum {
+	id: number;
+	id_str: string;
+	indices: number[];
+	media_url: string;
+	media_url_https: string;
+	url: string;
+	display_url: string;
+	expanded_url: string;
+	type: string;
+	original_info: OriginalInfo;
+	sizes: Sizes;
+	features: Features;
+}
+
+interface OriginalInfo {
+	width: number;
+	height: number;
+	focus_rects: FocusRect[];
+}
+
+interface FocusRect {
+	x: number;
+	y: number;
+	h: number;
+	w: number;
+}
+
+interface Sizes {
+	thumb: Thumb;
+	medium: Medium;
+	large: Large;
+	small: Small;
+}
+
+interface Thumb {
+	w: number;
+	h: number;
+	resize: string;
+}
+
+interface Medium {
+	w: number;
+	h: number;
+	resize: string;
+}
+
+interface Large {
+	w: number;
+	h: number;
+	resize: string;
+}
+
+interface Small {
+	w: number;
+	h: number;
+	resize: string;
+}
+
+interface Features {
+	medium: Medium2;
+	orig: Orig;
+	large: Large2;
+	small: Small2;
+}
+
+interface Medium2 {
+	faces: any[];
+}
+
+interface Orig {
+	faces: any[];
+}
+
+interface Large2 {
+	faces: any[];
+}
+
+interface Small2 {
+	faces: any[];
+}
+
+interface ExtendedEntities {
+	media: Medum2[];
+}
+
+interface Medum2 {
+	id: number;
+	id_str: string;
+	indices: number[];
+	media_url: string;
+	media_url_https: string;
+	url: string;
+	display_url: string;
+	expanded_url: string;
+	type: string;
+	original_info: OriginalInfo2;
+	sizes: Sizes2;
+	features: Features2;
+	media_key: string;
+}
+
+interface OriginalInfo2 {
+	width: number;
+	height: number;
+	focus_rects: FocusRect2[];
+}
+
+interface FocusRect2 {
+	x: number;
+	y: number;
+	h: number;
+	w: number;
+}
+
+interface Sizes2 {
+	thumb: Thumb2;
+	medium: Medium3;
+	large: Large3;
+	small: Small3;
+}
+
+interface Thumb2 {
+	w: number;
+	h: number;
+	resize: string;
+}
+
+interface Medium3 {
+	w: number;
+	h: number;
+	resize: string;
+}
+
+interface Large3 {
+	w: number;
+	h: number;
+	resize: string;
+}
+
+interface Small3 {
+	w: number;
+	h: number;
+	resize: string;
+}
+
+interface Features2 {
+	medium: Medium4;
+	orig: Orig2;
+	large: Large4;
+	small: Small4;
+}
+
+interface Medium4 {
+	faces: any[];
+}
+
+interface Orig2 {
+	faces: any[];
+}
+
+interface Large4 {
+	faces: any[];
+}
+
+interface Small4 {
+	faces: any[];
+}

package/tsconfig.json

@@ -9,7 +9,7 @@
 		// "disableSolutionSearching": true,                 /* Opt a project out of multi-project reference checking when editing. */
 		// "disableReferencedProjectLoad": true,             /* Reduce the number of projects loaded automatically by TypeScript. */
 		/* Language and Environment */
-		// "target": "es2016",                               /* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */
+		"target": "ES2022" /* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */,
 		// "lib": [],                                        /* Specify a set of bundled library declaration files that describe the target runtime environment. */
 		// "jsx": "preserve",                                /* Specify what JSX code is generated. */
 		"experimentalDecorators": true /* Enable experimental support for TC39 stage 2 draft decorators. */,
@@ -22,9 +22,9 @@
 		// "useDefineForClassFields": true,                  /* Emit ECMAScript-standard-compliant class fields. */
 		// "moduleDetection": "auto",                        /* Control what method is used to detect module-format JS files. */
 		/* Modules */
-		// "module": "commonjs",                             /* Specify what module code is generated. */
-		"rootDir": "./src" /* Specify the root folder within your source files. */,
-		// "moduleResolution": "node",                       /* Specify how TypeScript looks up a file from a given module specifier. */
+		"module": "NodeNext" /* Specify what module code is generated. */,
+		"rootDir": "./src/" /* Specify the root folder within your source files. */,
+		"moduleResolution": "nodenext" /* Specify how TypeScript looks up a file from a given module specifier. */,
 		// "baseUrl": "./",                                  /* Specify the base directory to resolve non-relative module names. */
 		// "paths": {},                                      /* Specify a set of entries that re-map imports to additional lookup locations. */
 		// "rootDirs": [],                                   /* Allow multiple folders to be treated as one when resolving modules. */
@@ -91,5 +91,7 @@
 		/* Completeness */
 		// "skipDefaultLibCheck": true,                      /* Skip type checking .d.ts files that are included with TypeScript. */
 		// "skipLibCheck": true                              /* Skip type checking all .d.ts files. */
-	}
+	},
+	"include": ["src/**/*"],
+	"exclude": ["node_modules", "**/*.spec.ts"]
 }

package/.eslintignore

@@ -1,3 +0,0 @@
-node_modules/
-dist/
-docs/

package/dist/commands/Auth.d.ts

@@ -1,10 +0,0 @@
-import { Command } from 'commander';
-import { Rettiwt } from '../Rettiwt';
-/**
- * Creates a new 'auth' command which uses the given Rettiwt instance.
- *
- * @param rettiwt - The Rettiwt instance to use.
- * @returns The created 'auth' command.
- */
-declare function createAuthCommand(rettiwt: Rettiwt): Command;
-export default createAuthCommand;

package/dist/commands/Auth.js

@@ -1,101 +0,0 @@
-"use strict";
-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());
-    });
-};
-var __generator = (this && this.__generator) || function (thisArg, body) {
-    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
-    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
-    function verb(n) { return function (v) { return step([n, v]); }; }
-    function step(op) {
-        if (f) throw new TypeError("Generator is already executing.");
-        while (g && (g = 0, op[0] && (_ = 0)), _) try {
-            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
-            if (y = 0, t) op = [op[0] & 2, t.value];
-            switch (op[0]) {
-                case 0: case 1: t = op; break;
-                case 4: _.label++; return { value: op[1], done: false };
-                case 5: _.label++; y = op[1]; op = [0]; continue;
-                case 7: op = _.ops.pop(); _.trys.pop(); continue;
-                default:
-                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
-                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
-                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
-                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
-                    if (t[2]) _.ops.pop();
-                    _.trys.pop(); continue;
-            }
-            op = body.call(thisArg, _);
-        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
-        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
-    }
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-var commander_1 = require("commander");
-var CliUtils_1 = require("../helper/CliUtils");
-/**
- * Creates a new 'auth' command which uses the given Rettiwt instance.
- *
- * @param rettiwt - The Rettiwt instance to use.
- * @returns The created 'auth' command.
- */
-function createAuthCommand(rettiwt) {
-    var _this = this;
-    // Creating the 'auth' command
-    var auth = (0, commander_1.createCommand)('auth').description('Manage authentication');
-    // Login
-    auth.command('login')
-        .description('Generate a new API key using Twitter account login credentials')
-        .argument('<email>', 'The email id of the Twitter account')
-        .argument('<username>', 'The username associated with the Twitter account')
-        .argument('<password>', 'The password to the Twitter account')
-        .action(function (email, username, password) { return __awaiter(_this, void 0, void 0, function () {
-        var apiKey, error_1;
-        return __generator(this, function (_a) {
-            switch (_a.label) {
-                case 0:
-                    _a.trys.push([0, 2, , 3]);
-                    return [4 /*yield*/, rettiwt.auth.login(email, username, password)];
-                case 1:
-                    apiKey = _a.sent();
-                    (0, CliUtils_1.output)(apiKey);
-                    return [3 /*break*/, 3];
-                case 2:
-                    error_1 = _a.sent();
-                    (0, CliUtils_1.output)(error_1);
-                    return [3 /*break*/, 3];
-                case 3: return [2 /*return*/];
-            }
-        });
-    }); });
-    // Guest
-    auth.command('guest')
-        .description('Generate a new guest key')
-        .action(function () { return __awaiter(_this, void 0, void 0, function () {
-        var guestKey, error_2;
-        return __generator(this, function (_a) {
-            switch (_a.label) {
-                case 0:
-                    _a.trys.push([0, 2, , 3]);
-                    return [4 /*yield*/, rettiwt.auth.guest()];
-                case 1:
-                    guestKey = _a.sent();
-                    (0, CliUtils_1.output)(guestKey);
-                    return [3 /*break*/, 3];
-                case 2:
-                    error_2 = _a.sent();
-                    (0, CliUtils_1.output)(error_2);
-                    return [3 /*break*/, 3];
-                case 3: return [2 /*return*/];
-            }
-        });
-    }); });
-    return auth;
-}
-exports.default = createAuthCommand;
-//# sourceMappingURL=Auth.js.map

package/dist/commands/Auth.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Auth.js","sourceRoot":"","sources":["../../src/commands/Auth.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAmD;AAEnD,+CAA4C;AAG5C;;;;;GAKG;AACH,SAAS,iBAAiB,CAAC,OAAgB;IAA3C,iBAgCC;IA/BA,8BAA8B;IAC9B,IAAM,IAAI,GAAG,IAAA,yBAAa,EAAC,MAAM,CAAC,CAAC,WAAW,CAAC,uBAAuB,CAAC,CAAC;IAExE,QAAQ;IACR,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;SACnB,WAAW,CAAC,gEAAgE,CAAC;SAC7E,QAAQ,CAAC,SAAS,EAAE,qCAAqC,CAAC;SAC1D,QAAQ,CAAC,YAAY,EAAE,kDAAkD,CAAC;SAC1E,QAAQ,CAAC,YAAY,EAAE,qCAAqC,CAAC;SAC7D,MAAM,CAAC,UAAO,KAAa,EAAE,QAAgB,EAAE,QAAgB;;;;;;oBAEvC,qBAAM,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAA;;oBAApE,MAAM,GAAW,SAAmD;oBAC1E,IAAA,iBAAM,EAAC,MAAM,CAAC,CAAC;;;;oBAEf,IAAA,iBAAM,EAAC,OAAK,CAAC,CAAC;;;;;SAEf,CAAC,CAAC;IAEJ,QAAQ;IACR,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;SACnB,WAAW,CAAC,0BAA0B,CAAC;SACvC,MAAM,CAAC;;;;;;oBAEmB,qBAAM,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,EAAA;;oBAA7C,QAAQ,GAAW,SAA0B;oBACnD,IAAA,iBAAM,EAAC,QAAQ,CAAC,CAAC;;;;oBAEjB,IAAA,iBAAM,EAAC,OAAK,CAAC,CAAC;;;;;SAEf,CAAC,CAAC;IAEJ,OAAO,IAAI,CAAC;AACb,CAAC;AAED,kBAAe,iBAAiB,CAAC"}

package/dist/models/errors/DataValidationError.d.ts

@@ -1,30 +0,0 @@
-import { ValidationError } from 'class-validator';
-/**
- * Represents and error when any fields of a validation-enabled class fails to validate.
- *
- * @public
- */
-export declare class DataValidationError {
-    /** The detaied error message(s). */
-    details: ValidationErrorDetails[];
-    /** The user-friendly error message. */
-    message: string;
-    /** The name of the error. */
-    name: string;
-    /**
-     * @param data - The error details, as a list of type {@link ValidationError}
-     */
-    constructor(errorDetails: ValidationError[]);
-}
-/**
- * Represents the validation error details of a single field.
- *
- * @public
- */
-export declare class ValidationErrorDetails {
-    /** The constraints which failed to be validated for the given field. */
-    constraints: string[];
-    /** The name of the field which failed validation. */
-    field: string;
-    constructor(details: ValidationError);
-}

package/dist/models/errors/DataValidationError.js

@@ -1,34 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ValidationErrorDetails = exports.DataValidationError = void 0;
-/**
- * Represents and error when any fields of a validation-enabled class fails to validate.
- *
- * @public
- */
-var DataValidationError = /** @class */ (function () {
-    /**
-     * @param data - The error details, as a list of type {@link ValidationError}
-     */
-    function DataValidationError(errorDetails) {
-        this.name = 'VALIDATION_ERROR';
-        this.message = 'One or more validation error(s) occured, check details field.';
-        this.details = errorDetails.map(function (error) { return new ValidationErrorDetails(error); });
-    }
-    return DataValidationError;
-}());
-exports.DataValidationError = DataValidationError;
-/**
- * Represents the validation error details of a single field.
- *
- * @public
- */
-var ValidationErrorDetails = /** @class */ (function () {
-    function ValidationErrorDetails(details) {
-        this.field = details.property;
-        this.constraints = Object.values(details.constraints);
-    }
-    return ValidationErrorDetails;
-}());
-exports.ValidationErrorDetails = ValidationErrorDetails;
-//# sourceMappingURL=DataValidationError.js.map

package/dist/models/errors/DataValidationError.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"DataValidationError.js","sourceRoot":"","sources":["../../../src/models/errors/DataValidationError.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACH;IAUC;;OAEG;IACH,6BAAmB,YAA+B;QACjD,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,+DAA+D,CAAC;QAC/E,IAAI,CAAC,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,UAAC,KAAK,IAAK,OAAA,IAAI,sBAAsB,CAAC,KAAK,CAAC,EAAjC,CAAiC,CAAC,CAAC;IAC/E,CAAC;IACF,0BAAC;AAAD,CAAC,AAlBD,IAkBC;AAlBY,kDAAmB;AAoBhC;;;;GAIG;AACH;IAOC,gCAAmB,OAAwB;QAC1C,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,WAAY,CAAC,CAAC;IACxD,CAAC;IACF,6BAAC;AAAD,CAAC,AAXD,IAWC;AAXY,wDAAsB"}

package/dist/services/public/AuthService.d.ts

@@ -1,91 +0,0 @@
-import { IRettiwtConfig } from '../../types/RettiwtConfig';
-import { FetcherService } from './FetcherService';
-/**
- * The services that handles authentication.
- *
- * @public
- */
-export declare class AuthService extends FetcherService {
-    /**
-     * @param config - The config object for configuring the `Rettiwt` instance.
-     *
-     * @internal
-     */
-    constructor(config?: IRettiwtConfig);
-    /**
-     * Decodes the encoded cookie string.
-     *
-     * @param encodedCookies - The encoded cookie string to decode.
-     * @returns The decoded cookie string.
-     */
-    static decodeCookie(encodedCookies: string): string;
-    /**
-     * Encodes the given cookie string.
-     *
-     * @param cookieString - The cookie string to encode.
-     * @returns The encoded cookie string.
-     */
-    static encodeCookie(cookieString: string): string;
-    /**
-     * Gets the user's id from the given API key.
-     *
-     * @param apiKey - The API key.
-     * @returns The user id associated with the API key.
-     */
-    static getUserId(apiKey: string): string;
-    /**
-     * Login to twitter as guest.
-     *
-     * @returns A new guest key.
-     *
-     * @example
-     * ```
-     * import { Rettiwt } from 'rettiwt-api';
-     *
-     * // Creating a new Rettiwt instance
-     * const rettiwt = new Rettiwt();
-     *
-     * // Logging in an getting a new guest key
-     * rettiwt.auth.guest()
-     * .then(guestKey => {
-     * 	// Use the guest key
-     * 	...
-     * })
-     * .catch(err => {
-     * 	console.log(err);
-     * });
-     * ```
-     */
-    guest(): Promise<string>;
-    /**
-     * Login to twitter using account credentials.
-     *
-     * @param email - The email id associated with the Twitter account.
-     * @param userName - The username associated with the Twitter account.
-     * @param password - The password to the Twitter account.
-     *
-     * @returns The `API_KEY` for the Twitter account.
-     *
-     * @example
-     * ```
-     * import { Rettiwt } from 'rettiwt-api';
-     *
-     * // Creating a new Rettiwt instance
-     * const rettiwt = new Rettiwt();
-     *
-     * // Logging in an getting the API_KEY
-     * rettiwt.auth.login("email@domain.com", "username", "password")
-     * .then(apiKey => {
-     * 	// Use the API_KEY
-     * 	...
-     * })
-     * .catch(err => {
-     * 	console.log(err);
-     * });
-     * ```
-     *
-     * @remarks
-     * Interchanging `email` and `userName` works too.
-     */
-    login(email: string, userName: string, password: string): Promise<string>;
-}