@socketsecurity/lib 5.28.0 → 6.0.1

package/dist/url.d.ts

@@ -1,114 +0,0 @@
-/**
- * @fileoverview URL parsing and validation utilities.
- * Provides URL validation, normalization, and parsing helpers.
- */
-export interface CreateRelativeUrlOptions {
-    base?: string;
-}
-export interface UrlSearchParamAsBooleanOptions {
-    defaultValue?: boolean;
-}
-export interface UrlSearchParamAsNumberOptions {
-    defaultValue?: number;
-}
-export interface UrlSearchParamAsStringOptions {
-    defaultValue?: string;
-}
-export interface UrlSearchParamsGetBooleanOptions {
-    defaultValue?: boolean;
-}
-/**
- * Create a relative URL for testing.
- *
- * @example
- * ```typescript
- * createRelativeUrl('/api/test')                                    // 'api/test'
- * createRelativeUrl('/api/test', { base: 'https://example.com' })  // 'https://example.com/api/test'
- * ```
- */
-export declare function createRelativeUrl(path: string, options?: CreateRelativeUrlOptions | undefined): string;
-/**
- * Check if a value is a valid URL.
- *
- * @example
- * ```typescript
- * isUrl('https://example.com') // true
- * isUrl('not a url')           // false
- * isUrl(null)                  // false
- * ```
- */
-export declare function isUrl(value: string | URL | null | undefined): boolean;
-/**
- * Parse a value as a URL.
- *
- * @example
- * ```typescript
- * parseUrl('https://example.com')  // URL { href: 'https://example.com/' }
- * parseUrl('invalid')              // undefined
- * ```
- */
-export declare function parseUrl(value: string | URL): URL | undefined;
-/**
- * Convert a URL search parameter to an array.
- *
- * @example
- * ```typescript
- * urlSearchParamAsArray('a, b, c') // ['a', 'b', 'c']
- * urlSearchParamAsArray(null)      // []
- * ```
- */
-export declare function urlSearchParamAsArray(value: string | null | undefined): string[];
-/**
- * Convert a URL search parameter to a boolean.
- *
- * @example
- * ```typescript
- * urlSearchParamAsBoolean('true') // true
- * urlSearchParamAsBoolean('0')    // false
- * urlSearchParamAsBoolean(null)   // false
- * ```
- */
-export declare function urlSearchParamAsBoolean(value: string | null | undefined, options?: UrlSearchParamAsBooleanOptions | undefined): boolean;
-/**
- * Get number value from URLSearchParams with a default.
- *
- * @example
- * ```typescript
- * const params = new URLSearchParams('limit=10')
- * urlSearchParamAsNumber(params, 'limit') // 10
- * urlSearchParamAsNumber(params, 'other') // 0
- * ```
- */
-export declare function urlSearchParamAsNumber(params: URLSearchParams | null | undefined, key: string, options?: UrlSearchParamAsNumberOptions | undefined): number;
-/**
- * Get string value from URLSearchParams with a default.
- *
- * @example
- * ```typescript
- * const params = new URLSearchParams('name=socket')
- * urlSearchParamAsString(params, 'name')  // 'socket'
- * urlSearchParamAsString(params, 'other') // ''
- * ```
- */
-export declare function urlSearchParamAsString(params: URLSearchParams | null | undefined, key: string, options?: UrlSearchParamAsStringOptions | undefined): string;
-/**
- * Helper to get array from URLSearchParams.
- *
- * @example
- * ```typescript
- * const params = new URLSearchParams('tags=a,b,c')
- * urlSearchParamsGetArray(params, 'tags') // ['a', 'b', 'c']
- * ```
- */
-export declare function urlSearchParamsGetArray(params: URLSearchParams | null | undefined, key: string): string[];
-/**
- * Helper to get boolean from URLSearchParams.
- *
- * @example
- * ```typescript
- * const params = new URLSearchParams('debug=true')
- * urlSearchParamsGetBoolean(params, 'debug') // true
- * urlSearchParamsGetBoolean(params, 'other') // false
- * ```
- */
-export declare function urlSearchParamsGetBoolean(params: URLSearchParams | null | undefined, key: string, options?: UrlSearchParamsGetBooleanOptions | undefined): boolean;

package/dist/versions.d.ts

@@ -1,207 +0,0 @@
-/** @fileoverview Version comparison and validation utilities for Socket ecosystem. */
-/**
- * Coerce a version string to valid semver format.
- *
- * @example
- * ```typescript
- * coerceVersion('1.2')   // '1.2.0'
- * coerceVersion('v3')    // '3.0.0'
- * coerceVersion('abc')   // undefined
- * ```
- */
-export declare function coerceVersion(version: string): string | undefined;
-/**
- * Compare two semantic version strings.
- * @returns -1 if v1 < v2, 0 if v1 === v2, 1 if v1 > v2, or undefined if invalid.
- *
- * @example
- * ```typescript
- * compareVersions('1.0.0', '2.0.0') // -1
- * compareVersions('1.0.0', '1.0.0') // 0
- * compareVersions('2.0.0', '1.0.0') // 1
- * ```
- */
-export declare function compareVersions(v1: string, v2: string): -1 | 0 | 1 | undefined;
-/**
- * Get all versions from an array that satisfy a semver range.
- *
- * @example
- * ```typescript
- * filterVersions(['1.0.0', '1.5.0', '2.0.0'], '>=1.0.0 <2.0.0')
- * // ['1.0.0', '1.5.0']
- * ```
- */
-export declare function filterVersions(versions: string[], range: string): string[];
-/**
- * Get the major version number from a version string.
- *
- * @example
- * ```typescript
- * getMajorVersion('3.2.1') // 3
- * ```
- */
-export declare function getMajorVersion(version: string): number | undefined;
-/**
- * Get the minor version number from a version string.
- *
- * @example
- * ```typescript
- * getMinorVersion('3.2.1') // 2
- * ```
- */
-export declare function getMinorVersion(version: string): number | undefined;
-/**
- * Get the patch version number from a version string.
- *
- * @example
- * ```typescript
- * getPatchVersion('3.2.1') // 1
- * ```
- */
-export declare function getPatchVersion(version: string): number | undefined;
-/**
- * Increment a version by the specified release type.
- *
- * @example
- * ```typescript
- * incrementVersion('1.2.3', 'patch') // '1.2.4'
- * incrementVersion('1.2.3', 'minor') // '1.3.0'
- * incrementVersion('1.2.3', 'major') // '2.0.0'
- * ```
- */
-export declare function incrementVersion(version: string, release: 'major' | 'minor' | 'patch' | 'premajor' | 'preminor' | 'prepatch' | 'prerelease', identifier?: string | undefined): string | undefined;
-/**
- * Check if version1 equals version2.
- *
- * @example
- * ```typescript
- * isEqual('1.0.0', '1.0.0') // true
- * isEqual('1.0.0', '2.0.0') // false
- * ```
- */
-export declare function isEqual(version1: string, version2: string): boolean;
-/**
- * Check if version1 is greater than version2.
- *
- * @example
- * ```typescript
- * isGreaterThan('2.0.0', '1.0.0') // true
- * isGreaterThan('1.0.0', '2.0.0') // false
- * ```
- */
-export declare function isGreaterThan(version1: string, version2: string): boolean;
-/**
- * Check if version1 is greater than or equal to version2.
- *
- * @example
- * ```typescript
- * isGreaterThanOrEqual('2.0.0', '1.0.0') // true
- * isGreaterThanOrEqual('1.0.0', '1.0.0') // true
- * ```
- */
-export declare function isGreaterThanOrEqual(version1: string, version2: string): boolean;
-/**
- * Check if version1 is less than version2.
- *
- * @example
- * ```typescript
- * isLessThan('1.0.0', '2.0.0') // true
- * isLessThan('2.0.0', '1.0.0') // false
- * ```
- */
-export declare function isLessThan(version1: string, version2: string): boolean;
-/**
- * Check if version1 is less than or equal to version2.
- *
- * @example
- * ```typescript
- * isLessThanOrEqual('1.0.0', '2.0.0') // true
- * isLessThanOrEqual('1.0.0', '1.0.0') // true
- * ```
- */
-export declare function isLessThanOrEqual(version1: string, version2: string): boolean;
-/**
- * Validate if a string is a valid semantic version.
- *
- * @example
- * ```typescript
- * isValidVersion('1.2.3') // true
- * isValidVersion('abc')   // false
- * ```
- */
-export declare function isValidVersion(version: string): boolean;
-/**
- * Get the highest version from an array of versions.
- *
- * @example
- * ```typescript
- * maxVersion(['1.0.0', '2.0.0', '1.5.0']) // '2.0.0'
- * ```
- */
-export declare function maxVersion(versions: string[]): string | undefined;
-/**
- * Get the lowest version from an array of versions.
- *
- * @example
- * ```typescript
- * minVersion(['1.0.0', '2.0.0', '1.5.0']) // '1.0.0'
- * ```
- */
-export declare function minVersion(versions: string[]): string | undefined;
-/**
- * Parse a version string and return major, minor, patch components.
- *
- * @example
- * ```typescript
- * parseVersion('1.2.3')
- * // { major: 1, minor: 2, patch: 3, prerelease: [], build: [] }
- * ```
- */
-export declare function parseVersion(version: string): {
-    major: number;
-    minor: number;
-    patch: number;
-    prerelease: ReadonlyArray<string | number>;
-    build: readonly string[];
-} | undefined;
-/**
- * Check if a version satisfies a semver range.
- *
- * @example
- * ```typescript
- * satisfiesVersion('1.5.0', '>=1.0.0 <2.0.0') // true
- * satisfiesVersion('3.0.0', '>=1.0.0 <2.0.0') // false
- * ```
- */
-export declare function satisfiesVersion(version: string, range: string): boolean;
-/**
- * Sort versions in ascending order.
- *
- * @example
- * ```typescript
- * sortVersions(['2.0.0', '1.0.0', '1.5.0'])
- * // ['1.0.0', '1.5.0', '2.0.0']
- * ```
- */
-export declare function sortVersions(versions: string[]): string[];
-/**
- * Sort versions in descending order.
- *
- * @example
- * ```typescript
- * sortVersionsDesc(['1.0.0', '2.0.0', '1.5.0'])
- * // ['2.0.0', '1.5.0', '1.0.0']
- * ```
- */
-export declare function sortVersionsDesc(versions: string[]): string[];
-/**
- * Get the difference between two versions.
- *
- * @example
- * ```typescript
- * versionDiff('1.0.0', '2.0.0') // 'major'
- * versionDiff('1.0.0', '1.1.0') // 'minor'
- * versionDiff('1.0.0', '1.0.1') // 'patch'
- * ```
- */
-export declare function versionDiff(version1: string, version2: string): 'major' | 'premajor' | 'minor' | 'preminor' | 'patch' | 'prepatch' | 'prerelease' | 'release' | undefined;

package/dist/versions.js

@@ -1,181 +0,0 @@
-"use strict";
-/* Socket Lib - Built with esbuild */
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var versions_exports = {};
-__export(versions_exports, {
-  coerceVersion: () => coerceVersion,
-  compareVersions: () => compareVersions,
-  filterVersions: () => filterVersions,
-  getMajorVersion: () => getMajorVersion,
-  getMinorVersion: () => getMinorVersion,
-  getPatchVersion: () => getPatchVersion,
-  incrementVersion: () => incrementVersion,
-  isEqual: () => isEqual,
-  isGreaterThan: () => isGreaterThan,
-  isGreaterThanOrEqual: () => isGreaterThanOrEqual,
-  isLessThan: () => isLessThan,
-  isLessThanOrEqual: () => isLessThanOrEqual,
-  isValidVersion: () => isValidVersion,
-  maxVersion: () => maxVersion,
-  minVersion: () => minVersion,
-  parseVersion: () => parseVersion,
-  satisfiesVersion: () => satisfiesVersion,
-  sortVersions: () => sortVersions,
-  sortVersionsDesc: () => sortVersionsDesc,
-  versionDiff: () => versionDiff
-});
-module.exports = __toCommonJS(versions_exports);
-var import_versions = require("./smol/versions");
-const _smolVersions = (0, import_versions.getSmolVersions)();
-let _semver;
-function getSemver() {
-  if (_semver === void 0) {
-    _semver = require("./external/semver");
-  }
-  return _semver;
-}
-function getVersionsImpl() {
-  return _smolVersions ?? getSemver();
-}
-function coerceVersion(version) {
-  const semver = getSemver();
-  const coerced = semver.coerce(version);
-  return coerced?.version;
-}
-function compareVersions(v1, v2) {
-  try {
-    const impl = getVersionsImpl();
-    return impl.compare(v1, v2);
-  } catch {
-    return void 0;
-  }
-}
-function filterVersions(versions, range) {
-  const impl = getVersionsImpl();
-  return versions.filter((v) => impl.satisfies(v, range));
-}
-function getMajorVersion(version) {
-  const semver = getSemver();
-  const parsed = semver.parse(version);
-  return parsed?.major;
-}
-function getMinorVersion(version) {
-  const semver = getSemver();
-  const parsed = semver.parse(version);
-  return parsed?.minor;
-}
-function getPatchVersion(version) {
-  const semver = getSemver();
-  const parsed = semver.parse(version);
-  return parsed?.patch;
-}
-function incrementVersion(version, release, identifier) {
-  const semver = getSemver();
-  return semver.inc(version, release, identifier) || void 0;
-}
-function isEqual(version1, version2) {
-  const impl = getVersionsImpl();
-  return impl.eq(version1, version2);
-}
-function isGreaterThan(version1, version2) {
-  const impl = getVersionsImpl();
-  return impl.gt(version1, version2);
-}
-function isGreaterThanOrEqual(version1, version2) {
-  const impl = getVersionsImpl();
-  return impl.gte(version1, version2);
-}
-function isLessThan(version1, version2) {
-  const impl = getVersionsImpl();
-  return impl.lt(version1, version2);
-}
-function isLessThanOrEqual(version1, version2) {
-  const impl = getVersionsImpl();
-  return impl.lte(version1, version2);
-}
-function isValidVersion(version) {
-  const impl = getVersionsImpl();
-  return impl.valid(version) != null;
-}
-function maxVersion(versions) {
-  const semver = getSemver();
-  return semver.maxSatisfying(versions, "*", { includePrerelease: true }) || void 0;
-}
-function minVersion(versions) {
-  const semver = getSemver();
-  return semver.minSatisfying(versions, "*", { includePrerelease: true }) || void 0;
-}
-function parseVersion(version) {
-  const semver = getSemver();
-  const parsed = semver.parse(version);
-  if (!parsed) {
-    return void 0;
-  }
-  return {
-    major: parsed.major,
-    minor: parsed.minor,
-    patch: parsed.patch,
-    prerelease: parsed.prerelease,
-    build: parsed.build
-  };
-}
-function satisfiesVersion(version, range) {
-  const impl = getVersionsImpl();
-  return impl.satisfies(version, range);
-}
-function sortVersions(versions) {
-  const impl = getVersionsImpl();
-  return impl.sort([...versions]);
-}
-function sortVersionsDesc(versions) {
-  const impl = getVersionsImpl();
-  return impl.rsort([...versions]);
-}
-function versionDiff(version1, version2) {
-  try {
-    const semver = getSemver();
-    return semver.diff(version1, version2) || void 0;
-  } catch {
-    return void 0;
-  }
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  coerceVersion,
-  compareVersions,
-  filterVersions,
-  getMajorVersion,
-  getMinorVersion,
-  getPatchVersion,
-  incrementVersion,
-  isEqual,
-  isGreaterThan,
-  isGreaterThanOrEqual,
-  isLessThan,
-  isLessThanOrEqual,
-  isValidVersion,
-  maxVersion,
-  minVersion,
-  parseVersion,
-  satisfiesVersion,
-  sortVersions,
-  sortVersionsDesc,
-  versionDiff
-});

package/dist/words.d.ts

@@ -1,39 +0,0 @@
-/**
- * @fileoverview Word manipulation utilities for capitalization and formatting.
- * Provides text transformation functions for consistent word processing.
- */
-export interface PluralizeOptions {
-    count?: number;
-}
-/**
- * Capitalize the first letter of a word.
- *
- * @example
- * ```typescript
- * capitalize('hello')  // 'Hello'
- * capitalize('WORLD')  // 'World'
- * capitalize('')       // ''
- * ```
- */
-export declare function capitalize(word: string): string;
-/**
- * Determine the appropriate article (a/an) for a word.
- *
- * @example
- * ```typescript
- * determineArticle('apple')   // 'an'
- * determineArticle('banana')  // 'a'
- * ```
- */
-export declare function determineArticle(word: string): string;
-/**
- * Pluralize a word based on count.
- *
- * @example
- * ```typescript
- * pluralize('file')               // 'file'
- * pluralize('file', { count: 3 }) // 'files'
- * pluralize('file', { count: 0 }) // 'files'
- * ```
- */
-export declare function pluralize(word: string, options?: PluralizeOptions | undefined): string;