@socketsecurity/sdk 1.8.0 → 1.8.1

package/dist/socket-sdk-class.js

@@ -1,1342 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SocketSdk = void 0;
-/**
- * @fileoverview SocketSdk class implementation for Socket security API client.
- * Provides complete API functionality for vulnerability scanning, analysis, and reporting.
- */
-const node_events_1 = __importDefault(require("node:events"));
-const node_fs_1 = require("node:fs");
-const node_readline_1 = __importDefault(require("node:readline"));
-const abort_signal_1 = __importDefault(require("@socketsecurity/registry/lib/constants/abort-signal"));
-const socket_public_api_token_1 = __importDefault(require("@socketsecurity/registry/lib/constants/socket-public-api-token"));
-const unknown_error_1 = __importDefault(require("@socketsecurity/registry/lib/constants/unknown-error"));
-const debug_1 = require("@socketsecurity/registry/lib/debug");
-const json_1 = require("@socketsecurity/registry/lib/json");
-const objects_1 = require("@socketsecurity/registry/lib/objects");
-const promises_1 = require("@socketsecurity/registry/lib/promises");
-const url_1 = require("@socketsecurity/registry/lib/url");
-const constants_1 = require("./constants");
-const file_upload_1 = require("./file-upload");
-const http_client_1 = require("./http-client");
-const utils_1 = require("./utils");
-/**
- * Socket SDK for programmatic access to Socket.dev security analysis APIs.
- * Provides methods for package scanning, organization management, and security analysis.
- */
-class SocketSdk {
-    #apiToken;
-    #baseUrl;
-    #reqOptions;
-    /**
-     * Initialize Socket SDK with API token and configuration options.
-     * Sets up authentication, base URL, and HTTP client options.
-     */
-    constructor(apiToken, options) {
-        const { agent: agentOrObj, baseUrl = 'https://api.socket.dev/v0/', timeout, userAgent, } = { __proto__: null, ...options };
-        const agentKeys = agentOrObj ? Object.keys(agentOrObj) : [];
-        const agentAsGotOptions = agentOrObj;
-        const agent = (agentKeys.length && agentKeys.every(k => constants_1.httpAgentNames.has(k))
-            ? /* c8 ignore next 3 - Got-style agent options compatibility layer */
-                agentAsGotOptions.https ||
-                    agentAsGotOptions.http ||
-                    agentAsGotOptions.http2
-            : agentOrObj);
-        this.#apiToken = apiToken;
-        this.#baseUrl = (0, utils_1.normalizeBaseUrl)(baseUrl);
-        this.#reqOptions = {
-            ...(agent ? { agent } : {}),
-            headers: {
-                Authorization: `Basic ${btoa(`${apiToken}:`)}`,
-                'User-Agent': userAgent ?? constants_1.DEFAULT_USER_AGENT,
-            },
-            signal: abort_signal_1.default,
-            ...(timeout ? { timeout } : {}),
-        };
-    }
-    /**
-     * Create HTTP request for batch package URL processing.
-     * Internal method for handling PURL batch API calls with retry logic.
-     */
-    async #createBatchPurlRequest(componentsObj, queryParams) {
-        // Adds the first 'abort' listener to abortSignal.
-        const req = (0, http_client_1.getHttpModule)(this.#baseUrl)
-            .request(`${this.#baseUrl}purl?${(0, utils_1.queryToSearchParams)(queryParams)}`, {
-            method: 'POST',
-            ...this.#reqOptions,
-        })
-            .end(JSON.stringify(componentsObj));
-        const response = await (0, http_client_1.getResponse)(req);
-        // Throw ResponseError for non-2xx status codes so retry logic works properly.
-        if (!(0, http_client_1.isResponseOk)(response)) {
-            throw new http_client_1.ResponseError(response);
-        }
-        return response;
-    }
-    /**
-     * Create async generator for streaming batch package URL processing.
-     * Internal method for handling chunked PURL responses with error handling.
-     */
-    async *#createBatchPurlGenerator(componentsObj, queryParams) {
-        let res;
-        try {
-            res = await (0, promises_1.pRetry)(() => this.#createBatchPurlRequest(componentsObj, queryParams), {
-                retries: 4,
-                onRetryRethrow: true,
-                onRetry(_attempt, error) {
-                    /* c8 ignore next 3 - Early return for non-ResponseError types in retry logic, difficult to test without complex network error simulation. */
-                    if (!(error instanceof http_client_1.ResponseError)) {
-                        return;
-                    }
-                    const { statusCode } = error.response;
-                    // Don't retry authentication/authorization errors - they won't succeed.
-                    if (statusCode === 401 || statusCode === 403) {
-                        throw error;
-                    }
-                },
-            });
-        }
-        catch (e) {
-            yield await this.#handleApiError(e);
-            return;
-        }
-        // Parse the newline delimited JSON response.
-        const rli = node_readline_1.default.createInterface({
-            input: res,
-            crlfDelay: Infinity,
-            signal: abort_signal_1.default,
-        });
-        const isPublicToken = this.#apiToken === socket_public_api_token_1.default;
-        for await (const line of rli) {
-            const trimmed = line.trim();
-            const artifact = trimmed
-                ? (0, json_1.jsonParse)(line, { throws: false })
-                : /* c8 ignore next - Empty line handling in batch streaming response parsing. */ null;
-            if ((0, objects_1.isObjectObject)(artifact)) {
-                yield this.#handleApiSuccess(isPublicToken
-                    ? /* c8 ignore start - Public token artifact reshaping branch for policy compliance. */ (0, http_client_1.reshapeArtifactForPublicPolicy)(artifact, false, queryParams?.['actions'])
-                    : /* c8 ignore stop */
-                        artifact);
-            }
-        }
-    }
-    /**
-     * Handle API error responses and convert to standardized error result.
-     * Internal error handling with status code analysis and message formatting.
-     */
-    async #handleApiError(error) {
-        if (!(error instanceof http_client_1.ResponseError)) {
-            throw new Error('Unexpected Socket API error', {
-                cause: error,
-            });
-        }
-        const { statusCode } = error.response;
-        // Throw server errors (5xx) immediately - these are not recoverable client-side.
-        if (statusCode && statusCode >= 500) {
-            throw new Error(`Socket API server error (${statusCode})`, {
-                cause: error,
-            });
-        }
-        // The error payload may give a meaningful hint as to what went wrong.
-        const bodyStr = await (0, http_client_1.getErrorResponseBody)(error.response);
-        // Try to parse the body as JSON, fallback to treating as plain text.
-        let body;
-        try {
-            const parsed = JSON.parse(bodyStr);
-            // Client errors (4xx) should return actionable error messages.
-            // Extract both message and details from error response for better context.
-            if (typeof parsed?.error?.message === 'string') {
-                body = parsed.error.message;
-                // Include details if present for additional error context.
-                if (parsed.error.details) {
-                    const detailsStr = typeof parsed.error.details === 'string'
-                        ? parsed.error.details
-                        : JSON.stringify(parsed.error.details);
-                    body = `${body} - Details: ${detailsStr}`;
-                }
-            }
-        }
-        catch {
-            body = bodyStr;
-        }
-        // Build error message that includes the body content if available.
-        let errorMessage = error.message ?? unknown_error_1.default;
-        const trimmedBody = body?.trim();
-        if (trimmedBody && !errorMessage.includes(trimmedBody)) {
-            // Replace generic status message with actual error body if present,
-            // otherwise append the body to the error message.
-            const statusMessage = error.response?.statusMessage;
-            if (statusMessage && errorMessage.includes(statusMessage)) {
-                errorMessage = errorMessage.replace(statusMessage, trimmedBody);
-            }
-            else {
-                /* c8 ignore next 2 - edge case where statusMessage is undefined or not in error message. */
-                errorMessage = `${errorMessage}: ${trimmedBody}`;
-            }
-        }
-        return {
-            success: false,
-            /* c8 ignore next - fallback for missing status code in edge cases. */
-            status: statusCode ?? 0,
-            error: errorMessage,
-            cause: body,
-        };
-    }
-    /**
-     * Handle successful API responses and convert to standardized success result.
-     * Internal success handling with consistent response formatting.
-     */
-    #handleApiSuccess(data) {
-        return {
-            success: true,
-            // Use generic 200 OK status for all successful API responses.
-            status: 200,
-            data: data,
-        };
-    }
-    /**
-     * Fetch package analysis data for multiple packages in a single batch request.
-     * Returns all results at once after processing is complete.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async batchPackageFetch(componentsObj, queryParams) {
-        let res;
-        try {
-            res = await this.#createBatchPurlRequest(componentsObj, queryParams);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-        // Parse the newline delimited JSON response.
-        const rli = node_readline_1.default.createInterface({
-            input: res,
-            crlfDelay: Infinity,
-            signal: abort_signal_1.default,
-        });
-        const isPublicToken = this.#apiToken === socket_public_api_token_1.default;
-        const results = [];
-        for await (const line of rli) {
-            const trimmed = line.trim();
-            const artifact = trimmed
-                ? (0, json_1.jsonParse)(line, { throws: false })
-                : /* c8 ignore next - Empty line handling in batch parsing. */ null;
-            if ((0, objects_1.isObjectObject)(artifact)) {
-                results.push(isPublicToken
-                    ? /* c8 ignore start - Public token artifact reshaping for policy compliance. */
-                        (0, http_client_1.reshapeArtifactForPublicPolicy)(artifact, false, queryParams?.['actions'])
-                    : /* c8 ignore stop */
-                        artifact);
-            }
-        }
-        const compact = (0, url_1.urlSearchParamAsBoolean)((0, objects_1.getOwn)(queryParams, 'compact'));
-        return this.#handleApiSuccess(compact ? results : results);
-    }
-    /**
-     * Stream package analysis data for multiple packages with chunked processing and concurrency control.
-     * Returns results as they become available via async generator.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async *batchPackageStream(componentsObj, options) {
-        const { chunkSize = 100, concurrencyLimit = 10, queryParams, } = {
-            __proto__: null,
-            ...options,
-        };
-        // The createBatchPurlGenerator method will add 2 'abort' event listeners to
-        // abortSignal so we multiply the concurrencyLimit by 2.
-        const neededMaxListeners = concurrencyLimit * 2;
-        // Increase abortSignal max listeners count to avoid Node's MaxListenersExceededWarning.
-        const oldAbortSignalMaxListeners = node_events_1.default.getMaxListeners(abort_signal_1.default);
-        let abortSignalMaxListeners = oldAbortSignalMaxListeners;
-        /* c8 ignore start - EventTarget max listeners adjustment for high concurrency batch operations, difficult to test reliably. */
-        if (oldAbortSignalMaxListeners < neededMaxListeners) {
-            abortSignalMaxListeners = oldAbortSignalMaxListeners + neededMaxListeners;
-            node_events_1.default.setMaxListeners(abortSignalMaxListeners, abort_signal_1.default);
-        }
-        /* c8 ignore stop */
-        const { components } = componentsObj;
-        const { length: componentsCount } = components;
-        const running = [];
-        let index = 0;
-        const enqueueGen = () => {
-            if (index >= componentsCount) {
-                // No more work to do.
-                return;
-            }
-            const generator = this.#createBatchPurlGenerator({
-                // Chunk components.
-                components: components.slice(index, index + chunkSize),
-            }, queryParams);
-            continueGen(generator);
-            index += chunkSize;
-        };
-        const continueGen = (generator) => {
-            const { promise, reject: rejectFn, resolve: resolveFn, } = (0, utils_1.promiseWithResolvers)();
-            running.push({
-                generator,
-                promise,
-            });
-            void generator
-                .next()
-                .then(iteratorResult => resolveFn({ generator, iteratorResult }), rejectFn);
-        };
-        // Start initial batch of generators.
-        while (running.length < concurrencyLimit && index < componentsCount) {
-            enqueueGen();
-        }
-        while (running.length > 0) {
-            // eslint-disable-next-line no-await-in-loop
-            const { generator, iteratorResult } = await Promise.race(running.map(entry => entry.promise));
-            // Remove generator.
-            /* c8 ignore next 3 - Concurrent generator cleanup edge case. */
-            running.splice(running.findIndex(entry => entry.generator === generator), 1);
-            // Yield the value if one is given, even when done:true.
-            if (iteratorResult.value) {
-                yield iteratorResult.value;
-            }
-            if (iteratorResult.done) {
-                // Start a new generator if available.
-                enqueueGen();
-            }
-            else {
-                // Keep fetching values from this generator.
-                continueGen(generator);
-            }
-        }
-        // Reset abortSignal max listeners count.
-        /* c8 ignore start - Reset EventTarget max listeners to original value after batch operations. */
-        if (abortSignalMaxListeners > oldAbortSignalMaxListeners) {
-            node_events_1.default.setMaxListeners(oldAbortSignalMaxListeners, abort_signal_1.default);
-        }
-        /* c8 ignore stop */
-    }
-    /**
-     * Create a snapshot of project dependencies by uploading manifest files.
-     * Analyzes dependency files to generate a comprehensive security report.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async createDependenciesSnapshot(filepaths, pathsRelativeTo = '.', queryParams) {
-        const basePath = (0, utils_1.resolveBasePath)(pathsRelativeTo);
-        const absFilepaths = (0, utils_1.resolveAbsPaths)(filepaths, basePath);
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, file_upload_1.createUploadRequest)(this.#baseUrl, `dependencies/upload?${(0, utils_1.queryToSearchParams)(queryParams)}`, (0, file_upload_1.createRequestBodyForFilepaths)(absFilepaths, basePath), this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Create a comprehensive security scan for an organization.
-     * Uploads project files and initiates full security analysis.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async createOrgFullScan(orgSlug, filepaths, pathsRelativeTo = '.', queryParams) {
-        const basePath = (0, utils_1.resolveBasePath)(pathsRelativeTo);
-        const absFilepaths = (0, utils_1.resolveAbsPaths)(filepaths, basePath);
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, file_upload_1.createUploadRequest)(this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/full-scans?${(0, utils_1.queryToSearchParams)(queryParams)}`, (0, file_upload_1.createRequestBodyForFilepaths)(absFilepaths, basePath), this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Create a new repository in an organization.
-     * Registers a repository for monitoring and security scanning.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async createOrgRepo(orgSlug, queryParams) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createRequestWithJson)('POST', this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/repos`, queryParams, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Create a security scan by uploading project files.
-     * Analyzes uploaded files for security vulnerabilities and policy violations.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async createScanFromFilepaths(filepaths, pathsRelativeTo = '.', issueRules) {
-        const basePath = (0, utils_1.resolveBasePath)(pathsRelativeTo);
-        const absFilepaths = (0, utils_1.resolveAbsPaths)(filepaths, basePath);
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, file_upload_1.createUploadRequest)(this.#baseUrl, 'report/upload', [
-                ...(0, file_upload_1.createRequestBodyForFilepaths)(absFilepaths, basePath),
-                /* c8 ignore next 3 - Optional issueRules parameter edge case. */
-                ...(issueRules
-                    ? (0, file_upload_1.createRequestBodyForJson)(issueRules, 'issueRules')
-                    : []),
-            ], {
-                ...this.#reqOptions,
-                method: 'PUT',
-            })
-            /* c8 ignore next 3 - Success path return statement requires complex file upload mocking with authentication. */
-            );
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Delete a full scan from an organization.
-     * Permanently removes scan data and results.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async deleteOrgFullScan(orgSlug, fullScanId) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createDeleteRequest)(this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/full-scans/${encodeURIComponent(fullScanId)}`, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Delete a repository from an organization.
-     * Removes repository monitoring and associated scan data.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async deleteOrgRepo(orgSlug, repoSlug) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createDeleteRequest)(this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/repos/${encodeURIComponent(repoSlug)}`, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Retrieve audit log events for an organization.
-     * Returns chronological log of security and administrative actions.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async getAuditLogEvents(orgSlug, queryParams) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createGetRequest)(this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/audit-log?${(0, utils_1.queryToSearchParams)(queryParams)}`, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Retrieve the enabled entitlements for an organization.
-     *
-     * This method fetches the organization's entitlements and filters for only
-     * the enabled ones, returning their keys. Entitlements represent Socket
-     * Products that the organization has access to use.
-     */
-    async getEnabledEntitlements(orgSlug) {
-        const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createGetRequest)(this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/entitlements`, this.#reqOptions));
-        // Extract enabled products from the response.
-        const items = data?.items || [];
-        return items
-            .filter((item) => item && item.enabled === true && item.key)
-            .map((item) => item.key);
-    }
-    /**
-     * Retrieve all entitlements for an organization.
-     *
-     * This method fetches all entitlements (both enabled and disabled) for
-     * an organization, returning the complete list with their status.
-     */
-    async getEntitlements(orgSlug) {
-        const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createGetRequest)(this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/entitlements`, this.#reqOptions));
-        return data?.items || [];
-    }
-    /**
-     * Get security issues for a specific npm package and version.
-     * Returns detailed vulnerability and security alert information.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async getIssuesByNpmPackage(pkgName, version) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createGetRequest)(this.#baseUrl, `npm/${encodeURIComponent(pkgName)}/${encodeURIComponent(version)}/issues`, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Get analytics data for organization usage patterns and security metrics.
-     * Returns statistical analysis for specified time period.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async getOrgAnalytics(time) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createGetRequest)(this.#baseUrl, `analytics/org/${encodeURIComponent(time)}`, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * List all organizations accessible to the current user.
-     * Returns organization details and access permissions.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async getOrganizations() {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createGetRequest)(this.#baseUrl, 'organizations', this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Stream a full scan's results to file or stdout.
-     * Provides efficient streaming for large scan datasets.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async streamOrgFullScan(orgSlug, fullScanId, output) {
-        try {
-            const req = (0, http_client_1.getHttpModule)(this.#baseUrl)
-                .request(`${this.#baseUrl}orgs/${encodeURIComponent(orgSlug)}/full-scans/${encodeURIComponent(fullScanId)}`, {
-                method: 'GET',
-                ...this.#reqOptions,
-            })
-                .end();
-            const res = await (0, http_client_1.getResponse)(req);
-            // Check for HTTP error status codes.
-            if (!(0, http_client_1.isResponseOk)(res)) {
-                throw new http_client_1.ResponseError(res);
-            }
-            if (typeof output === 'string') {
-                // Stream to file
-                res.pipe((0, node_fs_1.createWriteStream)(output));
-            }
-            else if (output === true) {
-                // Stream to stdout
-                res.pipe(process.stdout);
-            }
-            // If output is false or undefined, just return the response without streaming
-            return this.#handleApiSuccess(res);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Stream patches for artifacts in a scan report.
-     *
-     * This method streams all available patches for artifacts in a scan.
-     * Free tier users will only receive free patches.
-     *
-     * Note: This method returns a ReadableStream for processing large datasets.
-     */
-    async streamPatchesFromScan(orgSlug, scanId) {
-        const response = await (0, http_client_1.createGetRequest)(this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/patches/scan/${encodeURIComponent(scanId)}`, this.#reqOptions);
-        // Check for HTTP error status codes.
-        if (!(0, http_client_1.isResponseOk)(response)) {
-            throw new http_client_1.ResponseError(response, 'GET Request failed');
-        }
-        // The response itself is the readable stream for NDJSON data
-        // Convert the Node.js readable stream to a Web ReadableStream
-        return new ReadableStream({
-            start(controller) {
-                response.on('data', (chunk) => {
-                    // Parse NDJSON chunks line by line
-                    const lines = chunk
-                        .toString()
-                        .split('\n')
-                        .filter(line => line.trim());
-                    for (const line of lines) {
-                        try {
-                            const data = JSON.parse(line);
-                            controller.enqueue(data);
-                        }
-                        catch (e) {
-                            // Skip invalid JSON lines
-                            continue;
-                        }
-                    }
-                });
-                response.on('end', () => {
-                    controller.close();
-                });
-                response.on('error', error => {
-                    /* c8 ignore next - Streaming error handler, difficult to test reliably. */
-                    controller.error(error);
-                });
-            },
-        });
-    }
-    /**
-     * Get complete full scan results in memory.
-     * Returns entire scan data as JSON for programmatic processing.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async getOrgFullScanBuffered(orgSlug, fullScanId) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createGetRequest)(this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/full-scans/${encodeURIComponent(fullScanId)}`, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * List all full scans for an organization.
-     * Returns paginated list of scan metadata and status.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async getOrgFullScanList(orgSlug, queryParams) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createGetRequest)(this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/full-scans?${(0, utils_1.queryToSearchParams)(queryParams)}`, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Get metadata for a specific full scan.
-     * Returns scan configuration, status, and summary information.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async getOrgFullScanMetadata(orgSlug, fullScanId) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createGetRequest)(this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/full-scans/${encodeURIComponent(fullScanId)}/metadata`, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Get organization's license policy configuration.
-     * Returns allowed, restricted, and monitored license types.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async getOrgLicensePolicy(orgSlug) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createGetRequest)(this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/settings/license-policy`, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Get details for a specific organization repository.
-     * Returns repository configuration, monitoring status, and metadata.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async getOrgRepo(orgSlug, repoSlug) {
-        const orgSlugParam = encodeURIComponent(orgSlug);
-        const repoSlugParam = encodeURIComponent(repoSlug);
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createGetRequest)(this.#baseUrl, `orgs/${orgSlugParam}/repos/${repoSlugParam}`, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * List all repositories in an organization.
-     * Returns paginated list of repository metadata and status.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async getOrgRepoList(orgSlug, queryParams) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createGetRequest)(this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/repos?${(0, utils_1.queryToSearchParams)(queryParams)}`, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Get organization's security policy configuration.
-     * Returns alert rules, severity thresholds, and enforcement settings.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async getOrgSecurityPolicy(orgSlug) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createGetRequest)(this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/settings/security-policy`, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Get current API quota usage and limits.
-     * Returns remaining requests, rate limits, and quota reset times.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async getQuota() {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createGetRequest)(this.#baseUrl, 'quota', this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Get analytics data for a specific repository.
-     * Returns security metrics, dependency trends, and vulnerability statistics.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async getRepoAnalytics(repo, time) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createGetRequest)(this.#baseUrl, `analytics/repo/${encodeURIComponent(repo)}/${encodeURIComponent(time)}`, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Get detailed results for a specific scan.
-     * Returns complete scan analysis including vulnerabilities and alerts.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async getScan(id) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createGetRequest)(this.#baseUrl, `report/view/${encodeURIComponent(id)}`, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * List all scans accessible to the current user.
-     * Returns paginated list of scan metadata and status.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async getScanList() {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createGetRequest)(this.#baseUrl, 'report/list', this.#reqOptions), 'GET');
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Get list of file types and formats supported for scanning.
-     * Returns supported manifest files, lockfiles, and configuration formats.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async getSupportedScanFiles() {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createGetRequest)(this.#baseUrl, 'report/supported', this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Get security score for a specific npm package and version.
-     * Returns numerical security rating and scoring breakdown.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async getScoreByNpmPackage(pkgName, version) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createGetRequest)(this.#baseUrl, `npm/${encodeURIComponent(pkgName)}/${encodeURIComponent(version)}/score`, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Update user or organization settings.
-     * Configures preferences, notifications, and security policies.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async postSettings(selectors) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createRequestWithJson)('POST', this.#baseUrl, 'settings', { json: selectors }, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Search for dependencies across monitored projects.
-     * Returns matching packages with security information and usage patterns.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async searchDependencies(queryParams) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createRequestWithJson)('POST', this.#baseUrl, 'dependencies/search', queryParams, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Update configuration for an organization repository.
-     * Modifies monitoring settings, branch configuration, and scan preferences.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async updateOrgRepo(orgSlug, repoSlug, queryParams) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createRequestWithJson)('POST', this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/repos/${encodeURIComponent(repoSlug)}`, queryParams, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Upload manifest files for dependency analysis.
-     * Processes package files to create dependency snapshots and security analysis.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async uploadManifestFiles(orgSlug, filepaths, pathsRelativeTo = '.') {
-        const basePath = (0, utils_1.resolveBasePath)(pathsRelativeTo);
-        const absFilepaths = (0, utils_1.resolveAbsPaths)(filepaths, basePath);
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, file_upload_1.createUploadRequest)(this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/upload-manifest-files`, (0, file_upload_1.createRequestBodyForFilepaths)(absFilepaths, basePath), this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            /* c8 ignore start - Error handling in uploadManifestFiles method for edge cases. */
-            return (await this.#handleApiError(e));
-            /* c8 ignore stop */
-        } /* c8 ignore next - Closing brace of error handling block. */
-    }
-    /**
-     * View detailed information about a specific patch by its UUID.
-     *
-     * This method retrieves comprehensive patch details including files,
-     * vulnerabilities, description, license, and tier information.
-     */
-    async viewPatch(orgSlug, uuid) {
-        const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createGetRequest)(this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/patches/view/${encodeURIComponent(uuid)}`, this.#reqOptions));
-        return data;
-    }
-    /**
-     * Delete a scan report permanently.
-     * Removes scan data and analysis results from the system.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async deleteReport(reportId) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createDeleteRequest)(this.#baseUrl, `report/delete/${encodeURIComponent(reportId)}`, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Export scan results in CycloneDX SBOM format.
-     * Returns Software Bill of Materials compliant with CycloneDX standard.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async exportCDX(orgSlug, fullScanId) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createGetRequest)(this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/full-scans/${encodeURIComponent(fullScanId)}/sbom/export/cdx`, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Export scan results in SPDX SBOM format.
-     * Returns Software Bill of Materials compliant with SPDX standard.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async exportSPDX(orgSlug, fullScanId) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createGetRequest)(this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/full-scans/${encodeURIComponent(fullScanId)}/sbom/export/spdx`, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Get list of API tokens for an organization.
-     * Returns organization API tokens with metadata and permissions.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async getAPITokens(orgSlug) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createGetRequest)(this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/tokens`, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Create a new API token for an organization.
-     * Generates API token with specified scopes and metadata.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async postAPIToken(orgSlug, tokenData) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createRequestWithJson)('POST', this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/tokens`, tokenData, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Update an existing API token for an organization.
-     * Modifies token metadata, scopes, or other properties.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async postAPITokenUpdate(orgSlug, tokenId, updateData) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createRequestWithJson)('POST', this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/tokens/${encodeURIComponent(tokenId)}/update`, updateData, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Rotate an API token for an organization.
-     * Generates new token value while preserving token metadata.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async postAPITokensRotate(orgSlug, tokenId) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createRequestWithJson)('POST', this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/tokens/${encodeURIComponent(tokenId)}/rotate`, {}, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Revoke an API token for an organization.
-     * Permanently disables the token and removes access.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async postAPITokensRevoke(orgSlug, tokenId) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createRequestWithJson)('POST', this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/tokens/${encodeURIComponent(tokenId)}/revoke`, {}, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Update organization's security policy configuration.
-     * Modifies alert rules, severity thresholds, and enforcement settings.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async updateOrgSecurityPolicy(orgSlug, policyData) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createRequestWithJson)('POST', this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/settings/security-policy`, policyData, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Update organization's license policy configuration.
-     * Modifies allowed, restricted, and monitored license types.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async updateOrgLicensePolicy(orgSlug, policyData, queryParams) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createRequestWithJson)('POST', this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/settings/license-policy?${(0, utils_1.queryToSearchParams)(queryParams)}`, policyData, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Get organization triage settings and status.
-     * Returns alert triage configuration and current state.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async getOrgTriage(orgSlug) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createGetRequest)(this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/triage`, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Update alert triage status for an organization.
-     * Modifies alert resolution status and triage decisions.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async updateOrgAlertTriage(orgSlug, alertId, triageData) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createRequestWithJson)('PUT', this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/triage/${encodeURIComponent(alertId)}`, triageData, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Get list of repository labels for an organization.
-     * Returns all labels configured for repository management.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async getOrgRepoLabelList(orgSlug, repoSlug) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createGetRequest)(this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/repos/${encodeURIComponent(repoSlug)}/labels`, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Create a new repository label for an organization.
-     * Adds label for repository categorization and management.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async createOrgRepoLabel(orgSlug, repoSlug, labelData) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createRequestWithJson)('POST', this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/repos/${encodeURIComponent(repoSlug)}/labels`, labelData, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Get details for a specific repository label.
-     * Returns label configuration and metadata.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async getOrgRepoLabel(orgSlug, repoSlug, labelSlug) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createGetRequest)(this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/repos/${encodeURIComponent(repoSlug)}/labels/${encodeURIComponent(labelSlug)}`, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Update a repository label for an organization.
-     * Modifies label properties and configuration.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async updateOrgRepoLabel(orgSlug, repoSlug, labelSlug, labelData) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createRequestWithJson)('PUT', this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/repos/${encodeURIComponent(repoSlug)}/labels/${encodeURIComponent(labelSlug)}`, labelData, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Delete a repository label from an organization.
-     * Removes label and associated configuration.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async deleteOrgRepoLabel(orgSlug, repoSlug, labelSlug) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createDeleteRequest)(this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/repos/${encodeURIComponent(repoSlug)}/labels/${encodeURIComponent(labelSlug)}`, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Get details for a specific diff scan.
-     * Returns comparison between two full scans with artifact changes.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async getDiffScanById(orgSlug, diffScanId) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createGetRequest)(this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/diff-scans/${encodeURIComponent(diffScanId)}`, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Create a diff scan from two full scan IDs.
-     * Compares two existing full scans to identify changes.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async createOrgDiffScanFromIds(orgSlug, queryParams) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createRequestWithJson)('POST', this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/diff-scans?${(0, utils_1.queryToSearchParams)(queryParams)}`, {}, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * List all diff scans for an organization.
-     * Returns paginated list of diff scan metadata and status.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async listOrgDiffScans(orgSlug) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createGetRequest)(this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/diff-scans`, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Delete a diff scan from an organization.
-     * Permanently removes diff scan data and results.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    async deleteOrgDiffScan(orgSlug, diffScanId) {
-        try {
-            const data = await (0, http_client_1.getResponseJson)(await (0, http_client_1.createDeleteRequest)(this.#baseUrl, `orgs/${encodeURIComponent(orgSlug)}/diff-scans/${encodeURIComponent(diffScanId)}`, this.#reqOptions));
-            return this.#handleApiSuccess(data);
-        }
-        catch (e) {
-            return await this.#handleApiError(e);
-        }
-    }
-    /**
-     * Handle query API response data based on requested response type.
-     * Internal method for processing different response formats (json, text, response).
-     */
-    async #handleQueryResponseData(response, responseType) {
-        if (responseType === 'response') {
-            return response;
-        }
-        if (responseType === 'text') {
-            return (await this.#getResponseText(response));
-        }
-        if (responseType === 'json') {
-            return (await (0, http_client_1.getResponseJson)(response));
-        }
-        return response;
-    }
-    /**
-     * Extract text content from HTTP response stream.
-     * Internal method with size limits to prevent memory exhaustion.
-     */
-    async #getResponseText(response) {
-        const chunks = [];
-        let size = 0;
-        // 50MB limit to prevent out-of-memory errors from large responses.
-        const MAX = 50 * 1024 * 1024;
-        for await (const chunk of response) {
-            size += chunk.length;
-            /* c8 ignore next 3 - MAX size limit protection for edge cases */
-            if (size > MAX) {
-                throw new Error('Response body too large');
-            }
-            chunks.push(chunk);
-        }
-        return Buffer.concat(chunks).toString('utf8');
-    }
-    /**
-     * Create standardized error result from query operation exceptions.
-     * Internal error handling for non-throwing query API methods.
-     */
-    #createQueryErrorResult(e) {
-        if (e instanceof SyntaxError) {
-            // Try to get response text from enhanced error, fall back to regex pattern for compatibility.
-            const enhancedError = e;
-            let responseText = enhancedError.originalResponse || '';
-            /* c8 ignore next 5 - Empty response text fallback check for JSON parsing errors without originalResponse. */
-            if (!responseText) {
-                const match = e.message.match(/Invalid JSON response:\n([\s\S]*?)\n→/);
-                responseText = match?.[1] || '';
-            }
-            const preview = responseText.slice(0, 100) || '';
-            return {
-                ok: false,
-                message: 'Server returned invalid JSON',
-                cause: `Please report this. JSON.parse threw an error over the following response: \`${preview.trim()}${responseText.length > 100 ? '...' : ''}\``,
-            };
-        }
-        /* c8 ignore start - Defensive error stringification fallback branches for edge cases. */
-        const errStr = e ? String(e).trim() : '';
-        return {
-            ok: false,
-            message: 'API request failed',
-            cause: errStr || unknown_error_1.default,
-        };
-        /* c8 ignore stop */
-    }
-    /**
-     * Execute a raw GET request to any API endpoint with configurable response type.
-     */
-    async getApi(urlPath, options) {
-        const { responseType = 'response', throws = true } = {
-            __proto__: null,
-            ...options,
-        };
-        try {
-            const response = await (0, http_client_1.createGetRequest)(this.#baseUrl, urlPath, this.#reqOptions);
-            // Check for HTTP error status codes first.
-            if (!(0, http_client_1.isResponseOk)(response)) {
-                if (throws) {
-                    throw new http_client_1.ResponseError(response);
-                }
-                const errorResult = await this.#handleApiError(new http_client_1.ResponseError(response));
-                return {
-                    ok: false,
-                    code: errorResult.status,
-                    message: 'Socket API error',
-                    cause: errorResult.cause || errorResult.error,
-                    data: { code: errorResult.status },
-                };
-            }
-            const data = await this.#handleQueryResponseData(response, responseType);
-            if (throws) {
-                return data;
-            }
-            return {
-                ok: true,
-                data,
-            };
-        }
-        catch (e) {
-            if (throws) {
-                throw e;
-            }
-            if (e instanceof http_client_1.ResponseError) {
-                /* c8 ignore start - ResponseError handling in sendApi non-throwing mode */
-                // Re-use existing error handling logic from the SDK
-                const errorResult = await this.#handleApiError(e);
-                return {
-                    ok: false,
-                    code: errorResult.status,
-                    message: 'Socket API error',
-                    cause: errorResult.cause || errorResult.error,
-                    data: { code: errorResult.status },
-                };
-                /* c8 ignore stop */
-            } /* c8 ignore next - Closing brace of error result handling. */
-            /* c8 ignore next - Fallback error handling for non-ResponseError cases in getApi. */
-            return this.#createQueryErrorResult(e);
-        }
-    }
-    /**
-     * Send POST or PUT request with JSON body and return parsed JSON response.
-     */
-    async sendApi(urlPath, options) {
-        const { body, 
-        // Default to POST method for JSON API requests.
-        method = 'POST', throws = true, } = { __proto__: null, ...options };
-        try {
-            // Route to appropriate HTTP method handler (POST or PUT).
-            const response = await (0, http_client_1.createRequestWithJson)(method, this.#baseUrl, urlPath, body, this.#reqOptions);
-            return {
-                ok: true,
-                data: (await (0, http_client_1.getResponseJson)(response)),
-            };
-        }
-        catch (e) {
-            if (throws) {
-                throw e;
-            }
-            if (e instanceof http_client_1.ResponseError) {
-                // Re-use existing error handling logic from the SDK
-                const errorResult = await this.#handleApiError(e);
-                return {
-                    ok: false,
-                    code: errorResult.status,
-                    message: 'Socket API error',
-                    cause: errorResult.cause || errorResult.error,
-                    data: { code: errorResult.status },
-                };
-            }
-            /* c8 ignore start - Defensive error stringification fallback branches for sendApi edge cases. */
-            const errStr = e ? String(e).trim() : '';
-            return {
-                ok: false,
-                message: 'API request failed',
-                cause: errStr || unknown_error_1.default,
-            };
-            /* c8 ignore stop */
-        }
-    }
-}
-exports.SocketSdk = SocketSdk;
-// Optional live heap trace.
-/* c8 ignore start - optional debug logging for heap monitoring */
-if ((0, debug_1.isDebug)('heap')) {
-    const used = process.memoryUsage();
-    (0, debug_1.debugLog)('heap', `heap used: ${Math.round(used.heapUsed / 1024 / 1024)}MB`);
-}
-/* c8 ignore stop - end debug logging */
-//# sourceMappingURL=socket-sdk-class.js.map