@js-recon/js-recon 1.3.1-beta.2

package/build/utility/openapiGenerator.js

@@ -0,0 +1,254 @@
+import * as globalsUtil from "./globals.js";
+import replacePlaceholders from "./replaceUrlPlaceholders.js";
+import chalk from "chalk";
+/**
+ * Returns the OpenAPI type string corresponding to the given value.
+ *
+ * If the value is null, returns "string" as OpenAPI 3.0 doesn't have a 'null' type.
+ * If the value is an array, returns "array".
+ * If the value is a primitive type (string, number, boolean), returns the corresponding OpenAPI type.
+ * If the value is an object, returns "object".
+ * For other types, returns "string" as a fallback.
+ * @param value - The value to determine the OpenAPI type for
+ * @returns The OpenAPI type string corresponding to the given value
+ */
+// Zod-style placeholder strings emitted by traceBody (e.g. "<number>", "<date>",
+// "<array>") carry the field's real type even though they're stringified. Map
+// them back to an OpenAPI type so the spec doesn't collapse every body field
+// to `type: "string"`.
+const ZOD_PLACEHOLDER_TYPE_MAP = {
+    string: "string",
+    number: "number",
+    integer: "integer",
+    bigint: "integer",
+    boolean: "boolean",
+    date: "string",
+    array: "array",
+    object: "object",
+    enum: "string",
+    literal: "string",
+    unknown: "string",
+    coerce: "string",
+};
+export const getZodPlaceholderType = (value) => {
+    var _a;
+    if (typeof value !== "string")
+        return null;
+    const match = /^<([a-zA-Z]+)>$/.exec(value);
+    if (!match)
+        return null;
+    return (_a = ZOD_PLACEHOLDER_TYPE_MAP[match[1]]) !== null && _a !== void 0 ? _a : null;
+};
+export const getOpenApiType = (value) => {
+    if (value === null) {
+        return "string"; // OpenAPI 3.0 doesn't have a 'null' type, use nullable
+    }
+    if (Array.isArray(value)) {
+        return "array";
+    }
+    const placeholderType = getZodPlaceholderType(value);
+    if (placeholderType)
+        return placeholderType;
+    const jsType = typeof value;
+    if (["string", "number", "boolean", "object"].includes(jsType)) {
+        return jsType;
+    }
+    return "string"; // Fallback for other types
+};
+/**
+ * Generates an OpenAPI v3 spec based on the given OpenAPI output items.
+ *
+ * @param items - The OpenAPI output items to generate the spec from
+ * @param chunks - The chunks of API endpoints that the items belong to
+ * @returns The generated OpenAPI v3 spec
+ */
+export const generateOpenapiV3Spec = (items, _chunks) => {
+    var _a;
+    const spec = {
+        openapi: "3.0.0",
+        info: {
+            title: "API Collection",
+            description: "A collection of API endpoints discovered by js-recon.",
+            version: "1.0.0",
+        },
+        servers: [
+            {
+                url: "{{baseUrl}}",
+                description: "Base URL for the API",
+            },
+        ],
+        paths: {},
+    };
+    // Tracks how many times we've already seen the same (path, method) so a
+    // second callsite gets a disambiguating fragment on its path key rather than
+    // being silently dropped. OpenAPI paths are opaque strings so a `#N` suffix
+    // is preserved by tools that key on it.
+    const callsiteCounts = new Map();
+    for (const item of items) {
+        let rawItemPath = typeof item.path === "string" ? replacePlaceholders(item.path) : "";
+        try {
+            if (rawItemPath.startsWith("http://") || rawItemPath.startsWith("https://")) {
+                rawItemPath = new URL(rawItemPath).pathname;
+            }
+        }
+        catch (_b) { }
+        const pathKeyBeforeQuery = rawItemPath.split("?")[0];
+        const basePathKey = replacePlaceholders(pathKeyBeforeQuery.startsWith("/") ? pathKeyBeforeQuery : `/${pathKeyBeforeQuery}`);
+        const VALID_METHODS = new Set(["get", "post", "put", "patch", "delete", "head", "options", "trace"]);
+        const rawMethod = typeof item.method === "string" ? item.method.toLowerCase() : "";
+        const methodIsValid = VALID_METHODS.has(rawMethod);
+        const method = methodIsValid ? rawMethod : "get";
+        const dedupeKey = `${method} ${basePathKey}`;
+        const seenBefore = (_a = callsiteCounts.get(dedupeKey)) !== null && _a !== void 0 ? _a : 0;
+        const pathKey = seenBefore === 0 ? basePathKey : `${basePathKey}#${seenBefore + 1}`;
+        callsiteCounts.set(dedupeKey, seenBefore + 1);
+        if (!spec.paths[pathKey]) {
+            spec.paths[pathKey] = {};
+        }
+        // Avoid overwriting if the same path & method already processed (only
+        // possible now when two identical items collide on the disambiguated
+        // path — guard kept for safety).
+        if (spec.paths[pathKey][method]) {
+            continue;
+        }
+        const parameters = Object.entries(item.headers || {}).map(([name, value]) => {
+            const schema = {
+                type: getOpenApiType(value),
+                example: value,
+            };
+            if (value === null) {
+                schema.nullable = true;
+            }
+            return {
+                name,
+                in: "header",
+                required: true, // Assuming headers found are required for the call to succeed as intended
+                schema,
+            };
+        });
+        // Extract path parameters. The negative lookbehind/lookahead avoids
+        // matching the inner braces of a `{{var}}` collection-level placeholder
+        // (e.g. `{{graphqlEndpoint}}`) as a path parameter.
+        const pathParams = pathKey.match(/(?<!\{)\{([^{}]+)\}(?!\})/g);
+        if (pathParams) {
+            for (const p of pathParams) {
+                const paramName = p.slice(1, -1);
+                parameters.push({
+                    name: paramName,
+                    in: "path",
+                    required: true,
+                    schema: { type: "string", example: "any" },
+                });
+            }
+        }
+        // Extract query parameters
+        try {
+            const url = new URL(replacePlaceholders(item.path), "http://dummybase");
+            const queryParams = url.searchParams;
+            queryParams.forEach((value, name) => {
+                parameters.push({
+                    name: name,
+                    in: "query",
+                    required: false, // Or determine based on logic
+                    schema: { type: "string", example: value },
+                });
+            });
+        }
+        catch (_e) {
+            // unparseable placeholder URLs
+            console.error(chalk.red(`[!] Failed to parse: ${item.path} as URL for query parameter extraction, skipping query params.`));
+        }
+        // Build a location description for server action entries.
+        let locationDescription;
+        if (item.serverActionCallFile || item.functionFile) {
+            const defLoc = `chunk ${item.chunkId} at ${item.functionFile}:${item.functionFileLine}`;
+            const callLoc = item.serverActionCallFile
+                ? `chunk ${item.serverActionCallChunkId} at ${item.serverActionCallFile}:${item.serverActionCallLine}`
+                : undefined;
+            locationDescription = `Defined in ${defLoc}`;
+            if (callLoc && callLoc !== `chunk ${item.chunkId} at ${item.functionFile}:${item.functionFileLine}`) {
+                locationDescription += `\nArguments from ${callLoc}`;
+            }
+            else if (callLoc) {
+                locationDescription += `\nArguments from ${callLoc}`;
+            }
+        }
+        const operationObject = Object.assign(Object.assign({ summary: item.summary || `${pathKey}` }, (locationDescription ? { description: locationDescription } : {})), { responses: {
+                "200": {
+                    description: "Successful response. The actual response will vary.",
+                },
+            }, tags: item.collectionFolder
+                ? [item.collectionFolder]
+                : globalsUtil.getOpenapiChunkTag()
+                    ? [item.chunkId]
+                    : [] });
+        if (!methodIsValid) {
+            operationObject.description =
+                `Note: original HTTP method ${JSON.stringify(item.method)} could not be determined; defaulted to GET — verify before use.`;
+        }
+        if (parameters.length > 0) {
+            operationObject.parameters = parameters;
+        }
+        if (item.body) {
+            let requestBody;
+            try {
+                const body = JSON.parse(item.body);
+                if (Array.isArray(body)) {
+                    // JSON-array body (e.g. Next.js Server Action arguments sent as
+                    // text/plain).  Represent as a raw string with the parsed array
+                    // as the example so tools show the actual expected shape.
+                    requestBody = {
+                        content: {
+                            "text/plain": {
+                                schema: { type: "string" },
+                                example: item.body,
+                            },
+                        },
+                    };
+                }
+                else if (typeof body === "object" && body !== null) {
+                    const properties = {};
+                    for (const key in body) {
+                        const value = body[key];
+                        const type = getOpenApiType(value);
+                        properties[key] = {
+                            type: type,
+                            example: value,
+                        };
+                        if (value === null) {
+                            properties[key].nullable = true;
+                        }
+                    }
+                    requestBody = {
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: "object",
+                                    properties: properties,
+                                },
+                            },
+                        },
+                    };
+                }
+                else {
+                    throw new Error("Body is not a JSON object.");
+                }
+            }
+            catch (error) {
+                // Fallback for non-JSON bodies
+                requestBody = {
+                    content: {
+                        "application/json": {
+                            schema: { type: "string" },
+                            example: item.body,
+                        },
+                    },
+                };
+            }
+            operationObject.requestBody = requestBody;
+        }
+        spec.paths[pathKey][method] = operationObject;
+    }
+    return spec;
+};
+//# sourceMappingURL=openapiGenerator.js.map

package/build/utility/openapiGenerator.js.map

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

package/build/utility/postmanGenerator.js

@@ -0,0 +1,216 @@
+import replacePlaceholders from "./replaceUrlPlaceholders.js";
+const buildBodyExample = (rawBody) => {
+    if (!rawBody)
+        return undefined;
+    // The body strings we produce in traceBody.ts are JSON-ish but use
+    // angle-bracketed placeholders for types (e.g. `"<string>"`). They are valid
+    // JSON, so just pretty-print whatever parses.
+    try {
+        return JSON.stringify(JSON.parse(rawBody), null, 2);
+    }
+    catch (_a) {
+        return rawBody;
+    }
+};
+const splitPath = (rawPath) => {
+    const [withoutQuery, queryString] = rawPath.split("?", 2);
+    const segments = withoutQuery.split("/").filter(Boolean);
+    const query = [];
+    if (queryString) {
+        for (const part of queryString.split("&")) {
+            const [k, v = ""] = part.split("=", 2);
+            if (k)
+                query.push({ key: decodeURIComponent(k), value: decodeURIComponent(v) });
+        }
+    }
+    return { segments, query };
+};
+/**
+ * Generates a Postman Collection v2.1 from the discovered endpoints, organising
+ * them into nested folders that mirror the URL path. The first matching folder
+ * is reused for sibling endpoints so importers don't end up with one folder per
+ * request.
+ *
+ * Path parameters (`{id}`) are not used as folder names — they belong to a
+ * specific endpoint, not the wider category — so when a segment is a path
+ * variable we attach the operation directly to its parent folder and let the
+ * request's full URL carry the variable.
+ */
+export const generatePostmanCollection = (items) => {
+    var _a, _b, _c, _d;
+    const collection = {
+        info: {
+            name: "API Collection",
+            description: "Endpoints discovered by js-recon, grouped by URL path.",
+            schema: "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
+        },
+        item: [],
+        variable: [
+            { key: "baseUrl", value: "https://example.com" },
+            { key: "graphqlEndpoint", value: "graphql" },
+        ],
+    };
+    // Tracks (folder-path) → existing PMItem so the second endpoint under the same folder and reuses it
+    const folderIndex = new Map();
+    folderIndex.set("", { name: "", item: collection.item });
+    const ensureFolder = (folderSegments) => {
+        let runningKey = "";
+        let parent = folderIndex.get("");
+        for (const segment of folderSegments) {
+            runningKey = runningKey ? `${runningKey}/${segment}` : segment;
+            let folder = folderIndex.get(runningKey);
+            if (!folder) {
+                folder = { name: segment, item: [] };
+                parent.item.push(folder);
+                folderIndex.set(runningKey, folder);
+            }
+            parent = folder;
+        }
+        return parent;
+    };
+    // Track repeat (path, method) occurrences so duplicate callsites get a
+    // disambiguating suffix on their request name. We intentionally do NOT
+    // skip duplicates here — each distinct callsite is preserved so a reviewer
+    // can compare the headers/body shapes for the same endpoint.
+    const callsiteCounts = new Map();
+    for (const item of items) {
+        let rawPath = typeof item.path === "string" ? item.path : "";
+        // If path is an absolute URL, extract just the pathname so we don't
+        // prepend {{baseUrl}} to an already-complete URL.
+        try {
+            if (rawPath.startsWith("http://") || rawPath.startsWith("https://")) {
+                const u = new URL(rawPath);
+                rawPath = u.pathname + (u.search || "");
+            }
+        }
+        catch (_e) {
+            // leave rawPath as-is if URL parsing fails
+        }
+        const normalized = replacePlaceholders(rawPath.startsWith("/") ? rawPath : `/${rawPath}`);
+        const method = typeof item.method === "string" ? item.method.toUpperCase() : "GET";
+        const dedupeKey = `${method} ${normalized}`;
+        const occurrenceIndex = (_a = callsiteCounts.get(dedupeKey)) !== null && _a !== void 0 ? _a : 0;
+        callsiteCounts.set(dedupeKey, occurrenceIndex + 1);
+        const { segments, query } = splitPath(normalized);
+        // Items with an explicit `collectionFolder` skip path-segment-derived
+        // folder hierarchy and are placed flat under a single named folder.
+        if (item.collectionFolder) {
+            const folder = ensureFolder([item.collectionFolder]);
+            const headers = Object.entries(item.headers || {}).map(([key, value]) => ({
+                key,
+                value: String(value),
+                type: "text",
+            }));
+            // Convert OpenAPI-style `{name}` path params to Postman `:name`,
+            // but leave `{{var}}` collection-variable placeholders untouched
+            // (Postman substitutes those at request time).
+            const pmUrlPath = segments.map((s) => s.startsWith("{{") && s.endsWith("}}")
+                ? s
+                : s.startsWith("{") && s.endsWith("}")
+                    ? `:${s.slice(1, -1)}`
+                    : s);
+            const request = {
+                method,
+                header: headers,
+                url: Object.assign({ raw: `{{baseUrl}}/${pmUrlPath.join("/")}${query.length > 0 ? "?" + query.map((q) => `${q.key}=${q.value}`).join("&") : ""}`, host: ["{{baseUrl}}"], path: pmUrlPath }, (query.length > 0 ? { query } : {})),
+            };
+            if (item.body) {
+                const bodyRaw = (_b = buildBodyExample(item.body)) !== null && _b !== void 0 ? _b : item.body;
+                request.body = {
+                    mode: "raw",
+                    raw: bodyRaw,
+                    options: { raw: { language: "json" } },
+                };
+            }
+            else {
+                request.body = { mode: "none" };
+            }
+            const descParts = [];
+            if (item.functionFile) {
+                descParts.push(`Found in ${item.functionFile}:${item.functionFileLine}`);
+            }
+            folder.item.push(Object.assign(Object.assign({ name: item.summary || `${method} request` }, (descParts.length > 0 ? { description: descParts.join("\n") } : {})), { request }));
+            continue;
+        }
+        // Folder segments = all path segments except path-parameter segments.
+        // A trailing `{id}` segment doesn't earn its own folder; we mount the
+        // request on the parent.
+        const folderSegments = [];
+        const pathVars = [];
+        for (const seg of segments) {
+            const isVar = seg.startsWith("{") && seg.endsWith("}");
+            if (isVar) {
+                pathVars.push({ key: seg.slice(1, -1), value: "" });
+            }
+            else {
+                folderSegments.push(seg);
+            }
+        }
+        // The leaf segment is the endpoint's own name; remove it from the
+        // folder hierarchy so the request lands directly in its parent folder.
+        const leaf = (_c = folderSegments.pop()) !== null && _c !== void 0 ? _c : "";
+        const folder = ensureFolder(folderSegments);
+        const headers = Object.entries(item.headers || {}).map(([key, value]) => ({
+            key,
+            value: String(value),
+            type: "text",
+        }));
+        const requestName = `${method} /${segments.join("/")}`;
+        const pmUrlPath = segments.map((s) => (s.startsWith("{") && s.endsWith("}") ? `:${s.slice(1, -1)}` : s));
+        const request = {
+            method,
+            header: headers,
+            url: Object.assign(Object.assign({ raw: `{{baseUrl}}/${pmUrlPath.join("/")}${query.length > 0 ? "?" + query.map((q) => `${q.key}=${q.value}`).join("&") : ""}`, host: ["{{baseUrl}}"], path: pmUrlPath }, (query.length > 0 ? { query } : {})), (pathVars.length > 0 ? { variable: pathVars } : {})),
+        };
+        if (item.body && ["POST", "PUT", "PATCH", "DELETE"].includes(method)) {
+            const bodyRaw = (_d = buildBodyExample(item.body)) !== null && _d !== void 0 ? _d : item.body;
+            // Skip bodies that are empty objects — they only contain unresolvable spread artifacts.
+            let isEmptyObject = false;
+            try {
+                const parsed = JSON.parse(bodyRaw);
+                isEmptyObject =
+                    typeof parsed === "object" &&
+                        parsed !== null &&
+                        !Array.isArray(parsed) &&
+                        Object.keys(parsed).length === 0;
+            }
+            catch (_f) { }
+            if (!isEmptyObject) {
+                request.body = {
+                    mode: "raw",
+                    raw: bodyRaw,
+                    options: { raw: { language: "json" } },
+                };
+            }
+            else {
+                request.body = { mode: "none" };
+            }
+        }
+        else {
+            request.body = { mode: "none" };
+        }
+        // Friendly request label — keep the leaf in the name to disambiguate
+        // siblings under the same parent (e.g. invoices vs invoices/latest).
+        // When an action name is available (e.g. Next.js Server Actions) it is
+        // appended in parentheses and used as the primary disambiguator so
+        // each entry is immediately identifiable without a bare counter.
+        // For plain endpoints that share a path/method, a #N counter is kept.
+        const leafName = leaf || segments[segments.length - 1] || "/";
+        const disambig = item.summary ? ` (${item.summary})` : occurrenceIndex > 0 ? ` #${occurrenceIndex + 1}` : "";
+        const descParts = [];
+        if (item.functionFile) {
+            descParts.push(`Defined in chunk ${item.chunkId} at ${item.functionFile}:${item.functionFileLine}`);
+        }
+        if (item.serverActionCallFile) {
+            descParts.push(`Arguments from chunk ${item.serverActionCallChunkId} at ${item.serverActionCallFile}:${item.serverActionCallLine}`);
+        }
+        const itemEntry = Object.assign(Object.assign({ name: `${method} ${leafName}${disambig}` }, (descParts.length > 0 ? { description: descParts.join("\n") } : {})), { request });
+        // If this URL has no folder segments at all (e.g. `/version`), put it
+        // at the top level so it isn't lost.
+        folder.item.push(itemEntry);
+        // Suppress unused requestName lint warning — kept for future use.
+        void requestName;
+    }
+    return collection;
+};
+//# sourceMappingURL=postmanGenerator.js.map

package/build/utility/postmanGenerator.js.map

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

package/build/utility/progressLog.js

@@ -0,0 +1,50 @@
+/**
+ * Computes a progress bar width that fits within the current terminal.
+ * @param formatOverhead Total visible characters in the format string excluding the bar itself
+ *                       (label before `[{bar}]` + stats after `[{bar}]` + surrounding brackets).
+ */
+export const computeBarSize = (formatOverhead) => {
+    const cols = process.stdout.columns || 80;
+    return Math.max(10, cols - formatOverhead);
+};
+/**
+ * Registers a SIGWINCH listener that keeps `bar.options.barsize` in sync with
+ * the terminal width for the lifetime of the bar. Call the returned cleanup
+ * function when the bar stops.
+ */
+export const watchBarResize = (bar, overhead) => {
+    const handler = () => {
+        bar.options.barsize = computeBarSize(overhead);
+    };
+    process.on("SIGWINCH", handler);
+    return () => process.off("SIGWINCH", handler);
+};
+let activeBarLogger = null;
+export const setActiveBarLogger = (logger) => {
+    activeBarLogger = logger;
+};
+export const progressLog = (message) => {
+    if (activeBarLogger) {
+        activeBarLogger.log(message + "\n");
+    }
+    else {
+        console.log(message);
+    }
+};
+export const progressError = (message) => {
+    if (activeBarLogger) {
+        activeBarLogger.log(message + "\n");
+    }
+    else {
+        console.error(message);
+    }
+};
+export const progressWarn = (message) => {
+    if (activeBarLogger) {
+        activeBarLogger.log(message + "\n");
+    }
+    else {
+        console.warn(message);
+    }
+};
+//# sourceMappingURL=progressLog.js.map

package/build/utility/progressLog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progressLog.js","sourceRoot":"","sources":["../../src/utility/progressLog.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,cAAsB,EAAU,EAAE;IAC7D,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;IAC1C,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,GAAG,cAAc,CAAC,CAAC;AAC/C,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,GAAQ,EAAE,QAAgB,EAAgB,EAAE;IACvE,MAAM,OAAO,GAAG,GAAG,EAAE;QACjB,GAAG,CAAC,OAAO,CAAC,OAAO,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IACnD,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAClD,CAAC,CAAC;AAEF,IAAI,eAAe,GAAqB,IAAI,CAAC;AAE7C,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAAwB,EAAQ,EAAE;IACjE,eAAe,GAAG,MAAM,CAAC;AAC7B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,OAAe,EAAQ,EAAE;IACjD,IAAI,eAAe,EAAE,CAAC;QAClB,eAAe,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACxC,CAAC;SAAM,CAAC;QACJ,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAAe,EAAQ,EAAE;IACnD,IAAI,eAAe,EAAE,CAAC;QAClB,eAAe,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACxC,CAAC;SAAM,CAAC;QACJ,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAe,EAAQ,EAAE;IAClD,IAAI,eAAe,EAAE,CAAC;QAClB,eAAe,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACxC,CAAC;SAAM,CAAC;QACJ,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1B,CAAC;AACL,CAAC,CAAC"}

package/build/utility/puppeteerInstance.js

@@ -0,0 +1,5 @@
+import puppeteerExtra from "puppeteer-extra";
+import StealthPlugin from "puppeteer-extra-plugin-stealth";
+puppeteerExtra.use(StealthPlugin());
+export default puppeteerExtra;
+//# sourceMappingURL=puppeteerInstance.js.map

package/build/utility/puppeteerInstance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"puppeteerInstance.js","sourceRoot":"","sources":["../../src/utility/puppeteerInstance.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,iBAAiB,CAAC;AAC7C,OAAO,aAAa,MAAM,gCAAgC,CAAC;AAG1D,cAAsB,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC;AAE7C,eAAe,cAA0C,CAAC"}

package/build/utility/replaceUrlPlaceholders.js

@@ -0,0 +1,48 @@
+/**
+ * Replaces all placeholders in a URL with their corresponding OpenAPI placeholder.
+ *
+ * Currently, supports the following placeholders:
+ * - `[MemberExpression -> <member_expression>]`
+ * - `[var <variable_name>]`
+ * - `[unresolved member expression]`
+ * - `[unresolved: <variable_name>]`
+ *
+ * The placeholders are replaced with the following OpenAPI placeholders:
+ * - `{<member_expression>}`
+ * - `{<variable_name>}`
+ * - `{unres_mem_exp_<appearance_count_like_1_and_2_in_case_found_multiple_times>}`
+ * - `{<variable_name>}`
+ */
+const replacePlaceholders = (url) => {
+    // match it against multiple regexes and replace with the right placeholder as per the openapi spec
+    // first for member expression
+    const memberExpressionRegex = /\[MemberExpression -> (.*?)\]/g;
+    const memberExpressionMatches = url.matchAll(memberExpressionRegex);
+    for (const match of memberExpressionMatches) {
+        url = url.replace(match[0], "{" + match[1] + "}");
+    }
+    // second goes `[var a]`
+    const varRegex = /\[var (.*?)\]/g;
+    const varMatches = url.matchAll(varRegex);
+    for (const match of varMatches) {
+        url = url.replace(match[0], "{" + match[1] + "}");
+    }
+    // `[unresolved member expression]` is a bit tricky, so
+    // will replace with `{unres_mem_exp_<appearance_count_like_1_and_2_in_case_found_multiple_times>}`
+    const unresolvedMemberExpressionRegex = /\[unresolved member expression\]/g;
+    const unresolvedMemberExpressionMatches = url.matchAll(unresolvedMemberExpressionRegex);
+    let appearanceCount = 1;
+    for (const match of unresolvedMemberExpressionMatches) {
+        url = url.replace(match[0], "{unres_mem_exp_" + appearanceCount + "}");
+        appearanceCount++;
+    }
+    // `[unresolved: a]` can't escape as well
+    const unresolvedRegex = /\[unresolved: (.*?)\]/g;
+    const unresolvedMatches = url.matchAll(unresolvedRegex);
+    for (const match of unresolvedMatches) {
+        url = url.replace(match[0], "{" + match[1] + "}");
+    }
+    return url;
+};
+export default replacePlaceholders;
+//# sourceMappingURL=replaceUrlPlaceholders.js.map

package/build/utility/replaceUrlPlaceholders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replaceUrlPlaceholders.js","sourceRoot":"","sources":["../../src/utility/replaceUrlPlaceholders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,mBAAmB,GAAG,CAAC,GAAW,EAAU,EAAE;IAChD,mGAAmG;IAEnG,8BAA8B;IAC9B,MAAM,qBAAqB,GAAG,gCAAgC,CAAC;IAC/D,MAAM,uBAAuB,GAAG,GAAG,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC;IACpE,KAAK,MAAM,KAAK,IAAI,uBAAuB,EAAE,CAAC;QAC1C,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;IACtD,CAAC;IAED,wBAAwB;IACxB,MAAM,QAAQ,GAAG,gBAAgB,CAAC;IAClC,MAAM,UAAU,GAAG,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC1C,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAC7B,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;IACtD,CAAC;IAED,uDAAuD;IACvD,mGAAmG;IACnG,MAAM,+BAA+B,GAAG,mCAAmC,CAAC;IAC5E,MAAM,iCAAiC,GAAG,GAAG,CAAC,QAAQ,CAAC,+BAA+B,CAAC,CAAC;IACxF,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,KAAK,MAAM,KAAK,IAAI,iCAAiC,EAAE,CAAC;QACpD,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,iBAAiB,GAAG,eAAe,GAAG,GAAG,CAAC,CAAC;QACvE,eAAe,EAAE,CAAC;IACtB,CAAC;IAED,yCAAyC;IACzC,MAAM,eAAe,GAAG,wBAAwB,CAAC;IACjD,MAAM,iBAAiB,GAAG,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IACxD,KAAK,MAAM,KAAK,IAAI,iBAAiB,EAAE,CAAC;QACpC,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,GAAG,CAAC;AACf,CAAC,CAAC;AAEF,eAAe,mBAAmB,CAAC"}