@socketsecurity/sdk 1.10.1 → 1.11.1

package/dist/index.js

@@ -1,52 +1,47 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.publicPolicy = exports.httpAgentNames = exports.DEFAULT_USER_AGENT = exports.resolveBasePath = exports.resolveAbsPaths = exports.queryToSearchParams = exports.promiseWithResolvers = exports.normalizeBaseUrl = exports.createUserAgentFromPkgJson = exports.SocketSdk = exports.hasQuotaForMethods = exports.getRequiredPermissions = exports.getQuotaUsageSummary = exports.getQuotaCost = exports.getMethodsByQuotaCost = exports.getMethodsByPermissions = exports.getMethodRequirements = exports.getAllMethodRequirements = exports.calculateTotalQuotaCost = exports.reshapeArtifactForPublicPolicy = exports.ResponseError = exports.isResponseOk = exports.getResponseJson = exports.getResponse = exports.getHttpModule = exports.getErrorResponseBody = exports.createRequestWithJson = exports.createGetRequest = exports.createDeleteRequest = exports.createUploadRequest = exports.createRequestBodyForJson = exports.createRequestBodyForFilepaths = void 0;
+'use strict';
+
+var constants = require('./constants.js');
+var utils = require('./utils.js');
+var fileUpload = require('./file-upload.js');
+var httpClient = require('./http-client.js');
+var quotaUtils = require('./quota-utils.js');
+var socketSdkClass = require('./socket-sdk-class.js');
+var userAgent = require('./user-agent.js');
+
 /**
  * @fileoverview Main entry point for the Socket SDK.
  * Provides the SocketSdk class and utility functions for Socket security analysis API interactions.
  */
-// Import from our modules
-const constants_1 = require("./constants");
-Object.defineProperty(exports, "DEFAULT_USER_AGENT", { enumerable: true, get: function () { return constants_1.DEFAULT_USER_AGENT; } });
-Object.defineProperty(exports, "httpAgentNames", { enumerable: true, get: function () { return constants_1.httpAgentNames; } });
-Object.defineProperty(exports, "publicPolicy", { enumerable: true, get: function () { return constants_1.publicPolicy; } });
-const utils_1 = require("./utils");
-Object.defineProperty(exports, "normalizeBaseUrl", { enumerable: true, get: function () { return utils_1.normalizeBaseUrl; } });
-Object.defineProperty(exports, "promiseWithResolvers", { enumerable: true, get: function () { return utils_1.promiseWithResolvers; } });
-Object.defineProperty(exports, "queryToSearchParams", { enumerable: true, get: function () { return utils_1.queryToSearchParams; } });
-Object.defineProperty(exports, "resolveAbsPaths", { enumerable: true, get: function () { return utils_1.resolveAbsPaths; } });
-Object.defineProperty(exports, "resolveBasePath", { enumerable: true, get: function () { return utils_1.resolveBasePath; } });
-// Re-export file upload functions
-const file_upload_1 = require("./file-upload");
-Object.defineProperty(exports, "createRequestBodyForFilepaths", { enumerable: true, get: function () { return file_upload_1.createRequestBodyForFilepaths; } });
-Object.defineProperty(exports, "createRequestBodyForJson", { enumerable: true, get: function () { return file_upload_1.createRequestBodyForJson; } });
-Object.defineProperty(exports, "createUploadRequest", { enumerable: true, get: function () { return file_upload_1.createUploadRequest; } });
-// Re-export HTTP client functions
-const http_client_1 = require("./http-client");
-Object.defineProperty(exports, "createDeleteRequest", { enumerable: true, get: function () { return http_client_1.createDeleteRequest; } });
-Object.defineProperty(exports, "createGetRequest", { enumerable: true, get: function () { return http_client_1.createGetRequest; } });
-Object.defineProperty(exports, "createRequestWithJson", { enumerable: true, get: function () { return http_client_1.createRequestWithJson; } });
-Object.defineProperty(exports, "getErrorResponseBody", { enumerable: true, get: function () { return http_client_1.getErrorResponseBody; } });
-Object.defineProperty(exports, "getHttpModule", { enumerable: true, get: function () { return http_client_1.getHttpModule; } });
-Object.defineProperty(exports, "getResponse", { enumerable: true, get: function () { return http_client_1.getResponse; } });
-Object.defineProperty(exports, "getResponseJson", { enumerable: true, get: function () { return http_client_1.getResponseJson; } });
-Object.defineProperty(exports, "isResponseOk", { enumerable: true, get: function () { return http_client_1.isResponseOk; } });
-Object.defineProperty(exports, "ResponseError", { enumerable: true, get: function () { return http_client_1.ResponseError; } });
-Object.defineProperty(exports, "reshapeArtifactForPublicPolicy", { enumerable: true, get: function () { return http_client_1.reshapeArtifactForPublicPolicy; } });
-// Re-export quota utility functions
-const quota_utils_1 = require("./quota-utils");
-Object.defineProperty(exports, "calculateTotalQuotaCost", { enumerable: true, get: function () { return quota_utils_1.calculateTotalQuotaCost; } });
-Object.defineProperty(exports, "getAllMethodRequirements", { enumerable: true, get: function () { return quota_utils_1.getAllMethodRequirements; } });
-Object.defineProperty(exports, "getMethodRequirements", { enumerable: true, get: function () { return quota_utils_1.getMethodRequirements; } });
-Object.defineProperty(exports, "getMethodsByPermissions", { enumerable: true, get: function () { return quota_utils_1.getMethodsByPermissions; } });
-Object.defineProperty(exports, "getMethodsByQuotaCost", { enumerable: true, get: function () { return quota_utils_1.getMethodsByQuotaCost; } });
-Object.defineProperty(exports, "getQuotaCost", { enumerable: true, get: function () { return quota_utils_1.getQuotaCost; } });
-Object.defineProperty(exports, "getQuotaUsageSummary", { enumerable: true, get: function () { return quota_utils_1.getQuotaUsageSummary; } });
-Object.defineProperty(exports, "getRequiredPermissions", { enumerable: true, get: function () { return quota_utils_1.getRequiredPermissions; } });
-Object.defineProperty(exports, "hasQuotaForMethods", { enumerable: true, get: function () { return quota_utils_1.hasQuotaForMethods; } });
-// Re-export the main SocketSdk class
-const socket_sdk_class_1 = require("./socket-sdk-class");
-Object.defineProperty(exports, "SocketSdk", { enumerable: true, get: function () { return socket_sdk_class_1.SocketSdk; } });
-// Re-export functions from modules
-const user_agent_1 = require("./user-agent");
-Object.defineProperty(exports, "createUserAgentFromPkgJson", { enumerable: true, get: function () { return user_agent_1.createUserAgentFromPkgJson; } });
+
+exports.DEFAULT_USER_AGENT = constants.DEFAULT_USER_AGENT;
+exports.httpAgentNames = constants.httpAgentNames;
+exports.publicPolicy = constants.publicPolicy;
+exports.normalizeBaseUrl = utils.normalizeBaseUrl;
+exports.promiseWithResolvers = utils.promiseWithResolvers;
+exports.queryToSearchParams = utils.queryToSearchParams;
+exports.resolveAbsPaths = utils.resolveAbsPaths;
+exports.resolveBasePath = utils.resolveBasePath;
+exports.createRequestBodyForFilepaths = fileUpload.createRequestBodyForFilepaths;
+exports.createRequestBodyForJson = fileUpload.createRequestBodyForJson;
+exports.createUploadRequest = fileUpload.createUploadRequest;
+exports.ResponseError = httpClient.ResponseError;
+exports.createDeleteRequest = httpClient.createDeleteRequest;
+exports.createGetRequest = httpClient.createGetRequest;
+exports.createRequestWithJson = httpClient.createRequestWithJson;
+exports.getErrorResponseBody = httpClient.getErrorResponseBody;
+exports.getHttpModule = httpClient.getHttpModule;
+exports.getResponse = httpClient.getResponse;
+exports.getResponseJson = httpClient.getResponseJson;
+exports.isResponseOk = httpClient.isResponseOk;
+exports.reshapeArtifactForPublicPolicy = httpClient.reshapeArtifactForPublicPolicy;
+exports.calculateTotalQuotaCost = quotaUtils.calculateTotalQuotaCost;
+exports.getAllMethodRequirements = quotaUtils.getAllMethodRequirements;
+exports.getMethodRequirements = quotaUtils.getMethodRequirements;
+exports.getMethodsByPermissions = quotaUtils.getMethodsByPermissions;
+exports.getMethodsByQuotaCost = quotaUtils.getMethodsByQuotaCost;
+exports.getQuotaCost = quotaUtils.getQuotaCost;
+exports.getQuotaUsageSummary = quotaUtils.getQuotaUsageSummary;
+exports.getRequiredPermissions = quotaUtils.getRequiredPermissions;
+exports.hasQuotaForMethods = quotaUtils.hasQuotaForMethods;
+exports.SocketSdk = socketSdkClass.SocketSdk;
+exports.createUserAgentFromPkgJson = userAgent.createUserAgentFromPkgJson;

package/dist/package.json.js

@@ -0,0 +1,212 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var name = "@socketsecurity/sdk";
+var version = "1.11.1";
+var license = "MIT";
+var description = "SDK for the Socket API client";
+var author = {
+	name: "Socket Inc",
+	email: "eng@socket.dev",
+	url: "https://socket.dev"
+};
+var homepage = "https://github.com/SocketDev/socket-sdk-js";
+var repository = {
+	type: "git",
+	url: "git://github.com/SocketDev/socket-sdk-js.git"
+};
+var type = "commonjs";
+var main = "./dist/index.js";
+var types = "./dist/index.d.ts";
+var exports$1 = {
+	".": {
+		types: "./dist/index.d.ts",
+		"default": "./dist/index.js"
+	},
+	"./testing": {
+		types: "./dist/testing.d.ts",
+		"default": "./dist/testing.js"
+	},
+	"./types/api-helpers": "./types/api-helpers.d.ts",
+	"./types/api-helpers.d.ts": "./types/api-helpers.d.ts",
+	"./types/api": "./types/api.d.ts",
+	"./types/api.d.ts": "./types/api.d.ts",
+	"./package.json": "./package.json"
+};
+var scripts = {
+	build: "pnpm run build:dist",
+	"build:dist": "pnpm run build:dist:src && pnpm run build:dist:types",
+	"build:dist:src": "pnpm run clean:dist && rollup -c .config/rollup.dist.config.mjs",
+	"build:dist:types": "pnpm run clean:dist:types && tsgo --project tsconfig.dts.json",
+	check: "run-p -c --aggregate-output check:*",
+	"check:lint": "eslint --config .config/eslint.config.mjs --report-unused-disable-directives .",
+	"check:lint:fix": "pnpm run check:lint -- --fix",
+	"check:tsc": "tsgo --noEmit -p .config/tsconfig.check.json",
+	"lint-ci": "pnpm run check:lint",
+	coverage: "run-s coverage:*",
+	"coverage:test": "run-s pretest:unit test:unit:coverage",
+	"coverage:type": "type-coverage",
+	"coverage:type:verbose": "type-coverage --detail",
+	"coverage:percent": "node scripts/get-coverage-percentage.mjs",
+	clean: "run-s -c clean:*",
+	"clean:cache": "del-cli '**/.cache'",
+	"clean:coverage": "del-cli '.type-coverage' 'coverage'",
+	"clean:dist": "del-cli 'dist' '**/*.tsbuildinfo' '.config/*.tsbuildinfo'",
+	"clean:dist:types": "del-cli 'dist/types'",
+	"clean:declarations": "del-cli '*.d.ts' '!api*.d.ts'",
+	"clean:node_modules": "del-cli '**/node_modules'",
+	fix: "run-s lint:fix",
+	"generate-sdk": "run-s generate-sdk:*",
+	"generate-sdk:01-prettify": "node scripts/prettify-base-json.mjs",
+	"generate-sdk:02-generate": "node scripts/generate-types.mjs > types/api.d.ts",
+	"generate-sdk:03-clean-api": "pnpm run fix && pnpm run fix",
+	"knip:dependencies": "knip --dependencies",
+	"knip:exports": "knip --include exports,duplicates",
+	lint: "oxlint -c=.config/.oxlintrc.json --ignore-path=.config/.oxlintignore --tsconfig=.config/tsconfig.json .",
+	"lint:fix": "run-s -c lint:fix:*",
+	"lint:fix:oxlint": "oxlint -c=.config/.oxlintrc.json --ignore-path=.config/.oxlintignore --tsconfig=.config/tsconfig.json --quiet --fix . | dev-null",
+	"lint:fix:biome": "biome format --log-level=none --fix . | dev-null",
+	"lint:fix:eslint": "eslint --config .config/eslint.config.mjs --report-unused-disable-directives --fix . | dev-null",
+	"lint-staged": "lint-staged",
+	precommit: "lint-staged",
+	prepare: "husky",
+	prepublishOnly: "echo 'ERROR: Use GitHub Actions workflow for publishing' && exit 1",
+	"pretest:unit": "pnpm run build",
+	test: "run-s check test:*",
+	"test:run": "node scripts/test.mjs",
+	"test:unit": "dotenvx -q run -f .env.test -- vitest --run",
+	"test:unit:update": "dotenvx -q run -f .env.test -- vitest --run --update",
+	"test:unit:coverage": "dotenvx -q run -f .env.test -- vitest run --coverage",
+	"test-ci": "dotenvx -q run -f .env.test -- vitest --run",
+	"type-ci": "pnpm run check:tsc",
+	"test-pre-commit": "dotenvx -q run -f .env.precommit -- pnpm test",
+	update: "run-p --aggregate-output update:*",
+	"update:deps": "node scripts/taze.mjs",
+	"update:socket": "pnpm -r update '@socketsecurity/*' --latest"
+};
+var dependencies = {
+	"@socketsecurity/registry": "1.5.1"
+};
+var devDependencies = {
+	"@babel/core": "7.28.4",
+	"@babel/plugin-transform-runtime": "7.28.3",
+	"@babel/preset-typescript": "7.27.1",
+	"@babel/runtime": "7.28.4",
+	"@biomejs/biome": "2.2.4",
+	"@dotenvx/dotenvx": "1.49.0",
+	"@eslint/compat": "1.3.2",
+	"@eslint/js": "9.35.0",
+	"@rollup/plugin-babel": "6.0.4",
+	"@rollup/plugin-commonjs": "28.0.6",
+	"@rollup/plugin-json": "6.1.0",
+	"@rollup/plugin-node-resolve": "16.0.1",
+	"@types/node": "24.6.2",
+	"@typescript-eslint/eslint-plugin": "8.44.1",
+	"@typescript-eslint/parser": "8.44.1",
+	"@typescript/native-preview": "7.0.0-dev.20250926.1",
+	"@vitest/coverage-v8": "3.2.4",
+	"del-cli": "6.0.0",
+	"dev-null-cli": "2.0.0",
+	eslint: "9.35.0",
+	"eslint-import-resolver-typescript": "4.4.4",
+	"eslint-plugin-import-x": "4.16.1",
+	"eslint-plugin-jsdoc": "57.0.8",
+	"eslint-plugin-n": "17.23.1",
+	"eslint-plugin-sort-destructure-keys": "2.0.0",
+	"eslint-plugin-unicorn": "56.0.1",
+	"fast-glob": "3.3.3",
+	globals: "16.4.0",
+	"http2-wrapper": "2.2.1",
+	husky: "9.1.7",
+	knip: "5.63.1",
+	"lint-staged": "16.1.6",
+	nock: "14.0.10",
+	"npm-run-all2": "8.0.4",
+	"openapi-typescript": "6.7.6",
+	oxlint: "1.15.0",
+	rollup: "4.50.1",
+	taze: "19.6.0",
+	trash: "10.0.0",
+	"type-coverage": "2.29.7",
+	"typescript-eslint": "8.44.1",
+	vitest: "3.2.4",
+	"yargs-parser": "22.0.0",
+	yoctocolors: "2.1.2"
+};
+var pnpm = {
+	overrides: {
+		vite: "7.1.5"
+	},
+	ignoredBuiltDependencies: [
+		"esbuild",
+		"unrs-resolver"
+	]
+};
+var engines = {
+	node: ">=18",
+	pnpm: ">=10.16.0"
+};
+var files = [
+	"dist/**",
+	"types/**",
+	"CHANGELOG.md",
+	"requirements.json"
+];
+var typeCoverage = {
+	cache: true,
+	atLeast: 99.6,
+	ignoreAsAssertion: true,
+	ignoreCatch: true,
+	ignoreEmptyType: true,
+	"ignore-non-null-assertion": true,
+	"ignore-type-assertion": true,
+	"ignore-files": "test/*",
+	strict: true
+};
+var rootPkgJson = {
+	name: name,
+	version: version,
+	license: license,
+	description: description,
+	author: author,
+	homepage: homepage,
+	repository: repository,
+	type: type,
+	main: main,
+	types: types,
+	exports: exports$1,
+	scripts: scripts,
+	dependencies: dependencies,
+	devDependencies: devDependencies,
+	pnpm: pnpm,
+	engines: engines,
+	files: files,
+	"lint-staged": {
+	"*.{cjs,js,json,md,mjs,mts,ts}": [
+		"pnpm run lint:fix:oxlint",
+		"pnpm run lint:fix:biome -- --no-errors-on-unmatched --files-ignore-unknown=true --colors=off"
+	]
+},
+	typeCoverage: typeCoverage
+};
+
+exports.author = author;
+exports.default = rootPkgJson;
+exports.dependencies = dependencies;
+exports.description = description;
+exports.devDependencies = devDependencies;
+exports.engines = engines;
+exports.exports = exports$1;
+exports.files = files;
+exports.homepage = homepage;
+exports.license = license;
+exports.main = main;
+exports.name = name;
+exports.pnpm = pnpm;
+exports.repository = repository;
+exports.scripts = scripts;
+exports.type = type;
+exports.typeCoverage = typeCoverage;
+exports.types = types;
+exports.version = version;

package/dist/quota-utils.d.ts

@@ -11,38 +11,45 @@ export declare function calculateTotalQuotaCost(methodNames: Array<SocketSdkOper
 /**
  * Get all available SDK methods with their requirements.
  * Returns complete mapping of methods to quota and permissions.
+ * Creates a fresh deep copy each time to prevent external mutations.
  */
 export declare function getAllMethodRequirements(): Record<string, ApiRequirement>;
 /**
  * Get complete requirement information for a SDK method.
  * Returns both quota cost and required permissions.
+ * Memoized to avoid repeated lookups for the same method.
  */
-export declare function getMethodRequirements(methodName: SocketSdkOperations | string): ApiRequirement;
+export declare const getMethodRequirements: (methodName: string) => ApiRequirement;
 /**
  * Get all methods that require specific permissions.
  * Returns methods that need any of the specified permissions.
+ * Memoized since the same permission queries are often repeated.
  */
-export declare function getMethodsByPermissions(permissions: string[]): string[];
+export declare const getMethodsByPermissions: (permissions: string[]) => string[];
 /**
  * Get all methods that consume a specific quota amount.
  * Useful for finding high-cost or free operations.
+ * Memoized to cache results for commonly queried quota costs.
  */
-export declare function getMethodsByQuotaCost(quotaCost: number): string[];
+export declare const getMethodsByQuotaCost: (quotaCost: number) => string[];
 /**
  * Get quota cost for a specific SDK method.
  * Returns the number of quota units consumed by the method.
+ * Memoized since quota costs are frequently queried.
  */
-export declare function getQuotaCost(methodName: SocketSdkOperations | string): number;
+export declare const getQuotaCost: (methodName: string) => number;
 /**
  * Get quota usage summary grouped by cost levels.
  * Returns methods categorized by their quota consumption.
+ * Memoized since the summary structure is immutable after load.
  */
-export declare function getQuotaUsageSummary(): Record<string, string[]>;
+export declare const getQuotaUsageSummary: () => Record<string, string[]>;
 /**
  * Get required permissions for a specific SDK method.
  * Returns array of permission strings needed to call the method.
+ * Memoized to cache permission lookups per method.
  */
-export declare function getRequiredPermissions(methodName: SocketSdkOperations | string): string[];
+export declare const getRequiredPermissions: (methodName: string) => string[];
 /**
  * Check if user has sufficient quota for method calls.
  * Returns true if available quota covers the total cost.

package/dist/quota-utils.js

@@ -1,152 +1,175 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.calculateTotalQuotaCost = calculateTotalQuotaCost;
-exports.getAllMethodRequirements = getAllMethodRequirements;
-exports.getMethodRequirements = getMethodRequirements;
-exports.getMethodsByPermissions = getMethodsByPermissions;
-exports.getMethodsByQuotaCost = getMethodsByQuotaCost;
-exports.getQuotaCost = getQuotaCost;
-exports.getQuotaUsageSummary = getQuotaUsageSummary;
-exports.getRequiredPermissions = getRequiredPermissions;
-exports.hasQuotaForMethods = hasQuotaForMethods;
+'use strict';
+
+var node_fs = require('node:fs');
+var path = require('node:path');
+var memoization = require('@socketsecurity/registry/lib/memoization');
+
 /** @fileoverview Quota utility functions for Socket SDK method cost lookup. */
-const node_fs_1 = require("node:fs");
-const node_path_1 = require("node:path");
-let requirements = null;
 /**
  * Load requirements.json data with caching.
  * Internal function for lazy loading quota requirements.
+ * Uses once() memoization to ensure file is only read once.
  */
-function loadRequirements() {
-    if (requirements) {
-        return requirements;
-    }
-    try {
-        // Resolve path relative to this module file location.
-        // When compiled, __dirname will point to dist/ directory.
-        // In source, __dirname points to src/ directory.
-        // requirements.json is always in the parent directory of dist/ or src/.
-        const requirementsPath = (0, node_path_1.join)(__dirname, '..', 'requirements.json');
-        const data = (0, node_fs_1.readFileSync)(requirementsPath, 'utf8');
-        requirements = JSON.parse(data);
-        return requirements;
-    }
-    catch (e) {
-        throw new Error('Failed to load "requirements.json"', { cause: e });
-    }
-}
+const loadRequirements = memoization.once(() => {
+  try {
+    // Resolve path relative to this module file location.
+    // When compiled, __dirname will point to dist/ directory.
+    // In source, __dirname points to src/ directory.
+    // requirements.json is always in the parent directory of dist/ or src/.
+    const requirementsPath = path.join(__dirname, '..', 'requirements.json');
+    const data = node_fs.readFileSync(requirementsPath, 'utf8');
+    return JSON.parse(data);
+  } catch (e) {
+    throw new Error('Failed to load "requirements.json"', {
+      cause: e
+    });
+  }
+});
+
 /**
  * Calculate total quota cost for multiple SDK method calls.
  * Returns sum of quota units for all specified methods.
  */
 function calculateTotalQuotaCost(methodNames) {
-    return methodNames.reduce((total, methodName) => {
-        return total + getQuotaCost(methodName);
-    }, 0);
+  return methodNames.reduce((total, methodName) => {
+    return total + getQuotaCost(methodName);
+  }, 0);
 }
+
 /**
  * Get all available SDK methods with their requirements.
  * Returns complete mapping of methods to quota and permissions.
+ * Creates a fresh deep copy each time to prevent external mutations.
  */
 function getAllMethodRequirements() {
-    const reqs = loadRequirements();
-    const result = {};
-    Object.entries(reqs.api).forEach(([methodName, requirement]) => {
-        result[methodName] = {
-            permissions: [...requirement.permissions],
-            quota: requirement.quota,
-        };
-    });
-    return result;
+  const reqs = loadRequirements();
+  const result = {};
+  Object.entries(reqs.api).forEach(([methodName, requirement]) => {
+    result[methodName] = {
+      permissions: [...requirement.permissions],
+      quota: requirement.quota
+    };
+  });
+  return result;
 }
+
 /**
  * Get complete requirement information for a SDK method.
  * Returns both quota cost and required permissions.
+ * Memoized to avoid repeated lookups for the same method.
  */
-function getMethodRequirements(methodName) {
-    const reqs = loadRequirements();
-    const requirement = reqs.api[methodName];
-    if (!requirement) {
-        throw new Error(`Unknown SDK method: "${methodName}"`);
-    }
-    return {
-        permissions: [...requirement.permissions],
-        quota: requirement.quota,
-    };
-}
+const getMethodRequirements = memoization.memoize(methodName => {
+  const reqs = loadRequirements();
+  const requirement = reqs.api[methodName];
+  if (!requirement) {
+    throw new Error(`Unknown SDK method: "${methodName}"`);
+  }
+  return {
+    permissions: [...requirement.permissions],
+    quota: requirement.quota
+  };
+}, {
+  name: 'getMethodRequirements'
+});
+
 /**
  * Get all methods that require specific permissions.
  * Returns methods that need any of the specified permissions.
+ * Memoized since the same permission queries are often repeated.
  */
-function getMethodsByPermissions(permissions) {
-    const reqs = loadRequirements();
-    return Object.entries(reqs.api)
-        .filter(([, requirement]) => {
-        return permissions.some(permission => requirement.permissions.includes(permission));
-    })
-        .map(([methodName]) => methodName)
-        .sort();
-}
+const getMethodsByPermissions = memoization.memoize(permissions => {
+  const reqs = loadRequirements();
+  return Object.entries(reqs.api).filter(([, requirement]) => {
+    return permissions.some(permission => requirement.permissions.includes(permission));
+  }).map(([methodName]) => methodName).sort();
+}, {
+  name: 'getMethodsByPermissions'
+});
+
 /**
  * Get all methods that consume a specific quota amount.
  * Useful for finding high-cost or free operations.
+ * Memoized to cache results for commonly queried quota costs.
  */
-function getMethodsByQuotaCost(quotaCost) {
-    const reqs = loadRequirements();
-    return Object.entries(reqs.api)
-        .filter(([, requirement]) => requirement.quota === quotaCost)
-        .map(([methodName]) => methodName)
-        .sort();
-}
+const getMethodsByQuotaCost = memoization.memoize(quotaCost => {
+  const reqs = loadRequirements();
+  return Object.entries(reqs.api).filter(([, requirement]) => requirement.quota === quotaCost).map(([methodName]) => methodName).sort();
+}, {
+  name: 'getMethodsByQuotaCost'
+});
+
 /**
  * Get quota cost for a specific SDK method.
  * Returns the number of quota units consumed by the method.
+ * Memoized since quota costs are frequently queried.
  */
-function getQuotaCost(methodName) {
-    const reqs = loadRequirements();
-    const requirement = reqs.api[methodName];
-    if (!requirement) {
-        throw new Error(`Unknown SDK method: "${methodName}"`);
-    }
-    return requirement.quota;
-}
+const getQuotaCost = memoization.memoize(methodName => {
+  const reqs = loadRequirements();
+  const requirement = reqs.api[methodName];
+  if (!requirement) {
+    throw new Error(`Unknown SDK method: "${methodName}"`);
+  }
+  return requirement.quota;
+}, {
+  name: 'getQuotaCost'
+});
+
 /**
  * Get quota usage summary grouped by cost levels.
  * Returns methods categorized by their quota consumption.
+ * Memoized since the summary structure is immutable after load.
  */
-function getQuotaUsageSummary() {
-    const reqs = loadRequirements();
-    const summary = {};
-    Object.entries(reqs.api).forEach(([methodName, requirement]) => {
-        const costKey = `${requirement.quota} units`;
-        if (!summary[costKey]) {
-            summary[costKey] = [];
-        }
-        summary[costKey].push(methodName);
-    });
-    // Sort methods within each cost level
-    Object.keys(summary).forEach(costKey => {
-        summary[costKey]?.sort();
-    });
-    return summary;
-}
+const getQuotaUsageSummary = memoization.memoize(() => {
+  const reqs = loadRequirements();
+  const summary = {};
+  Object.entries(reqs.api).forEach(([methodName, requirement]) => {
+    const costKey = `${requirement.quota} units`;
+    if (!summary[costKey]) {
+      summary[costKey] = [];
+    }
+    summary[costKey].push(methodName);
+  });
+
+  // Sort methods within each cost level
+  Object.keys(summary).forEach(costKey => {
+    summary[costKey]?.sort();
+  });
+  return summary;
+}, {
+  name: 'getQuotaUsageSummary'
+});
+
 /**
  * Get required permissions for a specific SDK method.
  * Returns array of permission strings needed to call the method.
+ * Memoized to cache permission lookups per method.
  */
-function getRequiredPermissions(methodName) {
-    const reqs = loadRequirements();
-    const requirement = reqs.api[methodName];
-    if (!requirement) {
-        throw new Error(`Unknown SDK method: "${methodName}"`);
-    }
-    return [...requirement.permissions];
-}
+const getRequiredPermissions = memoization.memoize(methodName => {
+  const reqs = loadRequirements();
+  const requirement = reqs.api[methodName];
+  if (!requirement) {
+    throw new Error(`Unknown SDK method: "${methodName}"`);
+  }
+  return [...requirement.permissions];
+}, {
+  name: 'getRequiredPermissions'
+});
+
 /**
  * Check if user has sufficient quota for method calls.
  * Returns true if available quota covers the total cost.
  */
 function hasQuotaForMethods(availableQuota, methodNames) {
-    const totalCost = calculateTotalQuotaCost(methodNames);
-    return availableQuota >= totalCost;
+  const totalCost = calculateTotalQuotaCost(methodNames);
+  return availableQuota >= totalCost;
 }
+
+exports.calculateTotalQuotaCost = calculateTotalQuotaCost;
+exports.getAllMethodRequirements = getAllMethodRequirements;
+exports.getMethodRequirements = getMethodRequirements;
+exports.getMethodsByPermissions = getMethodsByPermissions;
+exports.getMethodsByQuotaCost = getMethodsByQuotaCost;
+exports.getQuotaCost = getQuotaCost;
+exports.getQuotaUsageSummary = getQuotaUsageSummary;
+exports.getRequiredPermissions = getRequiredPermissions;
+exports.hasQuotaForMethods = hasQuotaForMethods;