@8ms/helpers 1.42.3 → 1.42.6

package/dist/cjs/axios/delete.js

@@ -1,76 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const ApiResponse_1 = __importDefault(require("../api/ApiResponse"));
-/**
- * Make a DELETE request.
- * Cant use the function name delete as its reserved
- */
-const deleteRequest = async (props) => {
-    const { default: ky } = await Promise.resolve().then(() => __importStar(require("ky")));
-    const response = await ky.delete(props.url, {
-        throwHttpErrors: false,
-        ...props.config
-    })
-        .then(async (response) => {
-        const data = await response.json();
-        // Is API response
-        if (undefined !== data.body && undefined !== data.error && undefined !== data.state) {
-            return new ApiResponse_1.default(data);
-        }
-        // General success - some APIs report 201
-        else if (response.status >= 200 && response.status <= 299) {
-            return (new ApiResponse_1.default()).setToSuccess({
-                body: data,
-            });
-        }
-        // Error
-        return (new ApiResponse_1.default()).setToError({
-            body: data,
-            error: response.statusText,
-        });
-    })
-        .catch(error => {
-        // Error
-        return (new ApiResponse_1.default()).setToError({
-            error: error.message,
-        });
-    });
-    return response;
-};
-exports.default = deleteRequest;

package/dist/cjs/axios/get.d.ts

@@ -1,10 +0,0 @@
-import ApiResponse from "../api/ApiResponse";
-export type Get = {
-    config?: object;
-    url: string;
-};
-/**
- * Make a GET request.
- */
-declare const get: ({ config, url }: Get) => Promise<ApiResponse>;
-export default get;

package/dist/cjs/axios/get.js

@@ -1,72 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const ApiResponse_1 = __importDefault(require("../api/ApiResponse"));
-/**
- * Make a GET request.
- */
-const get = async ({ config = {}, url }) => {
-    const { default: ky } = await Promise.resolve().then(() => __importStar(require("ky")));
-    const response = await ky.get(url, { throwHttpErrors: false, ...config })
-        .then(async (response) => {
-        const data = await response.json();
-        // Is API response
-        if (undefined !== data.body && undefined !== data.error && undefined !== data.state) {
-            return new ApiResponse_1.default(data);
-        }
-        // General success - some APIs report 201
-        else if (response.status >= 200 && response.status <= 299) {
-            return (new ApiResponse_1.default()).setToSuccess({
-                body: data,
-            });
-        }
-        // Error
-        return (new ApiResponse_1.default()).setToError({
-            body: data,
-            error: response.statusText,
-        });
-    })
-        .catch(error => {
-        // Error
-        return (new ApiResponse_1.default()).setToError({
-            error: error.message,
-        });
-    });
-    return response;
-};
-exports.default = get;

package/dist/cjs/axios/post.d.ts

@@ -1,11 +0,0 @@
-import ApiResponse from "../api/ApiResponse";
-export type Post = {
-    config?: object;
-    data?: object;
-    url: string;
-};
-/**
- * Make a POST request.
- */
-declare const post: ({ config, data, url }: Post) => Promise<ApiResponse>;
-export default post;

package/dist/cjs/axios/post.js

@@ -1,72 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const ApiResponse_1 = __importDefault(require("../api/ApiResponse"));
-/**
- * Make a POST request.
- */
-const post = async ({ config = {}, data = {}, url }) => {
-    const { default: ky } = await Promise.resolve().then(() => __importStar(require("ky")));
-    const response = await ky.post(url, { throwHttpErrors: false, json: data, ...config })
-        .then(async (response) => {
-        const data = await response.json();
-        // Is API response
-        if (undefined !== data.body && undefined !== data.error && undefined !== data.state) {
-            return new ApiResponse_1.default(data);
-        }
-        // General success - some APIs report 201
-        else if (response.status >= 200 && response.status <= 299) {
-            return (new ApiResponse_1.default()).setToSuccess({
-                body: data,
-            });
-        }
-        // Error
-        return (new ApiResponse_1.default()).setToError({
-            body: data,
-            error: response.statusText,
-        });
-    })
-        .catch(error => {
-        // Error
-        return (new ApiResponse_1.default()).setToError({
-            error: error.message,
-        });
-    });
-    return response;
-};
-exports.default = post;

package/dist/cjs/boolean/getBoolean.d.ts

@@ -1,7 +0,0 @@
-/**
- * Convert an input from a variety of forms into boolean.
- */
-declare const getBoolean: ({ input }: {
-    input: any;
-}) => boolean;
-export default getBoolean;

package/dist/cjs/boolean/getBoolean.js

@@ -1,16 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const isBoolean_1 = __importDefault(require("lodash/isBoolean"));
-/**
- * Convert an input from a variety of forms into boolean.
- */
-const getBoolean = ({ input }) => {
-    if ((0, isBoolean_1.default)(input)) {
-        return input;
-    }
-    return 'true' === input || 1 === input || '1' === input || 'yes' === input || 'y' === input;
-};
-exports.default = getBoolean;

package/dist/cjs/boolean/tests/getBoolean.test.js

@@ -1,26 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const getBoolean_1 = __importDefault(require("../getBoolean"));
-test('getBoolean - True', () => {
-    expect((0, getBoolean_1.default)({ input: true }))
-        .toBeTruthy();
-    expect((0, getBoolean_1.default)({ input: 1 }))
-        .toBeTruthy();
-    expect((0, getBoolean_1.default)({ input: '1' }))
-        .toBeTruthy();
-});
-test('getBoolean - False', () => {
-    expect((0, getBoolean_1.default)({ input: false }))
-        .toBeFalsy();
-    expect((0, getBoolean_1.default)({ input: 0 }))
-        .toBeFalsy();
-    expect((0, getBoolean_1.default)({ input: '0' }))
-        .toBeFalsy();
-});
-test('getBoolean - Unexpected', () => {
-    expect((0, getBoolean_1.default)({ input: 'test' }))
-        .toBeFalsy();
-});

package/dist/cjs/brightData/getCustomerId.d.ts

@@ -1,10 +0,0 @@
-import { Param } from "./param";
-type GetCustomerId = {
-    auth: Param;
-    prefix?: string;
-};
-/**
- * Return the customer Id based on the username.
- */
-declare const getCustomerId: (props: GetCustomerId) => string;
-export default getCustomerId;

package/dist/cjs/brightData/getCustomerId.js

@@ -1,11 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * Return the customer Id based on the username.
- */
-const getCustomerId = (props) => {
-    const segments = props.auth.username.split("-")[2];
-    const customerId = segments[2].replace("hl_", "");
-    return (props?.prefix || "") + customerId;
-};
-exports.default = getCustomerId;

package/dist/cjs/brightData/getZone.d.ts

@@ -1,9 +0,0 @@
-import { Param } from "./param";
-type GetZone = {
-    auth: Param;
-};
-/**
- * Return the Zone based on the username.
- */
-declare const getZone: (props: GetZone) => string;
-export default getZone;

package/dist/cjs/brightData/getZone.js

@@ -1,10 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * Return the Zone based on the username.
- */
-const getZone = (props) => {
-    const segments = props.auth.username.split("-");
-    return segments[segments.length - 1];
-};
-exports.default = getZone;

package/dist/cjs/brightData/param.d.ts

@@ -1,9 +0,0 @@
-export type Param = {
-    apiKey: string;
-    host: string;
-    port: string;
-    username: string;
-    password: string;
-};
-declare const _default: {};
-export default _default;

package/dist/cjs/brightData/param.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = {};

package/dist/cjs/brightData/serpApi/buildGoogleSerpUrl.d.ts

@@ -1,32 +0,0 @@
-type BuildGoogleSerpUrl = {
-    country?: string;
-    device?: "mobile" | "android" | "androidTablet" | "iphone" | "ipad";
-    language?: string;
-    geoLocation?: string;
-    hotel?: {
-        dates?: string;
-        occupancy?: number;
-    };
-    pagination?: {
-        offset?: number;
-        perPage?: number;
-    };
-    searchType?: "images" | "jobs" | "news" | "shopping" | "video";
-    query: string;
-    googleDomain: string;
-    output?: "html" | "json";
-    returnType: "url" | "json";
-};
-/**
- * Construct the Google SERP url using Bright Data's API:
- * https://brightdata.com/cp/serp_api/api/google/search?id=c_2cef083f
- *
- * For geolocation use value from:
- * https://developers.google.com/google-ads/api/data/geotargets
- */
-declare const buildGoogleSerpUrl: (props: BuildGoogleSerpUrl) => string | {
-    query: {
-        q: string;
-    };
-};
-export default buildGoogleSerpUrl;

package/dist/cjs/brightData/serpApi/buildGoogleSerpUrl.js

@@ -1,115 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * Construct the Google SERP url using Bright Data's API:
- * https://brightdata.com/cp/serp_api/api/google/search?id=c_2cef083f
- *
- * For geolocation use value from:
- * https://developers.google.com/google-ads/api/data/geotargets
- */
-const buildGoogleSerpUrl = (props) => {
-    let url = new URL(`https://www.${props.googleDomain}/search`);
-    let params = {
-        query: {
-            q: props.query,
-        }
-    };
-    url.searchParams.append("q", props.query);
-    // Two-letter country code used to define the country of search
-    if (props?.country) {
-        params.query["gl"] = props.country;
-        url.searchParams.append("gl", props.country);
-    }
-    // Define what device type to be represented in user-agent - Default desktop
-    switch (props?.device) {
-        case "mobile":
-            params.query["brd_mobile"] = "1";
-            url.searchParams.append("brd_mobile", "1");
-            break;
-        case "android":
-            params.query["brd_mobile"] = "android";
-            url.searchParams.append("brd_mobile", "android");
-            break;
-        case "androidTablet":
-            params.query["brd_mobile"] = "android_tablet";
-            url.searchParams.append("brd_mobile", "android_tablet");
-            break;
-        case "ipad":
-            params.query["brd_mobile"] = "ipad";
-            url.searchParams.append("brd_mobile", "ipad");
-            break;
-        case "iphone":
-            params.query["brd_mobile"] = "ios";
-            url.searchParams.append("brd_mobile", "ios");
-            break;
-    }
-    // Stands for the encoded location you want to use for your search
-    if (props?.geoLocation) {
-        params.query["uule"] = props.geoLocation;
-        url.searchParams.append("uule", props.geoLocation);
-    }
-    if (props?.hotel) {
-        if (props.hotel?.dates) {
-            params.query["hotel_dates"] = props.hotel.dates.toString();
-            url.searchParams.append("hotel_dates", props.hotel.dates);
-        }
-        if (props.hotel?.occupancy) {
-            params.query["hotel_occupancy"] = props.hotel.occupancy.toString();
-            url.searchParams.append("hotel_occupancy", props.hotel.occupancy.toString());
-        }
-    }
-    // Two-letter language code used to define the page language
-    if (props?.language) {
-        params.query["uule"] = props.language;
-        url.searchParams.append("hl", props.language);
-    }
-    // Define search type. For regular search
-    switch (props?.searchType) {
-        case "images":
-            params.query["tbm"] = "isch";
-            url.searchParams.append("tbm", "isch");
-            break;
-        case "jobs":
-            params.query["ibp"] = "htl;jobs";
-            url.searchParams.append("ibp", "htl;jobs");
-            break;
-        case "news":
-            params.query["tbm"] = "nws";
-            url.searchParams.append("tbm", "nws");
-            break;
-        case "shopping":
-            params.query["tbm"] = "shop";
-            url.searchParams.append("tbm", "shop");
-            break;
-        case "video":
-            params.query["tbm"] = "vid";
-            url.searchParams.append("tbm", "vid");
-            break;
-    }
-    if (props?.pagination) {
-        // Define the result offset
-        if (props.pagination?.offset) {
-            params.query["start"] = props.pagination.offset.toString();
-            url.searchParams.append("start", props.pagination.offset.toString());
-        }
-        // Defines the number of results to return
-        if (props.pagination?.perPage) {
-            params.query["num"] = props.pagination.offset.toString();
-            url.searchParams.append("num", props.pagination.perPage.toString());
-        }
-    }
-    // Specify the output type
-    if ("json" === props.output) {
-        params["brd_json"] = "1";
-        url.searchParams.append("brn_json", "1");
-    }
-    else {
-        params["brd_json"] = "html";
-        url.searchParams.append("brn_json", "html");
-    }
-    if ("json" === props.returnType) {
-        return params;
-    }
-    return url.toString();
-};
-exports.default = buildGoogleSerpUrl;

package/dist/cjs/brightData/serpApi/buildGoogleTrendsUrl.d.ts

@@ -1,22 +0,0 @@
-type BuildGoogleTrendsUrl = {
-    country?: string;
-    language?: string;
-    category?: string;
-    date?: string;
-    searchType?: "images" | "news" | "shopping" | "youtube";
-    query: string;
-    returnType: "url" | "json";
-};
-/**
- * Construct the Google Trends url using Bright Data's API:
- * https://brightdata.com/cp/serp_api/api/google/trends?id=c_2cef083f
- *
- * For category use value from:
- * https://trends.google.com/trends/api/explore/pickers/category?lang=en-US&tz=240
- */
-declare const buildGoogleTrendsUrl: (props: BuildGoogleTrendsUrl) => string | {
-    query: {
-        q: string;
-    };
-};
-export default buildGoogleTrendsUrl;

package/dist/cjs/brightData/serpApi/buildGoogleTrendsUrl.js

@@ -1,60 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * Construct the Google Trends url using Bright Data's API:
- * https://brightdata.com/cp/serp_api/api/google/trends?id=c_2cef083f
- *
- * For category use value from:
- * https://trends.google.com/trends/api/explore/pickers/category?lang=en-US&tz=240
- */
-const buildGoogleTrendsUrl = (props) => {
-    let url = new URL(`http://trends.google.com/trends/explore`);
-    url.searchParams.append("q", props.query);
-    let params = {
-        query: {
-            q: props.query,
-        }
-    };
-    // Location of interest, two-letter country code
-    if (props?.country) {
-        params.query['geo'] = props.country;
-        url.searchParams.append("geo", props.country);
-    }
-    // Preferred language, two-letter language code
-    if (props?.language) {
-        params.query['hl'] = props.language;
-        url.searchParams.append("hl", props.language);
-    }
-    if (props?.category) {
-        params.query['cat'] = props.category;
-        url.searchParams.append("cat", props.category);
-    }
-    if (props?.date) {
-        params.query['date'] = props.date;
-        url.searchParams.append("date", props.date);
-    }
-    // Define search type. For regular search
-    switch (props?.searchType) {
-        case "images":
-            params.query['group'] = "images";
-            url.searchParams.append("gprop", "images");
-            break;
-        case "news":
-            params.query['group'] = "news";
-            url.searchParams.append("gprop", "news");
-            break;
-        case "shopping":
-            params.query['group'] = "froogle";
-            url.searchParams.append("gprop", "froogle");
-            break;
-        case "youtube":
-            params.query['group'] = "youtube";
-            url.searchParams.append("gprop", "youtube");
-            break;
-    }
-    if ("json" === props.returnType) {
-        return params;
-    }
-    return url.toString();
-};
-exports.default = buildGoogleTrendsUrl;

package/dist/cjs/brightData/serpApi/getAsyncRequestId.d.ts

@@ -1,14 +0,0 @@
-import { Param } from "../param";
-import { Type } from "./type";
-type GetAsyncRequestId = {
-    auth: Param;
-    data: object;
-    type: Type;
-};
-/**
- * Make an async request to the SERP API using the Bright Data proxy.
- * Returns a request ID used with getAsyncResults
- * https://docs.brightdata.com/scraping-automation/serp-api/asynchronous-requests
- */
-declare const getAsyncRequestId: (props: GetAsyncRequestId) => Promise<string>;
-export default getAsyncRequestId;

package/dist/cjs/brightData/serpApi/getAsyncRequestId.js

@@ -1,50 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const post_1 = __importDefault(require("../../axios/post"));
-const getCustomerId_1 = __importDefault(require("../getCustomerId"));
-const getZone_1 = __importDefault(require("../getZone"));
-const type_1 = require("./type");
-/**
- * Make an async request to the SERP API using the Bright Data proxy.
- * Returns a request ID used with getAsyncResults
- * https://docs.brightdata.com/scraping-automation/serp-api/asynchronous-requests
- */
-const getAsyncRequestId = async (props) => {
-    let url = "";
-    let response = "";
-    // Prevent auth requests getting blocked
-    process.env["NODE_TLS_REJECT_UNAUTHORIZED"] = "0";
-    const customerId = (0, getCustomerId_1.default)({
-        auth: props.auth,
-    });
-    const zone = (0, getZone_1.default)({
-        auth: props.auth,
-    });
-    switch (props.type) {
-        case type_1.Type.GOOGLE_TRENDS:
-            url = `https://api.brightdata.com/serp/trends?customer=${customerId}&zone=${zone}`;
-            break;
-        default:
-            url = `https://api.brightdata.com/serp/req?customer=${customerId}&zone=${zone}`;
-    }
-    const requestResponse = await (0, post_1.default)({
-        config: {
-            headers: {
-                Authorization: `Bearer ${props.auth.apiKey}`
-            },
-        },
-        data: props?.data || {},
-        url,
-    });
-    if (requestResponse.isSuccess()) {
-        response = requestResponse.getBodyDefaultTo({
-            defaultValue: "",
-            keys: ["response_id"],
-        });
-    }
-    return response;
-};
-exports.default = getAsyncRequestId;

package/dist/cjs/brightData/serpApi/getAsyncResults.d.ts

@@ -1,12 +0,0 @@
-import { Param } from "../param";
-import ApiResponse from "../../api/ApiResponse";
-type GetAsync = {
-    auth: Param;
-    requestId: string;
-};
-/**
- * Using the request ID from getAsyncRequestId fetch to see if the data is available.
- * https://docs.brightdata.com/scraping-automation/serp-api/asynchronous-requests
- */
-declare const getAsyncResults: (props: GetAsync) => Promise<ApiResponse>;
-export default getAsyncResults;