@socketsecurity/sdk 3.1.3 → 3.3.0

package/dist/utils.d.ts

@@ -1,5 +1,50 @@
 import type { QueryParams } from './types';
 export { createUserAgentFromPkgJson } from './user-agent';
+/**
+ * Calculate Jaccard similarity coefficient between two strings based on word sets.
+ * Returns a value between 0 (no overlap) and 1 (identical word sets).
+ *
+ * Formula: |A ∩ B| / |A ∪ B|
+ *
+ * @param str1 - First string to compare
+ * @param str2 - Second string to compare
+ * @returns Similarity coefficient (0-1)
+ *
+ * @example
+ * ```typescript
+ * calculateWordSetSimilarity('hello world', 'world hello') // 1.0 (same words)
+ * calculateWordSetSimilarity('hello world', 'goodbye world') // 0.33 (1/3 overlap)
+ * calculateWordSetSimilarity('hello', 'goodbye') // 0 (no overlap)
+ * ```
+ */
+export declare function calculateWordSetSimilarity(str1: string, str2: string): number;
+/**
+ * Filter error cause based on similarity to error message.
+ * Returns undefined if the cause should be omitted due to redundancy.
+ *
+ * Intelligently handles common error message patterns by:
+ * - Comparing full messages
+ * - Splitting on colons and comparing each part
+ * - Finding the highest similarity among all parts
+ *
+ * Examples:
+ * - "Socket API Request failed (400): Bad Request" vs "Bad Request"
+ * - "Error: Authentication: Token expired" vs "Token expired"
+ *
+ * @param errorMessage - Main error message
+ * @param errorCause - Detailed error cause/reason
+ * @param threshold - Similarity threshold (0-1), defaults to 0.6
+ * @returns The error cause if it should be kept, undefined otherwise
+ *
+ * @example
+ * ```typescript
+ * filterRedundantCause('Invalid token', 'The token is invalid') // undefined
+ * filterRedundantCause('Request failed', 'Rate limit exceeded') // 'Rate limit exceeded'
+ * filterRedundantCause('API Request failed (400): Bad Request', 'Bad Request') // undefined
+ * filterRedundantCause('Error: Auth: Token expired', 'Token expired') // undefined
+ * ```
+ */
+export declare function filterRedundantCause(errorMessage: string, errorCause: string | undefined, threshold?: number): string | undefined;
 /**
  * Normalize base URL by ensuring it ends with a trailing slash.
  * Required for proper URL joining with relative paths.
@@ -26,3 +71,19 @@ export declare function resolveAbsPaths(filepaths: string[], pathsRelativeTo?: s
  * Converts relative paths to absolute using current working directory as reference.
  */
 export declare function resolveBasePath(pathsRelativeTo?: string): string;
+/**
+ * Determine if a "reason" string should be omitted due to high similarity with error message.
+ * Uses Jaccard similarity to detect redundant phrasing.
+ *
+ * @param errorMessage - Main error message
+ * @param reason - Detailed reason/cause string
+ * @param threshold - Similarity threshold (0-1), defaults to 0.6
+ * @returns true if reason should be omitted (too similar)
+ *
+ * @example
+ * ```typescript
+ * shouldOmitReason('Invalid token', 'The token is invalid') // true (high overlap)
+ * shouldOmitReason('Request failed', 'Rate limit exceeded') // false (low overlap)
+ * ```
+ */
+export declare function shouldOmitReason(errorMessage: string, reason: string | undefined, threshold?: number): boolean;

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@socketsecurity/sdk",
-  "version": "3.1.3",
+  "version": "3.3.0",
+  "packageManager": "pnpm@10.28.1",
   "license": "MIT",
   "description": "SDK for the Socket API client",
   "author": {
@@ -45,27 +46,35 @@
     "lint": "node scripts/lint.mjs",
     "precommit": "pnpm run check --lint --staged",
     "prepare": "husky",
+    "ci:validate": "node scripts/ci-validate.mjs",
     "prepublishOnly": "echo 'ERROR: Use GitHub Actions workflow for publishing' && exit 1",
     "publish": "node scripts/publish.mjs",
+    "publish:ci": "node scripts/publish.mjs --skip-git --skip-build --tag ${DIST_TAG:-latest}",
     "claude": "node scripts/claude.mjs",
     "test": "node scripts/test.mjs",
     "type": "tsgo --noEmit -p .config/tsconfig.check.json",
     "update": "node scripts/update.mjs"
   },
+  "dependencies": {
+    "@socketregistry/packageurl-js": "1.3.5",
+    "@socketsecurity/lib": "5.5.3",
+    "form-data": "4.0.5"
+  },
   "devDependencies": {
     "@babel/generator": "7.28.5",
     "@babel/parser": "7.26.3",
     "@babel/traverse": "7.26.4",
     "@babel/types": "7.26.3",
     "@biomejs/biome": "2.2.4",
+    "@dotenvx/dotenvx": "^1.51.4",
     "@eslint/compat": "1.3.2",
     "@eslint/js": "9.35.0",
-    "@socketregistry/packageurl-js": "1.3.5",
-    "@socketsecurity/lib": "3.2.4",
     "@types/babel__traverse": "7.28.0",
     "@types/node": "24.9.2",
     "@typescript/native-preview": "7.0.0-dev.20250926.1",
     "@vitest/coverage-v8": "4.0.3",
+    "@sveltejs/acorn-typescript": "1.0.8",
+    "acorn": "8.15.0",
     "del": "8.0.1",
     "dev-null-cli": "2.0.0",
     "esbuild": "0.25.11",
@@ -84,7 +93,7 @@
     "nock": "14.0.10",
     "openapi-typescript": "6.7.6",
     "semver": "7.7.2",
-    "taze": "19.6.0",
+    "taze": "19.9.2",
     "type-coverage": "2.29.7",
     "typescript-eslint": "8.44.1",
     "vitest": "4.0.3",
@@ -101,7 +110,7 @@
   },
   "engines": {
     "node": ">=18",
-    "pnpm": ">=10.16.0"
+    "pnpm": ">=10.25.0"
   },
   "files": [
     "CHANGELOG.md",