@socketsecurity/lib 0.0.0 → 1.0.0

package/dist/url.js

@@ -0,0 +1,144 @@
+/* Socket Lib - Built with esbuild */
+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 url_exports = {};
+__export(url_exports, {
+  createRelativeUrl: () => createRelativeUrl,
+  isUrl: () => isUrl,
+  parseUrl: () => parseUrl,
+  urlSearchParamAsArray: () => urlSearchParamAsArray,
+  urlSearchParamAsBoolean: () => urlSearchParamAsBoolean,
+  urlSearchParamAsNumber: () => urlSearchParamAsNumber,
+  urlSearchParamAsString: () => urlSearchParamAsString,
+  urlSearchParamsGetArray: () => urlSearchParamsGetArray,
+  urlSearchParamsGetBoolean: () => urlSearchParamsGetBoolean
+});
+module.exports = __toCommonJS(url_exports);
+const BooleanCtor = Boolean;
+const UrlCtor = URL;
+// @__NO_SIDE_EFFECTS__
+function isUrl(value) {
+  return (typeof value === "string" && value !== "" || value !== null && typeof value === "object") && !!/* @__PURE__ */ parseUrl(value);
+}
+// @__NO_SIDE_EFFECTS__
+function parseUrl(value) {
+  try {
+    return new UrlCtor(value);
+  } catch {
+  }
+  return void 0;
+}
+// @__NO_SIDE_EFFECTS__
+function urlSearchParamAsArray(value) {
+  return typeof value === "string" ? value.trim().split(/, */).map((v) => v.trim()).filter(BooleanCtor) : [];
+}
+// @__NO_SIDE_EFFECTS__
+function urlSearchParamAsBoolean(value, options) {
+  const { defaultValue = false } = {
+    __proto__: null,
+    ...options
+  };
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    return trimmed === "1" || trimmed.toLowerCase() === "true";
+  }
+  if (value === null || value === void 0) {
+    return !!defaultValue;
+  }
+  return !!value;
+}
+// @__NO_SIDE_EFFECTS__
+function urlSearchParamsGetArray(params, key) {
+  if (params && typeof params.getAll === "function") {
+    const values = params.getAll(key);
+    const firstValue = values[0];
+    if (values.length === 1 && firstValue && firstValue.includes(",")) {
+      return /* @__PURE__ */ urlSearchParamAsArray(firstValue);
+    }
+    return values;
+  }
+  return [];
+}
+// @__NO_SIDE_EFFECTS__
+function urlSearchParamsGetBoolean(params, key, options) {
+  const { defaultValue = false } = {
+    __proto__: null,
+    ...options
+  };
+  if (params && typeof params.get === "function") {
+    const value = params.get(key);
+    return value !== null ? /* @__PURE__ */ urlSearchParamAsBoolean(value, { defaultValue }) : defaultValue;
+  }
+  return defaultValue;
+}
+// @__NO_SIDE_EFFECTS__
+function createRelativeUrl(path, options) {
+  const { base = "" } = {
+    __proto__: null,
+    ...options
+  };
+  const relativePath = path.replace(/^\//, "");
+  if (base) {
+    let baseUrl = base;
+    if (!baseUrl.endsWith("/")) {
+      baseUrl += "/";
+    }
+    return baseUrl + relativePath;
+  }
+  return relativePath;
+}
+// @__NO_SIDE_EFFECTS__
+function urlSearchParamAsString(params, key, options) {
+  const { defaultValue = "" } = {
+    __proto__: null,
+    ...options
+  };
+  if (params && typeof params.get === "function") {
+    const value = params.get(key);
+    return value !== null ? value : defaultValue;
+  }
+  return defaultValue;
+}
+// @__NO_SIDE_EFFECTS__
+function urlSearchParamAsNumber(params, key, options) {
+  const { defaultValue = 0 } = {
+    __proto__: null,
+    ...options
+  };
+  if (params && typeof params.get === "function") {
+    const value = params.get(key);
+    if (value !== null) {
+      const num = Number(value);
+      return !Number.isNaN(num) ? num : defaultValue;
+    }
+  }
+  return defaultValue;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createRelativeUrl,
+  isUrl,
+  parseUrl,
+  urlSearchParamAsArray,
+  urlSearchParamAsBoolean,
+  urlSearchParamAsNumber,
+  urlSearchParamAsString,
+  urlSearchParamsGetArray,
+  urlSearchParamsGetBoolean
+});
+//# sourceMappingURL=url.js.map

package/dist/url.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/url.ts"],
+  "sourcesContent": ["/**\n * @fileoverview URL parsing and validation utilities.\n * Provides URL validation, normalization, and parsing helpers.\n */\n\nconst BooleanCtor = Boolean\nconst UrlCtor = URL\n\n/**\n * Check if a value is a valid URL.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function isUrl(value: string | URL | null | undefined): boolean {\n  return (\n    ((typeof value === 'string' && value !== '') ||\n      (value !== null && typeof value === 'object')) &&\n    !!parseUrl(value)\n  )\n}\n\n/**\n * Parse a value as a URL.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function parseUrl(value: string | URL): URL | undefined {\n  try {\n    return new UrlCtor(value)\n  } catch {}\n  return undefined\n}\n\n/**\n * Convert a URL search parameter to an array.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function urlSearchParamAsArray(\n  value: string | null | undefined,\n): string[] {\n  return typeof value === 'string'\n    ? value\n        .trim()\n        .split(/, */)\n        .map(v => v.trim())\n        .filter(BooleanCtor)\n    : []\n}\n\nexport interface UrlSearchParamAsBooleanOptions {\n  defaultValue?: boolean\n}\n\n/**\n * Convert a URL search parameter to a boolean.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function urlSearchParamAsBoolean(\n  value: string | null | undefined,\n  options?: UrlSearchParamAsBooleanOptions | undefined,\n): boolean {\n  const { defaultValue = false } = {\n    __proto__: null,\n    ...options,\n  } as UrlSearchParamAsBooleanOptions\n  if (typeof value === 'string') {\n    const trimmed = value.trim()\n    return trimmed === '1' || trimmed.toLowerCase() === 'true'\n  }\n  if (value === null || value === undefined) {\n    return !!defaultValue\n  }\n  return !!value\n}\n\n/**\n * Helper to get array from URLSearchParams.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function urlSearchParamsGetArray(\n  params: URLSearchParams | null | undefined,\n  key: string,\n): string[] {\n  if (params && typeof params.getAll === 'function') {\n    const values = params.getAll(key)\n    // If single value contains commas, split it\n    const firstValue = values[0]\n    if (values.length === 1 && firstValue && firstValue.includes(',')) {\n      return urlSearchParamAsArray(firstValue)\n    }\n    return values\n  }\n  return []\n}\n\nexport interface UrlSearchParamsGetBooleanOptions {\n  defaultValue?: boolean\n}\n\n/**\n * Helper to get boolean from URLSearchParams.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function urlSearchParamsGetBoolean(\n  params: URLSearchParams | null | undefined,\n  key: string,\n  options?: UrlSearchParamsGetBooleanOptions | undefined,\n): boolean {\n  const { defaultValue = false } = {\n    __proto__: null,\n    ...options,\n  } as UrlSearchParamsGetBooleanOptions\n  if (params && typeof params.get === 'function') {\n    const value = params.get(key)\n    return value !== null\n      ? urlSearchParamAsBoolean(value, { defaultValue })\n      : defaultValue\n  }\n  return defaultValue\n}\n\nexport interface CreateRelativeUrlOptions {\n  base?: string\n}\n\n/**\n * Create a relative URL for testing.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function createRelativeUrl(\n  path: string,\n  options?: CreateRelativeUrlOptions | undefined,\n): string {\n  const { base = '' } = {\n    __proto__: null,\n    ...options,\n  } as CreateRelativeUrlOptions\n  // Remove leading slash to make it relative.\n  const relativePath = path.replace(/^\\//, '')\n\n  if (base) {\n    let baseUrl = base\n    if (!baseUrl.endsWith('/')) {\n      baseUrl += '/'\n    }\n    return baseUrl + relativePath\n  }\n\n  return relativePath\n}\n\nexport interface UrlSearchParamAsStringOptions {\n  defaultValue?: string\n}\n\n/**\n * Get string value from URLSearchParams with a default.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function urlSearchParamAsString(\n  params: URLSearchParams | null | undefined,\n  key: string,\n  options?: UrlSearchParamAsStringOptions | undefined,\n): string {\n  const { defaultValue = '' } = {\n    __proto__: null,\n    ...options,\n  } as UrlSearchParamAsStringOptions\n  if (params && typeof params.get === 'function') {\n    const value = params.get(key)\n    return value !== null ? value : defaultValue\n  }\n  return defaultValue\n}\n\nexport interface UrlSearchParamAsNumberOptions {\n  defaultValue?: number\n}\n\n/**\n * Get number value from URLSearchParams with a default.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function urlSearchParamAsNumber(\n  params: URLSearchParams | null | undefined,\n  key: string,\n  options?: UrlSearchParamAsNumberOptions | undefined,\n): number {\n  const { defaultValue = 0 } = {\n    __proto__: null,\n    ...options,\n  } as UrlSearchParamAsNumberOptions\n  if (params && typeof params.get === 'function') {\n    const value = params.get(key)\n    if (value !== null) {\n      const num = Number(value)\n      return !Number.isNaN(num) ? num : defaultValue\n    }\n  }\n  return defaultValue\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/utils/get-ipc.d.ts

@@ -0,0 +1,16 @@
+/**
+ * IPC (Inter-Process Communication) object getter.
+ * Handles communication between parent and child processes.
+ */
+export interface IpcObject {
+    SOCKET_CLI_FIX?: string | undefined;
+    SOCKET_CLI_OPTIMIZE?: boolean | undefined;
+    SOCKET_CLI_SHADOW_ACCEPT_RISKS?: boolean | undefined;
+    SOCKET_CLI_SHADOW_API_TOKEN?: string | undefined;
+    SOCKET_CLI_SHADOW_BIN?: string | undefined;
+    SOCKET_CLI_SHADOW_PROGRESS?: boolean | undefined;
+    SOCKET_CLI_SHADOW_SILENT?: boolean | undefined;
+}
+export declare function getIpc(): Promise<IpcObject>;
+export declare function getIpc<K extends keyof IpcObject>(key: K): Promise<IpcObject[K]>;
+export default getIpc;

package/dist/utils/get-ipc.js

@@ -0,0 +1,60 @@
+/* Socket Lib - Built with esbuild */
+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 get_ipc_exports = {};
+__export(get_ipc_exports, {
+  default: () => get_ipc_default,
+  getIpc: () => getIpc
+});
+module.exports = __toCommonJS(get_ipc_exports);
+let _ipcObject;
+async function getIpc(key) {
+  if (_ipcObject === void 0) {
+    _ipcObject = {};
+    const { env } = process;
+    if (env["SOCKET_CLI_FIX"]) {
+      _ipcObject.SOCKET_CLI_FIX = env["SOCKET_CLI_FIX"];
+    }
+    if (env["SOCKET_CLI_OPTIMIZE"]) {
+      _ipcObject.SOCKET_CLI_OPTIMIZE = env["SOCKET_CLI_OPTIMIZE"] === "true" || env["SOCKET_CLI_OPTIMIZE"] === "1";
+    }
+    if (env["SOCKET_CLI_SHADOW_ACCEPT_RISKS"]) {
+      _ipcObject.SOCKET_CLI_SHADOW_ACCEPT_RISKS = env["SOCKET_CLI_SHADOW_ACCEPT_RISKS"] === "true" || env["SOCKET_CLI_SHADOW_ACCEPT_RISKS"] === "1";
+    }
+    if (env["SOCKET_CLI_SHADOW_API_TOKEN"]) {
+      _ipcObject.SOCKET_CLI_SHADOW_API_TOKEN = env["SOCKET_CLI_SHADOW_API_TOKEN"];
+    }
+    if (env["SOCKET_CLI_SHADOW_BIN"]) {
+      _ipcObject.SOCKET_CLI_SHADOW_BIN = env["SOCKET_CLI_SHADOW_BIN"];
+    }
+    if (env["SOCKET_CLI_SHADOW_PROGRESS"]) {
+      _ipcObject.SOCKET_CLI_SHADOW_PROGRESS = env["SOCKET_CLI_SHADOW_PROGRESS"] === "true" || env["SOCKET_CLI_SHADOW_PROGRESS"] === "1";
+    }
+    if (env["SOCKET_CLI_SHADOW_SILENT"]) {
+      _ipcObject.SOCKET_CLI_SHADOW_SILENT = env["SOCKET_CLI_SHADOW_SILENT"] === "true" || env["SOCKET_CLI_SHADOW_SILENT"] === "1";
+    }
+    Object.freeze(_ipcObject);
+  }
+  return key ? _ipcObject[key] : _ipcObject;
+}
+var get_ipc_default = getIpc;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getIpc
+});
+//# sourceMappingURL=get-ipc.js.map

package/dist/utils/get-ipc.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/get-ipc.ts"],
+  "sourcesContent": ["/**\n * IPC (Inter-Process Communication) object getter.\n * Handles communication between parent and child processes.\n */\n\nexport interface IpcObject {\n  SOCKET_CLI_FIX?: string | undefined\n  SOCKET_CLI_OPTIMIZE?: boolean | undefined\n  SOCKET_CLI_SHADOW_ACCEPT_RISKS?: boolean | undefined\n  SOCKET_CLI_SHADOW_API_TOKEN?: string | undefined\n  SOCKET_CLI_SHADOW_BIN?: string | undefined\n  SOCKET_CLI_SHADOW_PROGRESS?: boolean | undefined\n  SOCKET_CLI_SHADOW_SILENT?: boolean | undefined\n}\n\nlet _ipcObject: IpcObject | undefined\n\nexport async function getIpc(): Promise<IpcObject>\nexport async function getIpc<K extends keyof IpcObject>(\n  key: K,\n): Promise<IpcObject[K]>\nexport async function getIpc(\n  key?: keyof IpcObject,\n): Promise<IpcObject | IpcObject[keyof IpcObject]> {\n  if (_ipcObject === undefined) {\n    _ipcObject = {}\n\n    // Check for IPC environment variables.\n    const { env } = process\n\n    if (env['SOCKET_CLI_FIX']) {\n      _ipcObject.SOCKET_CLI_FIX = env['SOCKET_CLI_FIX']\n    }\n\n    if (env['SOCKET_CLI_OPTIMIZE']) {\n      _ipcObject.SOCKET_CLI_OPTIMIZE =\n        env['SOCKET_CLI_OPTIMIZE'] === 'true' ||\n        env['SOCKET_CLI_OPTIMIZE'] === '1'\n    }\n\n    if (env['SOCKET_CLI_SHADOW_ACCEPT_RISKS']) {\n      _ipcObject.SOCKET_CLI_SHADOW_ACCEPT_RISKS =\n        env['SOCKET_CLI_SHADOW_ACCEPT_RISKS'] === 'true' ||\n        env['SOCKET_CLI_SHADOW_ACCEPT_RISKS'] === '1'\n    }\n\n    if (env['SOCKET_CLI_SHADOW_API_TOKEN']) {\n      _ipcObject.SOCKET_CLI_SHADOW_API_TOKEN =\n        env['SOCKET_CLI_SHADOW_API_TOKEN']\n    }\n\n    if (env['SOCKET_CLI_SHADOW_BIN']) {\n      _ipcObject.SOCKET_CLI_SHADOW_BIN = env['SOCKET_CLI_SHADOW_BIN']\n    }\n\n    if (env['SOCKET_CLI_SHADOW_PROGRESS']) {\n      _ipcObject.SOCKET_CLI_SHADOW_PROGRESS =\n        env['SOCKET_CLI_SHADOW_PROGRESS'] === 'true' ||\n        env['SOCKET_CLI_SHADOW_PROGRESS'] === '1'\n    }\n\n    if (env['SOCKET_CLI_SHADOW_SILENT']) {\n      _ipcObject.SOCKET_CLI_SHADOW_SILENT =\n        env['SOCKET_CLI_SHADOW_SILENT'] === 'true' ||\n        env['SOCKET_CLI_SHADOW_SILENT'] === '1'\n    }\n\n    Object.freeze(_ipcObject)\n  }\n\n  return key ? _ipcObject[key] : _ipcObject\n}\n\nexport default getIpc\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAeA,IAAI;AAMJ,eAAsB,OACpB,KACiD;AACjD,MAAI,eAAe,QAAW;AAC5B,iBAAa,CAAC;AAGd,UAAM,EAAE,IAAI,IAAI;AAEhB,QAAI,IAAI,gBAAgB,GAAG;AACzB,iBAAW,iBAAiB,IAAI,gBAAgB;AAAA,IAClD;AAEA,QAAI,IAAI,qBAAqB,GAAG;AAC9B,iBAAW,sBACT,IAAI,qBAAqB,MAAM,UAC/B,IAAI,qBAAqB,MAAM;AAAA,IACnC;AAEA,QAAI,IAAI,gCAAgC,GAAG;AACzC,iBAAW,iCACT,IAAI,gCAAgC,MAAM,UAC1C,IAAI,gCAAgC,MAAM;AAAA,IAC9C;AAEA,QAAI,IAAI,6BAA6B,GAAG;AACtC,iBAAW,8BACT,IAAI,6BAA6B;AAAA,IACrC;AAEA,QAAI,IAAI,uBAAuB,GAAG;AAChC,iBAAW,wBAAwB,IAAI,uBAAuB;AAAA,IAChE;AAEA,QAAI,IAAI,4BAA4B,GAAG;AACrC,iBAAW,6BACT,IAAI,4BAA4B,MAAM,UACtC,IAAI,4BAA4B,MAAM;AAAA,IAC1C;AAEA,QAAI,IAAI,0BAA0B,GAAG;AACnC,iBAAW,2BACT,IAAI,0BAA0B,MAAM,UACpC,IAAI,0BAA0B,MAAM;AAAA,IACxC;AAEA,WAAO,OAAO,UAAU;AAAA,EAC1B;AAEA,SAAO,MAAM,WAAW,GAAG,IAAI;AACjC;AAEA,IAAO,kBAAQ;",
+  "names": []
+}

package/dist/validation/json-parser.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Safe JSON parsing with validation.
+ */
+import type { JsonParseOptions, JsonParseResult, Schema } from './types';
+export declare function safeJsonParse<T = unknown>(jsonString: string, schema?: Schema<T>, options?: JsonParseOptions): T;
+export declare function tryJsonParse<T = unknown>(jsonString: string, schema?: Schema<T>, options?: JsonParseOptions): T | undefined;
+export declare function parseJsonWithResult<T = unknown>(jsonString: string, schema?: Schema<T>, options?: JsonParseOptions): JsonParseResult<T>;
+export declare function createJsonParser<T = unknown>(schema?: Schema<T>, defaultOptions?: JsonParseOptions): (jsonString: string, options?: JsonParseOptions) => T;
+export declare function parseNdjson<T = unknown>(ndjson: string, schema?: Schema<T>, options?: JsonParseOptions): T[];
+export declare function streamNdjson<T = unknown>(ndjson: string, schema?: Schema<T>, options?: JsonParseOptions): Generator<T, void, unknown>;

package/dist/validation/json-parser.js

@@ -0,0 +1,129 @@
+/* Socket Lib - Built with esbuild */
+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 json_parser_exports = {};
+__export(json_parser_exports, {
+  createJsonParser: () => createJsonParser,
+  parseJsonWithResult: () => parseJsonWithResult,
+  parseNdjson: () => parseNdjson,
+  safeJsonParse: () => safeJsonParse,
+  streamNdjson: () => streamNdjson,
+  tryJsonParse: () => tryJsonParse
+});
+module.exports = __toCommonJS(json_parser_exports);
+const { hasOwn: ObjectHasOwn } = Object;
+function safeJsonParse(jsonString, schema, options = {}) {
+  const { allowPrototype = false, maxSize = 10 * 1024 * 1024 } = options;
+  const byteLength = Buffer.byteLength(jsonString, "utf8");
+  if (byteLength > maxSize) {
+    throw new Error(
+      `JSON string exceeds maximum size limit${maxSize !== 10 * 1024 * 1024 ? ` of ${maxSize} bytes` : ""}`
+    );
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(jsonString);
+  } catch (error) {
+    throw new Error(`Failed to parse JSON: ${error}`);
+  }
+  if (!allowPrototype && typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) {
+    const dangerous = ["__proto__", "constructor", "prototype"];
+    for (const key of dangerous) {
+      if (ObjectHasOwn(parsed, key)) {
+        throw new Error(
+          "JSON contains potentially malicious prototype pollution keys"
+        );
+      }
+    }
+  }
+  if (schema) {
+    const result = schema.safeParse(parsed);
+    if (!result.success) {
+      const errors = result.error.issues.map(
+        (issue) => `${issue.path.join(".")}: ${issue.message}`
+      ).join(", ");
+      throw new Error(`Validation failed: ${errors}`);
+    }
+    return result.data;
+  }
+  return parsed;
+}
+function tryJsonParse(jsonString, schema, options) {
+  try {
+    return safeJsonParse(jsonString, schema, options);
+  } catch {
+    return void 0;
+  }
+}
+function parseJsonWithResult(jsonString, schema, options) {
+  try {
+    const data = safeJsonParse(jsonString, schema, options);
+    return { success: true, data };
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unknown error";
+    return { success: false, error: message };
+  }
+}
+function createJsonParser(schema, defaultOptions) {
+  return (jsonString, options) => {
+    return safeJsonParse(jsonString, schema, { ...defaultOptions, ...options });
+  };
+}
+function parseNdjson(ndjson, schema, options) {
+  const results = [];
+  const lines = ndjson.split(/\r?\n/);
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i]?.trim();
+    if (!line || line === "") {
+      continue;
+    }
+    try {
+      const parsed = safeJsonParse(line, schema, options);
+      results.push(parsed);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      throw new Error(`Failed to parse NDJSON at line ${i + 1}: ${message}`);
+    }
+  }
+  return results;
+}
+function* streamNdjson(ndjson, schema, options) {
+  const lines = ndjson.split(/\r?\n/);
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i]?.trim();
+    if (!line || line === "") {
+      continue;
+    }
+    try {
+      yield safeJsonParse(line, schema, options);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      throw new Error(`Failed to parse NDJSON at line ${i + 1}: ${message}`);
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createJsonParser,
+  parseJsonWithResult,
+  parseNdjson,
+  safeJsonParse,
+  streamNdjson,
+  tryJsonParse
+});
+//# sourceMappingURL=json-parser.js.map

package/dist/validation/json-parser.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/validation/json-parser.ts"],
+  "sourcesContent": ["/**\n * @fileoverview Safe JSON parsing with validation.\n */\n\nimport type { JsonParseOptions, JsonParseResult, Schema } from './types'\n\nconst { hasOwn: ObjectHasOwn } = Object\n\nexport function safeJsonParse<T = unknown>(\n  jsonString: string,\n  schema?: Schema<T>,\n  options: JsonParseOptions = {},\n): T {\n  const { allowPrototype = false, maxSize = 10 * 1024 * 1024 } = options\n\n  // Check size limit\n  const byteLength = Buffer.byteLength(jsonString, 'utf8')\n  if (byteLength > maxSize) {\n    throw new Error(\n      `JSON string exceeds maximum size limit${maxSize !== 10 * 1024 * 1024 ? ` of ${maxSize} bytes` : ''}`,\n    )\n  }\n\n  // Parse JSON\n  let parsed: unknown\n  try {\n    parsed = JSON.parse(jsonString)\n  } catch (error) {\n    throw new Error(`Failed to parse JSON: ${error}`)\n  }\n\n  // Check for prototype pollution\n  if (\n    !allowPrototype &&\n    typeof parsed === 'object' &&\n    parsed !== null &&\n    !Array.isArray(parsed)\n  ) {\n    const dangerous = ['__proto__', 'constructor', 'prototype']\n    for (const key of dangerous) {\n      if (ObjectHasOwn(parsed, key)) {\n        throw new Error(\n          'JSON contains potentially malicious prototype pollution keys',\n        )\n      }\n    }\n  }\n\n  // Validate against schema if provided\n  if (schema) {\n    const result = schema.safeParse(parsed)\n    if (!result.success) {\n      const errors = result.error.issues\n        .map(\n          (issue: { path: Array<string | number>; message: string }) =>\n            `${issue.path.join('.')}: ${issue.message}`,\n        )\n        .join(', ')\n      throw new Error(`Validation failed: ${errors}`)\n    }\n    return result.data as T\n  }\n\n  return parsed as T\n}\n\nexport function tryJsonParse<T = unknown>(\n  jsonString: string,\n  schema?: Schema<T>,\n  options?: JsonParseOptions,\n): T | undefined {\n  try {\n    return safeJsonParse(jsonString, schema, options)\n  } catch {\n    return undefined\n  }\n}\n\nexport function parseJsonWithResult<T = unknown>(\n  jsonString: string,\n  schema?: Schema<T>,\n  options?: JsonParseOptions,\n): JsonParseResult<T> {\n  try {\n    const data = safeJsonParse(jsonString, schema, options)\n    return { success: true, data }\n  } catch (error: unknown) {\n    const message = error instanceof Error ? error.message : 'Unknown error'\n    return { success: false, error: message }\n  }\n}\n\nexport function createJsonParser<T = unknown>(\n  schema?: Schema<T>,\n  defaultOptions?: JsonParseOptions,\n) {\n  return (jsonString: string, options?: JsonParseOptions): T => {\n    return safeJsonParse(jsonString, schema, { ...defaultOptions, ...options })\n  }\n}\n\nexport function parseNdjson<T = unknown>(\n  ndjson: string,\n  schema?: Schema<T>,\n  options?: JsonParseOptions,\n): T[] {\n  const results: T[] = []\n  const lines = ndjson.split(/\\r?\\n/)\n\n  for (let i = 0; i < lines.length; i++) {\n    const line = lines[i]?.trim()\n    if (!line || line === '') {\n      continue\n    }\n\n    try {\n      const parsed = safeJsonParse<T>(line, schema, options)\n      results.push(parsed)\n    } catch (error: unknown) {\n      const message = error instanceof Error ? error.message : String(error)\n      throw new Error(`Failed to parse NDJSON at line ${i + 1}: ${message}`)\n    }\n  }\n\n  return results\n}\n\nexport function* streamNdjson<T = unknown>(\n  ndjson: string,\n  schema?: Schema<T>,\n  options?: JsonParseOptions,\n): Generator<T, void, unknown> {\n  const lines = ndjson.split(/\\r?\\n/)\n\n  for (let i = 0; i < lines.length; i++) {\n    const line = lines[i]?.trim()\n    if (!line || line === '') {\n      continue\n    }\n\n    try {\n      yield safeJsonParse<T>(line, schema, options)\n    } catch (error: unknown) {\n      const message = error instanceof Error ? error.message : String(error)\n      throw new Error(`Failed to parse NDJSON at line ${i + 1}: ${message}`)\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/validation/types.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @fileoverview Validation type definitions.
+ */
+/**
+ * Schema parse result.
+ */
+export interface ParseResult<T> {
+    success: boolean;
+    data?: T;
+    // biome-ignore lint/suspicious/noExplicitAny: Error can be any schema validation error.
+    error?: any;
+}
+/**
+ * Base schema interface.
+ */
+// biome-ignore lint/suspicious/noExplicitAny: Schema interface accepts any input data for validation.
+export interface Schema<T = any> {
+    // biome-ignore lint/suspicious/noExplicitAny: Validation accepts any input data.
+    safeParse(data: any): ParseResult<T>;
+    // biome-ignore lint/suspicious/noExplicitAny: Validation accepts any input data.
+    parse(data: any): T;
+    _name?: string;
+}
+/**
+ * JSON parse options.
+ */
+export interface JsonParseOptions {
+    maxSize?: number;
+    allowPrototype?: boolean;
+}
+/**
+ * JSON parse result.
+ */
+export type JsonParseResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: string;
+};

package/dist/validation/types.js

@@ -0,0 +1,17 @@
+/* Socket Lib - Built with esbuild */
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 types_exports = {};
+module.exports = __toCommonJS(types_exports);
+//# sourceMappingURL=types.js.map

package/dist/validation/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/validation/types.ts"],
+  "sourcesContent": ["/**\n * @fileoverview Validation type definitions.\n */\n\n/**\n * Schema parse result.\n */\nexport interface ParseResult<T> {\n  success: boolean\n  data?: T\n  // biome-ignore lint/suspicious/noExplicitAny: Error can be any schema validation error.\n  error?: any\n}\n\n/**\n * Base schema interface.\n */\n// biome-ignore lint/suspicious/noExplicitAny: Schema interface accepts any input data for validation.\nexport interface Schema<T = any> {\n  // biome-ignore lint/suspicious/noExplicitAny: Validation accepts any input data.\n  safeParse(data: any): ParseResult<T>\n  // biome-ignore lint/suspicious/noExplicitAny: Validation accepts any input data.\n  parse(data: any): T\n  _name?: string\n}\n\n/**\n * JSON parse options.\n */\nexport interface JsonParseOptions {\n  maxSize?: number\n  allowPrototype?: boolean\n}\n\n/**\n * JSON parse result.\n */\nexport type JsonParseResult<T> =\n  | { success: true; data: T }\n  | { success: false; error: string }\n"],
+  "mappings": ";;;;;;;;;;;;;;AAAA;AAAA;",
+  "names": []
+}

package/dist/versions.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Coerce a version string to valid semver format.
+ */
+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.
+ */
+export declare function compareVersions(v1: string, v2: string): -1 | 0 | 1 | undefined;
+/**
+ * Get all versions from an array that satisfy a semver range.
+ */
+export declare function filterVersions(versions: string[], range: string): string[];
+/**
+ * Get the major version number from a version string.
+ */
+export declare function getMajorVersion(version: string): number | undefined;
+/**
+ * Get the minor version number from a version string.
+ */
+export declare function getMinorVersion(version: string): number | undefined;
+/**
+ * Get the patch version number from a version string.
+ */
+export declare function getPatchVersion(version: string): number | undefined;
+/**
+ * Increment a version by the specified release type.
+ */
+export declare function incrementVersion(version: string, release: 'major' | 'minor' | 'patch' | 'premajor' | 'preminor' | 'prepatch' | 'prerelease', identifier?: string | undefined): string | undefined;
+/**
+ * Check if version1 equals version2.
+ */
+export declare function isEqual(version1: string, version2: string): boolean;
+/**
+ * Check if version1 is greater than version2.
+ */
+export declare function isGreaterThan(version1: string, version2: string): boolean;
+/**
+ * Check if version1 is greater than or equal to version2.
+ */
+export declare function isGreaterThanOrEqual(version1: string, version2: string): boolean;
+/**
+ * Check if version1 is less than version2.
+ */
+export declare function isLessThan(version1: string, version2: string): boolean;
+/**
+ * Check if version1 is less than or equal to version2.
+ */
+export declare function isLessThanOrEqual(version1: string, version2: string): boolean;
+/**
+ * Validate if a string is a valid semantic version.
+ */
+export declare function isValidVersion(version: string): boolean;
+/**
+ * Get the highest version from an array of versions.
+ */
+export declare function maxVersion(versions: string[]): string | undefined;
+/**
+ * Get the lowest version from an array of versions.
+ */
+export declare function minVersion(versions: string[]): string | undefined;
+/**
+ * Parse a version string and return major, minor, patch components.
+ */
+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.
+ */
+export declare function satisfiesVersion(version: string, range: string): boolean;
+/**
+ * Sort versions in ascending order.
+ */
+export declare function sortVersions(versions: string[]): string[];
+/**
+ * Sort versions in descending order.
+ */
+export declare function sortVersionsDesc(versions: string[]): string[];
+/**
+ * Get the difference between two versions.
+ */
+export declare function versionDiff(version1: string, version2: string): 'major' | 'premajor' | 'minor' | 'preminor' | 'patch' | 'prepatch' | 'prerelease' | undefined;