@socketsecurity/sdk 3.2.0 → 3.3.0

package/dist/socket-sdk-class.d.ts

@@ -1,5 +1,5 @@
 import type { ArtifactPatches, BatchPackageFetchResultType, BatchPackageStreamOptions, CreateDependenciesSnapshotOptions, Entitlement, GetOptions, PatchViewResponse, PostOrgTelemetryPayload, PostOrgTelemetryResponse, QueryParams, SendOptions, SocketSdkGenericResult, SocketSdkOptions, SocketSdkResult, StreamOrgFullScanOptions, UploadManifestFilesError, UploadManifestFilesOptions, UploadManifestFilesReturnType } from './types';
-import type { CreateFullScanOptions, DeleteRepositoryLabelResult, DeleteResult, FullScanListResult, FullScanResult, ListFullScansOptions, ListRepositoriesOptions, OrganizationsResult, RepositoriesListResult, RepositoryLabelResult, RepositoryLabelsListResult, RepositoryResult, StrictErrorResult } from './types-strict';
+import type { CreateFullScanOptions, DeleteRepositoryLabelResult, DeleteResult, FullScanListResult, FullScanResult, GetRepositoryOptions, ListFullScansOptions, ListRepositoriesOptions, OrganizationsResult, RepositoriesListResult, RepositoryLabelResult, RepositoryLabelsListResult, RepositoryResult, StrictErrorResult } from './types-strict';
 import type { IncomingMessage } from 'node:http';
 /**
  * Socket SDK for programmatic access to Socket.dev security analysis APIs.
@@ -12,6 +12,45 @@ export declare class SocketSdk {
      * Sets up authentication, base URL, HTTP client options, retry behavior, and caching.
      */
     constructor(apiToken: string, options?: SocketSdkOptions | undefined);
+    /**
+     * Get package metadata and alerts by PURL strings for a specific organization.
+     * Organization-scoped version of batchPackageFetch with security policy label support.
+     *
+     * @param orgSlug - Organization identifier
+     * @param componentsObj - Object containing array of components with PURL strings
+     * @param queryParams - Optional query parameters including labels, alerts, compact, etc.
+     * @returns Package metadata and alerts for the requested PURLs
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.batchOrgPackageFetch('my-org',
+     *   {
+     *     components: [
+     *       { purl: 'pkg:npm/express@4.19.2' },
+     *       { purl: 'pkg:pypi/django@5.0.6' }
+     *     ]
+     *   },
+     *   { labels: ['production'], alerts: true }
+     * )
+     *
+     * if (result.success) {
+     *   for (const artifact of result.data) {
+     *     console.log(`${artifact.name}@${artifact.version}`)
+     *   }
+     * }
+     * ```
+     *
+     * @see https://docs.socket.dev/reference/batchpackagefetchbyorg
+     * @apiEndpoint POST /orgs/{org_slug}/purl
+     * @quota 100 units
+     * @scopes packages:list
+     * @throws {Error} When server returns 5xx status codes
+     */
+    batchOrgPackageFetch(orgSlug: string, componentsObj: {
+        components: Array<{
+            purl: string;
+        }>;
+    }, queryParams?: QueryParams | undefined): Promise<SocketSdkResult<'batchPackageFetchByOrg'>>;
     /**
      * Fetch package analysis data for multiple packages in a single batch request.
      * Returns all results at once after processing is complete.
@@ -41,13 +80,6 @@ export declare class SocketSdk {
      * @throws {Error} When server returns 5xx status codes
      */
     createDependenciesSnapshot(filepaths: string[], options?: CreateDependenciesSnapshotOptions | undefined): Promise<SocketSdkResult<'createDependenciesSnapshot'>>;
-    /**
-     * 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
-     */
-    createOrgDiffScanFromIds(orgSlug: string, queryParams?: QueryParams | undefined): Promise<SocketSdkResult<'createOrgDiffScanFromIds'>>;
     /**
      * Create a full security scan for an organization.
      *
@@ -85,6 +117,60 @@ export declare class SocketSdk {
      * @throws {Error} When server returns 5xx status codes
      */
     createFullScan(orgSlug: string, filepaths: string[], options: CreateFullScanOptions): Promise<FullScanResult | StrictErrorResult>;
+    /**
+     * 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
+     */
+    createOrgDiffScanFromIds(orgSlug: string, queryParams?: QueryParams | undefined): Promise<SocketSdkResult<'createOrgDiffScanFromIds'>>;
+    /**
+     * Create a full scan from an archive file (.tar, .tar.gz/.tgz, or .zip).
+     * Uploads and scans a compressed archive of project files.
+     *
+     * @param orgSlug - Organization identifier
+     * @param archivePath - Path to the archive file to upload
+     * @param options - Scan configuration options including repo, branch, and metadata
+     * @returns Created full scan details with scan ID and status
+     *
+     * @throws {Error} When server returns 5xx status codes or file cannot be read
+     */
+    createOrgFullScanFromArchive(orgSlug: string, archivePath: string, options: {
+        branch?: string | undefined;
+        commit_hash?: string | undefined;
+        commit_message?: string | undefined;
+        committers?: string | undefined;
+        integration_org_slug?: string | undefined;
+        integration_type?: 'api' | 'azure' | 'bitbucket' | 'github' | 'gitlab' | 'web' | undefined;
+        make_default_branch?: boolean | undefined;
+        pull_request?: number | undefined;
+        repo: string;
+        scan_type?: string | undefined;
+        set_as_pending_head?: boolean | undefined;
+        tmp?: boolean | undefined;
+        workspace?: string | undefined;
+    }): Promise<SocketSdkResult<'CreateOrgFullScanArchive'>>;
+    /**
+     * Create a new webhook for an organization.
+     * Webhooks allow you to receive HTTP POST notifications when specific events occur.
+     *
+     * @param orgSlug - Organization identifier
+     * @param webhookData - Webhook configuration including name, URL, secret, and events
+     * @returns Created webhook details including webhook ID
+     *
+     * @throws {Error} When server returns 5xx status codes
+     */
+    createOrgWebhook(orgSlug: string, webhookData: {
+        description?: null | string | undefined;
+        events: string[];
+        filters?: {
+            repositoryIds: null | string[];
+        } | null | undefined;
+        headers?: null | Record<string, unknown> | undefined;
+        name: string;
+        secret: string;
+        url: string;
+    }): Promise<SocketSdkResult<'createOrgWebhook'>>;
     /**
      * Create a new repository in an organization.
      *
@@ -140,39 +226,6 @@ export declare class SocketSdk {
      * @throws {Error} When server returns 5xx status codes
      */
     createRepositoryLabel(orgSlug: string, labelData: QueryParams): Promise<RepositoryLabelResult | StrictErrorResult>;
-    /**
-     * Create a full scan from an archive file (.tar, .tar.gz/.tgz, or .zip).
-     * Uploads and scans a compressed archive of project files.
-     *
-     * @param orgSlug - Organization identifier
-     * @param archivePath - Path to the archive file to upload
-     * @param options - Scan configuration options including repo, branch, and metadata
-     * @returns Created full scan details with scan ID and status
-     *
-     * @throws {Error} When server returns 5xx status codes or file cannot be read
-     */
-    createOrgFullScanFromArchive(orgSlug: string, archivePath: string, options: {
-        branch?: string | undefined;
-        commit_hash?: string | undefined;
-        commit_message?: string | undefined;
-        committers?: string | undefined;
-        integration_org_slug?: string | undefined;
-        integration_type?: 'api' | 'azure' | 'bitbucket' | 'github' | 'gitlab' | 'web' | undefined;
-        make_default_branch?: boolean | undefined;
-        pull_request?: number | undefined;
-        repo: string;
-        scan_type?: string | undefined;
-        set_as_pending_head?: boolean | undefined;
-        tmp?: boolean | undefined;
-        workspace?: string | undefined;
-    }): Promise<SocketSdkResult<'CreateOrgFullScanArchive'>>;
-    /**
-     * Delete a diff scan from an organization.
-     * Permanently removes diff scan data and results.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    deleteOrgDiffScan(orgSlug: string, diffScanId: string): Promise<SocketSdkResult<'deleteOrgDiffScan'>>;
     /**
      * Delete a full scan from an organization.
      *
@@ -198,6 +251,24 @@ export declare class SocketSdk {
      * @throws {Error} When server returns 5xx status codes
      */
     deleteFullScan(orgSlug: string, scanId: string): Promise<DeleteResult | StrictErrorResult>;
+    /**
+     * Delete a diff scan from an organization.
+     * Permanently removes diff scan data and results.
+     *
+     * @throws {Error} When server returns 5xx status codes
+     */
+    deleteOrgDiffScan(orgSlug: string, diffScanId: string): Promise<SocketSdkResult<'deleteOrgDiffScan'>>;
+    /**
+     * Delete a webhook from an organization.
+     * This will stop all future webhook deliveries to the webhook URL.
+     *
+     * @param orgSlug - Organization identifier
+     * @param webhookId - Webhook ID to delete
+     * @returns Success status
+     *
+     * @throws {Error} When server returns 5xx status codes
+     */
+    deleteOrgWebhook(orgSlug: string, webhookId: string): Promise<SocketSdkResult<'deleteOrgWebhook'>>;
     /**
      * Delete a repository from an organization.
      *
@@ -205,6 +276,7 @@ export declare class SocketSdk {
      *
      * @param orgSlug - Organization identifier
      * @param repoSlug - Repository slug/name to delete
+     * @param options - Optional parameters including workspace
      * @returns Success confirmation
      *
      * @example
@@ -222,7 +294,7 @@ export declare class SocketSdk {
      * @scopes repo:write
      * @throws {Error} When server returns 5xx status codes
      */
-    deleteRepository(orgSlug: string, repoSlug: string): Promise<DeleteResult | StrictErrorResult>;
+    deleteRepository(orgSlug: string, repoSlug: string, options?: GetRepositoryOptions | undefined): Promise<DeleteResult | StrictErrorResult>;
     /**
      * Delete a repository label from an organization.
      *
@@ -250,6 +322,55 @@ export declare class SocketSdk {
     deleteRepositoryLabel(orgSlug: string, labelId: string): Promise<DeleteRepositoryLabelResult | StrictErrorResult>;
     /**
      * Delete a legacy scan report permanently.
+  
+    /**
+     * Download patch file content by hash.
+     *
+     * Downloads the actual patched file content from the public Socket blob store.
+     * This is used after calling viewPatch() to get the patch metadata.
+     * No authentication is required as patch blobs are publicly accessible.
+     *
+     * @param hash - The blob hash in SSRI (sha256-base64) or hex format
+     * @param options - Optional configuration
+     * @param options.baseUrl - Override blob store URL (for testing)
+     * @returns Promise<string> - The patch file content as UTF-8 string
+     * @throws Error if blob not found (404) or download fails
+     *
+     * @example
+     * ```typescript
+     * const sdk = new SocketSdk('your-api-token')
+     * // First get patch metadata
+     * const patch = await sdk.viewPatch('my-org', 'patch-uuid')
+     * // Then download the actual patched file
+     * const fileContent = await sdk.downloadPatch(patch.files['index.js'].socketBlob)
+     * ```
+     */
+    downloadOrgFullScanFilesAsTar(orgSlug: string, fullScanId: string, outputPath: string): Promise<SocketSdkResult<'downloadOrgFullScanFilesAsTar'>>;
+    /**
+     * Download patch file content from Socket blob storage.
+     * Retrieves patched file contents using SSRI hash or hex hash.
+     *
+     * This is a low-level utility method - you'll typically use this after calling
+     * `viewPatch()` to get patch metadata, then download individual patched files.
+     *
+     * @param hash - The blob hash in SSRI (sha256-base64) or hex format
+     * @param options - Optional configuration
+     * @param options.baseUrl - Override blob store URL (for testing)
+     * @returns Promise<string> - The patch file content as UTF-8 string
+     * @throws Error if blob not found (404) or download fails
+     *
+     * @example
+     * ```typescript
+     * const sdk = new SocketSdk('your-api-token')
+     * // First get patch metadata
+     * const patch = await sdk.viewPatch('my-org', 'patch-uuid')
+     * // Then download the actual patched file
+     * const fileContent = await sdk.downloadPatch(patch.files['index.js'].socketBlob)
+     * ```
+     */
+    downloadPatch(hash: string, options?: {
+        baseUrl?: string | undefined;
+    } | undefined): Promise<string>;
     /**
      * Export scan results in CycloneDX SBOM format.
      * Returns Software Bill of Materials compliant with CycloneDX standard.
@@ -257,6 +378,39 @@ export declare class SocketSdk {
      * @throws {Error} When server returns 5xx status codes
      */
     exportCDX(orgSlug: string, fullScanId: string): Promise<SocketSdkResult<'exportCDX'>>;
+    /**
+     * Export vulnerability exploitability data as an OpenVEX v0.2.0 document.
+     * Includes patch data and reachability analysis for vulnerability assessment.
+     *
+     * @param orgSlug - Organization identifier
+     * @param id - Full scan or SBOM report ID
+     * @param options - Optional parameters including author, role, and document_id
+     * @returns OpenVEX document with vulnerability exploitability information
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.exportOpenVEX('my-org', 'scan-id', {
+     *   author: 'Security Team',
+     *   role: 'VEX Generator'
+     * })
+     *
+     * if (result.success) {
+     *   console.log('VEX Version:', result.data.version)
+     *   console.log('Statements:', result.data.statements.length)
+     * }
+     * ```
+     *
+     * @see https://docs.socket.dev/reference/exportopenvex
+     * @apiEndpoint GET /orgs/{org_slug}/export/openvex/{id}
+     * @quota 1 unit
+     * @scopes report:read
+     * @throws {Error} When server returns 5xx status codes
+     */
+    exportOpenVEX(orgSlug: string, id: string, options?: {
+        author?: string | undefined;
+        document_id?: string | undefined;
+        role?: string | undefined;
+    } | undefined): Promise<SocketSdkResult<'exportOpenVEX'>>;
     /**
      * Export scan results in SPDX SBOM format.
      * Returns Software Bill of Materials compliant with SPDX standard.
@@ -307,6 +461,60 @@ export declare class SocketSdk {
      * an organization, returning the complete list with their status.
      */
     getEntitlements(orgSlug: string): Promise<Entitlement[]>;
+    /**
+     * Get complete full scan results buffered in memory.
+     *
+     * Returns entire scan data as JSON for programmatic processing.
+     * For large scans, consider using streamFullScan() instead.
+     *
+     * @param orgSlug - Organization identifier
+     * @param scanId - Full scan identifier
+     * @returns Complete full scan data including all artifacts
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.getFullScan('my-org', 'scan_123')
+     *
+     * if (result.success) {
+     *   console.log('Scan status:', result.data.scan_state)
+     *   console.log('Repository:', result.data.repository_slug)
+     * }
+     * ```
+     *
+     * @see https://docs.socket.dev/reference/getorgfullscan
+     * @apiEndpoint GET /orgs/{org_slug}/full-scans/{full_scan_id}
+     * @quota 1 unit
+     * @scopes full-scans:list
+     * @throws {Error} When server returns 5xx status codes
+     */
+    getFullScan(orgSlug: string, scanId: string): Promise<FullScanResult | StrictErrorResult>;
+    /**
+     * Get metadata for a specific full scan.
+     *
+     * Returns scan configuration, status, and summary information without full artifact data.
+     * Useful for checking scan status without downloading complete results.
+     *
+     * @param orgSlug - Organization identifier
+     * @param scanId - Full scan identifier
+     * @returns Scan metadata including status and configuration
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.getFullScanMetadata('my-org', 'scan_123')
+     *
+     * if (result.success) {
+     *   console.log('Scan state:', result.data.scan_state)
+     *   console.log('Branch:', result.data.branch)
+     * }
+     * ```
+     *
+     * @see https://docs.socket.dev/reference/getorgfullscanmetadata
+     * @apiEndpoint GET /orgs/{org_slug}/full-scans/{full_scan_id}/metadata
+     * @quota 1 unit
+     * @scopes full-scans:list
+     * @throws {Error} When server returns 5xx status codes
+     */
+    getFullScanMetadata(orgSlug: string, scanId: string): Promise<FullScanResult | StrictErrorResult>;
     /**
      * Get security issues for a specific npm package and version.
      * Returns detailed vulnerability and security alert information.
@@ -315,19 +523,54 @@ export declare class SocketSdk {
      */
     getIssuesByNpmPackage(pkgName: string, version: string): Promise<SocketSdkResult<'getIssuesByNPMPackage'>>;
     /**
-     * List latest alerts for an organization (Beta).
-     * Returns paginated alerts with comprehensive filtering options.
+     * List full scans associated with a specific alert.
+     * Returns paginated full scan references for alert investigation.
      *
      * @param orgSlug - Organization identifier
-     * @param options - Optional query parameters for pagination and filtering
-     * @returns Paginated list of alerts with cursor-based pagination
+     * @param options - Query parameters including alertKey, range, pagination
+     * @returns Paginated array of full scans associated with the alert
      *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    getOrgAlertsList(orgSlug: string, options?: {
-        'filters.alertAction'?: string | undefined;
-        'filters.alertAction.notIn'?: string | undefined;
-        'filters.alertCategory'?: string | undefined;
+     * @example
+     * ```typescript
+     * const result = await sdk.getOrgAlertFullScans('my-org', {
+     *   alertKey: 'npm/lodash/cve-2021-23337',
+     *   range: '-7d',
+     *   per_page: 50
+     * })
+     *
+     * if (result.success) {
+     *   for (const item of result.data.items) {
+     *     console.log('Full Scan ID:', item.fullScanId)
+     *   }
+     * }
+     * ```
+     *
+     * @see https://docs.socket.dev/reference/alertfullscans
+     * @apiEndpoint GET /orgs/{org_slug}/alert-full-scan-search
+     * @quota 10 units
+     * @scopes alerts:list
+     * @throws {Error} When server returns 5xx status codes
+     */
+    getOrgAlertFullScans(orgSlug: string, options: {
+        alertKey: string;
+        per_page?: number | undefined;
+        range?: string | undefined;
+        startAfterCursor?: string | undefined;
+    }): Promise<SocketSdkResult<'alertFullScans'>>;
+    /**
+     * List latest alerts for an organization (Beta).
+     * Returns paginated alerts with comprehensive filtering options.
+     *
+     * @param orgSlug - Organization identifier
+     * @param options - Optional query parameters for pagination and filtering
+     * @returns Paginated list of alerts with cursor-based pagination
+     *
+     * @throws {Error} When server returns 5xx status codes
+     */
+    getOrgAlertsList(orgSlug: string, options?: {
+        'filters.alertAction'?: string | undefined;
+        'filters.alertAction.notIn'?: string | undefined;
+        'filters.alertCategory'?: string | undefined;
         'filters.alertCategory.notIn'?: string | undefined;
         'filters.alertCveId'?: string | undefined;
         'filters.alertCveId.notIn'?: string | undefined;
@@ -366,7 +609,7 @@ export declare class SocketSdk {
         'filters.repoSlug.notIn'?: string | undefined;
         per_page?: number | undefined;
         startAfterCursor?: string | undefined;
-    }): Promise<SocketSdkResult<'alertsList'>>;
+    } | undefined): Promise<SocketSdkResult<'alertsList'>>;
     /**
      * Get analytics data for organization usage patterns and security metrics.
      * Returns statistical analysis for specified time period.
@@ -375,140 +618,98 @@ export declare class SocketSdk {
      */
     getOrgAnalytics(time: string): Promise<SocketSdkResult<'getOrgAnalytics'>>;
     /**
-     * List all organizations accessible to the current user.
-     *
-     * Returns organization details and access permissions with guaranteed required fields.
-     *
-     * @returns List of organizations with metadata
+     * Fetch available fixes for vulnerabilities in a repository or scan.
+     * Returns fix recommendations including version upgrades and update types.
      *
-     * @example
-     * ```typescript
-     * const result = await sdk.listOrganizations()
+     * @param orgSlug - Organization identifier
+     * @param options - Fix query options including repo_slug or full_scan_id, vulnerability IDs, and preferences
+     * @returns Fix details for requested vulnerabilities with upgrade recommendations
      *
-     * if (result.success) {
-     *   result.data.organizations.forEach(org => {
-     *     console.log(org.name, org.slug)  // Guaranteed fields
-     *   })
-     * }
-     * ```
+     * @throws {Error} When server returns 5xx status codes
+     */
+    getOrgFixes(orgSlug: string, options: {
+        allow_major_updates: boolean;
+        full_scan_id?: string | undefined;
+        include_details?: boolean | undefined;
+        include_responsible_direct_dependencies?: boolean | undefined;
+        minimum_release_age?: string | undefined;
+        repo_slug?: string | undefined;
+        vulnerability_ids: string;
+    }): Promise<SocketSdkResult<'fetch-fixes'>>;
+    /**
+     * Get organization's license policy configuration.* Returns allowed, restricted, and monitored license types.
      *
-     * @see https://docs.socket.dev/reference/getorganizations
-     * @apiEndpoint GET /organizations
-     * @quota 1 unit
      * @throws {Error} When server returns 5xx status codes
      */
-    listOrganizations(): Promise<OrganizationsResult | StrictErrorResult>;
+    getOrgLicensePolicy(orgSlug: string): Promise<SocketSdkResult<'getOrgLicensePolicy'>>;
     /**
-     * Get complete full scan results buffered in memory.
+     * Get organization's security policy configuration.* Returns alert rules, severity thresholds, and enforcement settings.
      *
-     * Returns entire scan data as JSON for programmatic processing.
-     * For large scans, consider using streamFullScan() instead.
+     * @throws {Error} When server returns 5xx status codes
+     */
+    getOrgSecurityPolicy(orgSlug: string): Promise<SocketSdkResult<'getOrgSecurityPolicy'>>;
+    /**
+     * Get organization's telemetry configuration.
+     * Returns whether telemetry is enabled for the organization.
      *
      * @param orgSlug - Organization identifier
-     * @param scanId - Full scan identifier
-     * @returns Complete full scan data including all artifacts
-     *
-     * @example
-     * ```typescript
-     * const result = await sdk.getFullScan('my-org', 'scan_123')
-     *
-     * if (result.success) {
-     *   console.log('Scan status:', result.data.scan_state)
-     *   console.log('Repository:', result.data.repository_slug)
-     * }
-     * ```
+     * @returns Telemetry configuration with enabled status
      *
-     * @see https://docs.socket.dev/reference/getorgfullscan
-     * @apiEndpoint GET /orgs/{org_slug}/full-scans/{full_scan_id}
-     * @quota 1 unit
-     * @scopes full-scans:list
      * @throws {Error} When server returns 5xx status codes
      */
-    getFullScan(orgSlug: string, scanId: string): Promise<FullScanResult | StrictErrorResult>;
+    getOrgTelemetryConfig(orgSlug: string): Promise<SocketSdkResult<'getOrgTelemetryConfig'>>;
     /**
-     * List all full scans for an organization.
+     * Get organization triage settings and status.
+     * Returns alert triage configuration and current state.
      *
-     * Returns paginated list of full scan metadata with guaranteed required fields
-     * for improved TypeScript autocomplete.
+     * @throws {Error} When server returns 5xx status codes
+     */
+    getOrgTriage(orgSlug: string): Promise<SocketSdkResult<'getOrgTriage'>>;
+    /**
+     * Get details of a specific webhook.
+     * Returns webhook configuration including events, URL, and filters.
      *
      * @param orgSlug - Organization identifier
-     * @param options - Filtering and pagination options
-     * @returns List of full scans with metadata
-     *
-     * @example
-     * ```typescript
-     * const result = await sdk.listFullScans('my-org', {
-     *   branch: 'main',
-     *   per_page: 50,
-     *   use_cursor: true
-     * })
-     *
-     * if (result.success) {
-     *   result.data.results.forEach(scan => {
-     *     console.log(scan.id, scan.created_at)  // Guaranteed fields
-     *   })
-     * }
-     * ```
+     * @param webhookId - Webhook ID to retrieve
+     * @returns Webhook details
      *
-     * @see https://docs.socket.dev/reference/getorgfullscanlist
-     * @apiEndpoint GET /orgs/{org_slug}/full-scans
-     * @quota 1 unit
-     * @scopes full-scans:list
      * @throws {Error} When server returns 5xx status codes
      */
-    listFullScans(orgSlug: string, options?: ListFullScansOptions | undefined): Promise<FullScanListResult | StrictErrorResult>;
+    getOrgWebhook(orgSlug: string, webhookId: string): Promise<SocketSdkResult<'getOrgWebhook'>>;
     /**
-     * Get metadata for a specific full scan.
-     *
-     * Returns scan configuration, status, and summary information without full artifact data.
-     * Useful for checking scan status without downloading complete results.
+     * List all webhooks for an organization.
+     * Supports pagination and sorting options.
      *
      * @param orgSlug - Organization identifier
-     * @param scanId - Full scan identifier
-     * @returns Scan metadata including status and configuration
-     *
-     * @example
-     * ```typescript
-     * const result = await sdk.getFullScanMetadata('my-org', 'scan_123')
-     *
-     * if (result.success) {
-     *   console.log('Scan state:', result.data.scan_state)
-     *   console.log('Branch:', result.data.branch)
-     * }
-     * ```
+     * @param options - Optional query parameters for pagination and sorting
+     * @returns List of webhooks with pagination info
      *
-     * @see https://docs.socket.dev/reference/getorgfullscanmetadata
-     * @apiEndpoint GET /orgs/{org_slug}/full-scans/{full_scan_id}/metadata
-     * @quota 1 unit
-     * @scopes full-scans:list
      * @throws {Error} When server returns 5xx status codes
      */
-    getFullScanMetadata(orgSlug: string, scanId: string): Promise<FullScanResult | StrictErrorResult>;
+    getOrgWebhooksList(orgSlug: string, options?: {
+        direction?: string | undefined;
+        page?: number | undefined;
+        per_page?: number | undefined;
+        sort?: string | undefined;
+    } | undefined): Promise<SocketSdkResult<'getOrgWebhooksList'>>;
     /**
-     * Fetch available fixes for vulnerabilities in a repository or scan.
-     * Returns fix recommendations including version upgrades and update types.
-     *
-     * @param orgSlug - Organization identifier
-     * @param options - Fix query options including repo_slug or full_scan_id, vulnerability IDs, and preferences
-     * @returns Fix details for requested vulnerabilities with upgrade recommendations
+     * Get current API quota usage and limits.
+     * Returns remaining requests, rate limits, and quota reset times.
      *
      * @throws {Error} When server returns 5xx status codes
      */
-    getOrgFixes(orgSlug: string, options: {
-        allow_major_updates: boolean;
-        full_scan_id?: string | undefined;
-        include_details?: boolean | undefined;
-        include_responsible_direct_dependencies?: boolean | undefined;
-        minimum_release_age?: string | undefined;
-        repo_slug?: string | undefined;
-        vulnerability_ids: string;
-    }): Promise<SocketSdkResult<'fetch-fixes'>>;
+    getQuota(): Promise<SocketSdkResult<'getQuota'>>;
     /**
-     * Get organization's license policy configuration.* Returns allowed, restricted, and monitored license types.
+     * Get analytics data for a specific repository.
+     * Returns security metrics, dependency trends, and vulnerability statistics.
      *
      * @throws {Error} When server returns 5xx status codes
      */
-    getOrgLicensePolicy(orgSlug: string): Promise<SocketSdkResult<'getOrgLicensePolicy'>>;
+    getRepoAnalytics(repo: string, time: string): Promise<SocketSdkResult<'getRepoAnalytics'>>;
+    /**
+     * Get detailed results for a legacy scan report.
+    /**
+  
     /**
      * Get details for a specific repository.
      *
@@ -516,6 +717,7 @@ export declare class SocketSdk {
      *
      * @param orgSlug - Organization identifier
      * @param repoSlug - Repository slug/name
+     * @param options - Optional parameters including workspace
      * @returns Repository details with configuration
      *
      * @example
@@ -535,7 +737,7 @@ export declare class SocketSdk {
      * @scopes repo:read
      * @throws {Error} When server returns 5xx status codes
      */
-    getRepository(orgSlug: string, repoSlug: string): Promise<RepositoryResult | StrictErrorResult>;
+    getRepository(orgSlug: string, repoSlug: string, options?: GetRepositoryOptions | undefined): Promise<RepositoryResult | StrictErrorResult>;
     /**
      * Get details for a specific repository label.
      *
@@ -564,33 +766,82 @@ export declare class SocketSdk {
      */
     getRepositoryLabel(orgSlug: string, labelId: string): Promise<RepositoryLabelResult | StrictErrorResult>;
     /**
-     * List all repository labels for an organization.
+     * Get security score for a specific npm package and version.
+     * Returns numerical security rating and scoring breakdown.
      *
-     * Returns paginated list of labels configured for repository organization and policy management.
+     * @throws {Error} When server returns 5xx status codes
+     */
+    getScoreByNpmPackage(pkgName: string, version: string): Promise<SocketSdkResult<'getScoreByNPMPackage'>>;
+    /**
+     * 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
+     */
+    getSupportedScanFiles(): Promise<SocketSdkResult<'getReportSupportedFiles'>>;
+    /**
+     * List all full scans for an organization.
+     *
+     * Returns paginated list of full scan metadata with guaranteed required fields
+     * for improved TypeScript autocomplete.
      *
      * @param orgSlug - Organization identifier
-     * @param options - Pagination options
-     * @returns List of labels with guaranteed id and name fields
+     * @param options - Filtering and pagination options
+     * @returns List of full scans with metadata
      *
      * @example
      * ```typescript
-     * const result = await sdk.listRepositoryLabels('my-org', { per_page: 50, page: 1 })
+     * const result = await sdk.listFullScans('my-org', {
+     *   branch: 'main',
+     *   per_page: 50,
+     *   use_cursor: true
+     * })
      *
      * if (result.success) {
-     *   result.data.results.forEach(label => {
-     *     console.log('Label:', label.name)
-     *     console.log('Associated repos:', label.repository_ids?.length || 0)
+     *   result.data.results.forEach(scan => {
+     *     console.log(scan.id, scan.created_at)  // Guaranteed fields
      *   })
      * }
      * ```
      *
-     * @see https://docs.socket.dev/reference/getorgrepolabellist
-     * @apiEndpoint GET /orgs/{org_slug}/repos/labels
+     * @see https://docs.socket.dev/reference/getorgfullscanlist
+     * @apiEndpoint GET /orgs/{org_slug}/full-scans
      * @quota 1 unit
-     * @scopes repo-label:list
+     * @scopes full-scans:list
      * @throws {Error} When server returns 5xx status codes
      */
-    listRepositoryLabels(orgSlug: string, options?: QueryParams | undefined): Promise<RepositoryLabelsListResult | StrictErrorResult>;
+    listFullScans(orgSlug: string, options?: ListFullScansOptions | undefined): Promise<FullScanListResult | StrictErrorResult>;
+    /**
+     * List all organizations accessible to the current user.
+     *
+     * Returns organization details and access permissions with guaranteed required fields.
+     *
+     * @returns List of organizations with metadata
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.listOrganizations()
+     *
+     * if (result.success) {
+     *   result.data.organizations.forEach(org => {
+     *     console.log(org.name, org.slug)  // Guaranteed fields
+     *   })
+     * }
+     * ```
+     *
+     * @see https://docs.socket.dev/reference/getorganizations
+     * @apiEndpoint GET /organizations
+     * @quota 1 unit
+     * @throws {Error} When server returns 5xx status codes
+     */
+    listOrganizations(): Promise<OrganizationsResult | StrictErrorResult>;
+    /**
+     * List all diff scans for an organization.
+     * Returns paginated list of diff scan metadata and status.
+     *
+     * @throws {Error} When server returns 5xx status codes
+     */
+    listOrgDiffScans(orgSlug: string): Promise<SocketSdkResult<'listOrgDiffScans'>>;
     /**
      * List all repositories in an organization.
      *
@@ -623,56 +874,33 @@ export declare class SocketSdk {
      */
     listRepositories(orgSlug: string, options?: ListRepositoriesOptions | undefined): Promise<RepositoriesListResult | StrictErrorResult>;
     /**
-     * Get organization's security policy configuration.* Returns alert rules, severity thresholds, and enforcement settings.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    getOrgSecurityPolicy(orgSlug: string): Promise<SocketSdkResult<'getOrgSecurityPolicy'>>;
-    /**
-     * Get organization triage settings and status.
-     * Returns alert triage configuration and current state.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    getOrgTriage(orgSlug: string): Promise<SocketSdkResult<'getOrgTriage'>>;
-    /**
-     * Get current API quota usage and limits.
-     * Returns remaining requests, rate limits, and quota reset times.
+     * List all repository labels for an organization.
      *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    getQuota(): Promise<SocketSdkResult<'getQuota'>>;
-    /**
-     * Get analytics data for a specific repository.
-     * Returns security metrics, dependency trends, and vulnerability statistics.
+     * Returns paginated list of labels configured for repository organization and policy management.
      *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    getRepoAnalytics(repo: string, time: string): Promise<SocketSdkResult<'getRepoAnalytics'>>;
-    /**
-     * Get detailed results for a legacy scan report.
-    /**
-    /**
-     * Get security score for a specific npm package and version.
-     * Returns numerical security rating and scoring breakdown.
+     * @param orgSlug - Organization identifier
+     * @param options - Pagination options
+     * @returns List of labels with guaranteed id and name fields
      *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    getScoreByNpmPackage(pkgName: string, version: string): Promise<SocketSdkResult<'getScoreByNPMPackage'>>;
-    /**
-     * Get list of file types and formats supported for scanning.
-     * Returns supported manifest files, lockfiles, and configuration formats.
+     * @example
+     * ```typescript
+     * const result = await sdk.listRepositoryLabels('my-org', { per_page: 50, page: 1 })
      *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    getSupportedScanFiles(): Promise<SocketSdkResult<'getReportSupportedFiles'>>;
-    /**
-     * List all diff scans for an organization.
-     * Returns paginated list of diff scan metadata and status.
+     * if (result.success) {
+     *   result.data.results.forEach(label => {
+     *     console.log('Label:', label.name)
+     *     console.log('Associated repos:', label.repository_ids?.length || 0)
+     *   })
+     * }
+     * ```
      *
+     * @see https://docs.socket.dev/reference/getorgrepolabellist
+     * @apiEndpoint GET /orgs/{org_slug}/repos/labels
+     * @quota 1 unit
+     * @scopes repo-label:list
      * @throws {Error} When server returns 5xx status codes
      */
-    listOrgDiffScans(orgSlug: string): Promise<SocketSdkResult<'listOrgDiffScans'>>;
+    listRepositoryLabels(orgSlug: string, options?: QueryParams | undefined): Promise<RepositoryLabelsListResult | StrictErrorResult>;
     /**
      * Create a new API token for an organization.
      * Generates API token with specified scopes and metadata.
@@ -701,6 +929,17 @@ export declare class SocketSdk {
      * @throws {Error} When server returns 5xx status codes
      */
     postAPITokenUpdate(orgSlug: string, tokenId: string, updateData: QueryParams): Promise<SocketSdkResult<'postAPITokenUpdate'>>;
+    /**
+     * Post telemetry data for an organization.
+     * Sends telemetry events and analytics data for monitoring and analysis.
+     *
+     * @param orgSlug - Organization identifier
+     * @param telemetryData - Telemetry payload containing events and metrics
+     * @returns Empty object on successful submission
+     *
+     * @throws {Error} When server returns 5xx status codes
+     */
+    postOrgTelemetry(orgSlug: string, telemetryData: PostOrgTelemetryPayload): Promise<SocketSdkGenericResult<PostOrgTelemetryResponse>>;
     /**
      * Update user or organization settings.
      * Configures preferences, notifications, and security policies.
@@ -710,6 +949,42 @@ export declare class SocketSdk {
     postSettings(selectors: Array<{
         organization?: string | undefined;
     }>): Promise<SocketSdkResult<'postSettings'>>;
+    /**
+     * Create a new full scan by rescanning an existing scan.
+     * Supports shallow (policy reapplication) and deep (dependency resolution rerun) modes.
+     *
+     * @param orgSlug - Organization identifier
+     * @param fullScanId - Full scan ID to rescan
+     * @param options - Rescan options including mode (shallow or deep)
+     * @returns New scan ID and status
+     *
+     * @example
+     * ```typescript
+     * // Shallow rescan (reapply policies to cached data)
+     * const result = await sdk.rescanFullScan('my-org', 'scan_123', {
+     *   mode: 'shallow'
+     * })
+     *
+     * if (result.success) {
+     *   console.log('New Scan ID:', result.data.id)
+     *   console.log('Status:', result.data.status)
+     * }
+     *
+     * // Deep rescan (rerun dependency resolution)
+     * const deepResult = await sdk.rescanFullScan('my-org', 'scan_123', {
+     *   mode: 'deep'
+     * })
+     * ```
+     *
+     * @see https://docs.socket.dev/reference/rescanorgfullscan
+     * @apiEndpoint POST /orgs/{org_slug}/full-scans/{full_scan_id}/rescan
+     * @quota 1 unit
+     * @scopes full-scans:create
+     * @throws {Error} When server returns 5xx status codes
+     */
+    rescanFullScan(orgSlug: string, fullScanId: string, options?: {
+        mode?: 'shallow' | 'deep' | undefined;
+    } | undefined): Promise<SocketSdkResult<'rescanOrgFullScan'>>;
     /**
      * Search for dependencies across monitored projects.
      * Returns matching packages with security information and usage patterns.
@@ -781,6 +1056,47 @@ export declare class SocketSdk {
      * @throws {Error} When server returns 5xx status codes
      */
     updateOrgLicensePolicy(orgSlug: string, policyData: QueryParams, queryParams?: QueryParams | undefined): Promise<SocketSdkResult<'updateOrgLicensePolicy'>>;
+    /**
+     * Update organization's security policy configuration.* Modifies alert rules, severity thresholds, and enforcement settings.
+     *
+     * @throws {Error} When server returns 5xx status codes
+     */
+    updateOrgSecurityPolicy(orgSlug: string, policyData: QueryParams): Promise<SocketSdkResult<'updateOrgSecurityPolicy'>>;
+    /**
+     * Update organization's telemetry configuration.
+     * Enables or disables telemetry for the organization.
+     *
+     * @param orgSlug - Organization identifier
+     * @param telemetryData - Telemetry configuration with enabled flag
+     * @returns Updated telemetry configuration
+     *
+     * @throws {Error} When server returns 5xx status codes
+     */
+    updateOrgTelemetryConfig(orgSlug: string, telemetryData: {
+        enabled?: boolean | undefined;
+    }): Promise<SocketSdkResult<'updateOrgTelemetryConfig'>>;
+    /**
+     * Update an existing webhook's configuration.
+     * All fields are optional - only provided fields will be updated.
+     *
+     * @param orgSlug - Organization identifier
+     * @param webhookId - Webhook ID to update
+     * @param webhookData - Updated webhook configuration
+     * @returns Updated webhook details
+     *
+     * @throws {Error} When server returns 5xx status codes
+     */
+    updateOrgWebhook(orgSlug: string, webhookId: string, webhookData: {
+        description?: null | string | undefined;
+        events?: string[] | undefined;
+        filters?: {
+            repositoryIds: null | string[];
+        } | null | undefined;
+        headers?: null | Record<string, unknown> | undefined;
+        name?: string | undefined;
+        secret?: null | string | undefined;
+        url?: string | undefined;
+    }): Promise<SocketSdkResult<'updateOrgWebhook'>>;
     /**
      * Update configuration for a repository.
      *
@@ -789,6 +1105,7 @@ export declare class SocketSdk {
      * @param orgSlug - Organization identifier
      * @param repoSlug - Repository slug/name
      * @param params - Configuration updates (description, homepage, default_branch, etc.)
+     * @param options - Optional parameters including workspace
      * @returns Updated repository details
      *
      * @example
@@ -809,7 +1126,7 @@ export declare class SocketSdk {
      * @scopes repo:write
      * @throws {Error} When server returns 5xx status codes
      */
-    updateRepository(orgSlug: string, repoSlug: string, params?: QueryParams | undefined): Promise<RepositoryResult | StrictErrorResult>;
+    updateRepository(orgSlug: string, repoSlug: string, params?: QueryParams | undefined, options?: GetRepositoryOptions | undefined): Promise<RepositoryResult | StrictErrorResult>;
     /**
      * Update a repository label for an organization.
      *
@@ -837,12 +1154,6 @@ export declare class SocketSdk {
      * @throws {Error} When server returns 5xx status codes
      */
     updateRepositoryLabel(orgSlug: string, labelId: string, labelData: QueryParams): Promise<RepositoryLabelResult | StrictErrorResult>;
-    /**
-     * Update organization's security policy configuration.* Modifies alert rules, severity thresholds, and enforcement settings.
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    updateOrgSecurityPolicy(orgSlug: string, policyData: QueryParams): Promise<SocketSdkResult<'updateOrgSecurityPolicy'>>;
     /**
      * Upload manifest files for dependency analysis.
      * Processes package files to create dependency snapshots and security analysis.
@@ -857,167 +1168,4 @@ export declare class SocketSdk {
      * vulnerabilities, description, license, and tier information.
      */
     viewPatch(orgSlug: string, uuid: string): Promise<PatchViewResponse>;
-    /**
-     * Download patch file content by hash.
-     *
-     * Downloads the actual patched file content from the public Socket blob store.
-     * This is used after calling viewPatch() to get the patch metadata.
-     * No authentication is required as patch blobs are publicly accessible.
-     *
-     * @param hash - The blob hash in SSRI (sha256-base64) or hex format
-     * @param options - Optional configuration
-     * @param options.baseUrl - Override blob store URL (for testing)
-     * @returns Promise<string> - The patch file content as UTF-8 string
-     * @throws Error if blob not found (404) or download fails
-     *
-     * @example
-     * ```typescript
-     * const sdk = new SocketSdk('your-api-token')
-     * // First get patch metadata
-     * const patch = await sdk.viewPatch('my-org', 'patch-uuid')
-     * // Then download the actual patched file
-     * const fileContent = await sdk.downloadPatch(patch.files['index.js'].socketBlob)
-     * ```
-     */
-    downloadOrgFullScanFilesAsTar(orgSlug: string, fullScanId: string, outputPath: string): Promise<SocketSdkResult<'downloadOrgFullScanFilesAsTar'>>;
-    /**
-     * Download patch file content from Socket blob storage.
-     * Retrieves patched file contents using SSRI hash or hex hash.
-     *
-     * This is a low-level utility method - you'll typically use this after calling
-     * `viewPatch()` to get patch metadata, then download individual patched files.
-     *
-     * @param hash - The blob hash in SSRI (sha256-base64) or hex format
-     * @param options - Optional configuration
-     * @param options.baseUrl - Override blob store URL (for testing)
-     * @returns Promise<string> - The patch file content as UTF-8 string
-     * @throws Error if blob not found (404) or download fails
-     *
-     * @example
-     * ```typescript
-     * const sdk = new SocketSdk('your-api-token')
-     * // First get patch metadata
-     * const patch = await sdk.viewPatch('my-org', 'patch-uuid')
-     * // Then download the actual patched file
-     * const fileContent = await sdk.downloadPatch(patch.files['index.js'].socketBlob)
-     * ```
-     */
-    downloadPatch(hash: string, options?: {
-        baseUrl?: string;
-    }): Promise<string>;
-    /**
-     * Update organization's telemetry configuration.
-     * Enables or disables telemetry for the organization.
-     *
-     * @param orgSlug - Organization identifier
-     * @param telemetryData - Telemetry configuration with enabled flag
-     * @returns Updated telemetry configuration
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    updateOrgTelemetryConfig(orgSlug: string, telemetryData: {
-        enabled?: boolean | undefined;
-    }): Promise<SocketSdkResult<'updateOrgTelemetryConfig'>>;
-    /**
-     * Get organization's telemetry configuration.
-     * Returns whether telemetry is enabled for the organization.
-     *
-     * @param orgSlug - Organization identifier
-     * @returns Telemetry configuration with enabled status
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    getOrgTelemetryConfig(orgSlug: string): Promise<SocketSdkResult<'getOrgTelemetryConfig'>>;
-    /**
-     * Post telemetry data for an organization.
-     * Sends telemetry events and analytics data for monitoring and analysis.
-     *
-     * @param orgSlug - Organization identifier
-     * @param telemetryData - Telemetry payload containing events and metrics
-     * @returns Empty object on successful submission
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    postOrgTelemetry(orgSlug: string, telemetryData: PostOrgTelemetryPayload): Promise<SocketSdkGenericResult<PostOrgTelemetryResponse>>;
-    /**
-     * Create a new webhook for an organization.
-     * Webhooks allow you to receive HTTP POST notifications when specific events occur.
-     *
-     * @param orgSlug - Organization identifier
-     * @param webhookData - Webhook configuration including name, URL, secret, and events
-     * @returns Created webhook details including webhook ID
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    createOrgWebhook(orgSlug: string, webhookData: {
-        description?: null | string | undefined;
-        events: string[];
-        filters?: {
-            repositoryIds: null | string[];
-        } | null | undefined;
-        headers?: null | Record<string, unknown> | undefined;
-        name: string;
-        secret: string;
-        url: string;
-    }): Promise<SocketSdkResult<'createOrgWebhook'>>;
-    /**
-     * Delete a webhook from an organization.
-     * This will stop all future webhook deliveries to the webhook URL.
-     *
-     * @param orgSlug - Organization identifier
-     * @param webhookId - Webhook ID to delete
-     * @returns Success status
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    deleteOrgWebhook(orgSlug: string, webhookId: string): Promise<SocketSdkResult<'deleteOrgWebhook'>>;
-    /**
-     * Get details of a specific webhook.
-     * Returns webhook configuration including events, URL, and filters.
-     *
-     * @param orgSlug - Organization identifier
-     * @param webhookId - Webhook ID to retrieve
-     * @returns Webhook details
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    getOrgWebhook(orgSlug: string, webhookId: string): Promise<SocketSdkResult<'getOrgWebhook'>>;
-    /**
-     * List all webhooks for an organization.
-     * Supports pagination and sorting options.
-     *
-     * @param orgSlug - Organization identifier
-     * @param options - Optional query parameters for pagination and sorting
-     * @returns List of webhooks with pagination info
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    getOrgWebhooksList(orgSlug: string, options?: {
-        direction?: string | undefined;
-        page?: number | undefined;
-        per_page?: number | undefined;
-        sort?: string | undefined;
-    }): Promise<SocketSdkResult<'getOrgWebhooksList'>>;
-    /**
-     * Update an existing webhook's configuration.
-     * All fields are optional - only provided fields will be updated.
-     *
-     * @param orgSlug - Organization identifier
-     * @param webhookId - Webhook ID to update
-     * @param webhookData - Updated webhook configuration
-     * @returns Updated webhook details
-     *
-     * @throws {Error} When server returns 5xx status codes
-     */
-    updateOrgWebhook(orgSlug: string, webhookId: string, webhookData: {
-        description?: null | string | undefined;
-        events?: string[] | undefined;
-        filters?: {
-            repositoryIds: null | string[];
-        } | null | undefined;
-        headers?: null | Record<string, unknown> | undefined;
-        name?: string | undefined;
-        secret?: null | string | undefined;
-        url?: string | undefined;
-    }): Promise<SocketSdkResult<'updateOrgWebhook'>>;
 }