@utilix-tech/sdk 0.28.0 → 0.30.0

package/dist/{generators-BGtRGpJZ.d.cts → generators-Du8cBesn.d.cts}

@@ -7,6 +7,7 @@
  *  - uuid-generator  : generateV4, generateV7, generateUuid, generateBulk, isValidUuid, parseUuidVersion
  *  - ulid-generator  : generateUlid, generateBulkUlids, parseUlid, isValidUlid
  *  - password-generator : generatePassword, generateBulkPasswords, checkStrength
+ *  - password-entropy-estimator : estimatePasswordEntropy
  *  - random-data     : generateSingle, generateData
  *  - qr-code         : generateQrSvg, generateQrDataUrl
  */
@@ -50,6 +51,43 @@ declare function checkStrength(password: string): {
     label: 'Very Weak' | 'Weak' | 'Fair' | 'Strong' | 'Very Strong';
     color: string;
 };
+interface PasswordCharsetInfo {
+    hasLowercase: boolean;
+    hasUppercase: boolean;
+    hasDigits: boolean;
+    hasSymbols: boolean;
+    hasOther: boolean;
+    poolSize: number;
+}
+interface PasswordCrackTimeEstimate {
+    scenario: string;
+    guessesPerSecond: number;
+    humanReadable: string;
+}
+type PasswordEntropyStrength = 'very-weak' | 'weak' | 'fair' | 'strong' | 'very-strong';
+interface PasswordEntropyResult {
+    length: number;
+    charset: PasswordCharsetInfo;
+    entropyBits: number;
+    strength: PasswordEntropyStrength;
+    crackTimes: PasswordCrackTimeEstimate[];
+    warnings: string[];
+}
+/**
+ * Estimate a password's entropy in bits from the character classes it
+ * actually draws from (lowercase, uppercase, digits, symbols, other/Unicode),
+ * then derive a strength label and crack-time estimates at a few realistic
+ * guess rates. This is the classic pool-size x length method, the same
+ * approach used by most public entropy calculators: it measures resistance
+ * to brute force over the theoretical character space, not real-world
+ * guessability against a breach-database or dictionary attack — a common
+ * word with substitutions can score high here while being easy to guess in
+ * practice, which is why the pattern-based warnings below exist alongside
+ * the raw entropy figure rather than folded into it.
+ */
+declare function estimatePasswordEntropy(password: string): PasswordEntropyResult | {
+    error: string;
+};
 type DataType = 'name' | 'email' | 'uuid' | 'phone' | 'date' | 'number' | 'boolean' | 'color' | 'url' | 'ipv4' | 'sentence' | 'paragraph';
 interface RandomConfig {
     type: DataType;
@@ -86,6 +124,10 @@ declare const generators_DEFAULT_OPTIONS: typeof DEFAULT_OPTIONS;
 declare const generators_DEFAULT_QR_OPTIONS: typeof DEFAULT_QR_OPTIONS;
 type generators_DataType = DataType;
 type generators_GeneratedUuid = GeneratedUuid;
+type generators_PasswordCharsetInfo = PasswordCharsetInfo;
+type generators_PasswordCrackTimeEstimate = PasswordCrackTimeEstimate;
+type generators_PasswordEntropyResult = PasswordEntropyResult;
+type generators_PasswordEntropyStrength = PasswordEntropyStrength;
 type generators_PasswordOptions = PasswordOptions;
 type generators_QrErrorLevel = QrErrorLevel;
 type generators_QrOptions = QrOptions;
@@ -95,6 +137,7 @@ declare const generators_SYMBOL_CHARS: typeof SYMBOL_CHARS;
 declare const generators_ULID_REGEX: typeof ULID_REGEX;
 type generators_UuidVersion = UuidVersion;
 declare const generators_checkStrength: typeof checkStrength;
+declare const generators_estimatePasswordEntropy: typeof estimatePasswordEntropy;
 declare const generators_generateBulk: typeof generateBulk;
 declare const generators_generateBulkPasswords: typeof generateBulkPasswords;
 declare const generators_generateBulkUlids: typeof generateBulkUlids;
@@ -112,7 +155,7 @@ declare const generators_isValidUuid: typeof isValidUuid;
 declare const generators_parseUlid: typeof parseUlid;
 declare const generators_parseUuidVersion: typeof parseUuidVersion;
 declare namespace generators {
-  export { generators_AMBIGUOUS_CHARS as AMBIGUOUS_CHARS, generators_DATA_TYPES as DATA_TYPES, generators_DEFAULT_OPTIONS as DEFAULT_OPTIONS, generators_DEFAULT_QR_OPTIONS as DEFAULT_QR_OPTIONS, type generators_DataType as DataType, type generators_GeneratedUuid as GeneratedUuid, type generators_PasswordOptions as PasswordOptions, type generators_QrErrorLevel as QrErrorLevel, type generators_QrOptions as QrOptions, type generators_QrOutputFormat as QrOutputFormat, type generators_RandomConfig as RandomConfig, generators_SYMBOL_CHARS as SYMBOL_CHARS, generators_ULID_REGEX as ULID_REGEX, type generators_UuidVersion as UuidVersion, generators_checkStrength as checkStrength, generators_generateBulk as generateBulk, generators_generateBulkPasswords as generateBulkPasswords, generators_generateBulkUlids as generateBulkUlids, generators_generateData as generateData, generators_generatePassword as generatePassword, generators_generateQrDataUrl as generateQrDataUrl, generators_generateQrSvg as generateQrSvg, generators_generateSingle as generateSingle, generators_generateUlid as generateUlid, generators_generateUuid as generateUuid, generators_generateV4 as generateV4, generators_generateV7 as generateV7, generators_isValidUlid as isValidUlid, generators_isValidUuid as isValidUuid, generators_parseUlid as parseUlid, generators_parseUuidVersion as parseUuidVersion };
+  export { generators_AMBIGUOUS_CHARS as AMBIGUOUS_CHARS, generators_DATA_TYPES as DATA_TYPES, generators_DEFAULT_OPTIONS as DEFAULT_OPTIONS, generators_DEFAULT_QR_OPTIONS as DEFAULT_QR_OPTIONS, type generators_DataType as DataType, type generators_GeneratedUuid as GeneratedUuid, type generators_PasswordCharsetInfo as PasswordCharsetInfo, type generators_PasswordCrackTimeEstimate as PasswordCrackTimeEstimate, type generators_PasswordEntropyResult as PasswordEntropyResult, type generators_PasswordEntropyStrength as PasswordEntropyStrength, type generators_PasswordOptions as PasswordOptions, type generators_QrErrorLevel as QrErrorLevel, type generators_QrOptions as QrOptions, type generators_QrOutputFormat as QrOutputFormat, type generators_RandomConfig as RandomConfig, generators_SYMBOL_CHARS as SYMBOL_CHARS, generators_ULID_REGEX as ULID_REGEX, type generators_UuidVersion as UuidVersion, generators_checkStrength as checkStrength, generators_estimatePasswordEntropy as estimatePasswordEntropy, generators_generateBulk as generateBulk, generators_generateBulkPasswords as generateBulkPasswords, generators_generateBulkUlids as generateBulkUlids, generators_generateData as generateData, generators_generatePassword as generatePassword, generators_generateQrDataUrl as generateQrDataUrl, generators_generateQrSvg as generateQrSvg, generators_generateSingle as generateSingle, generators_generateUlid as generateUlid, generators_generateUuid as generateUuid, generators_generateV4 as generateV4, generators_generateV7 as generateV7, generators_isValidUlid as isValidUlid, generators_isValidUuid as isValidUuid, generators_parseUlid as parseUlid, generators_parseUuidVersion as parseUuidVersion };
 }
 
-export { AMBIGUOUS_CHARS as A, DATA_TYPES as D, type GeneratedUuid as G, type PasswordOptions as P, type QrErrorLevel as Q, type RandomConfig as R, SYMBOL_CHARS as S, ULID_REGEX as U, DEFAULT_OPTIONS as a, DEFAULT_QR_OPTIONS as b, type DataType as c, type QrOptions as d, type QrOutputFormat as e, type UuidVersion as f, generators as g, checkStrength as h, generateBulk as i, generateBulkPasswords as j, generateBulkUlids as k, generateData as l, generatePassword as m, generateQrDataUrl as n, generateQrSvg as o, generateSingle as p, generateUlid as q, generateUuid as r, generateV4 as s, generateV7 as t, isValidUlid as u, isValidUuid as v, parseUlid as w, parseUuidVersion as x };
+export { AMBIGUOUS_CHARS as A, isValidUuid as B, parseUlid as C, DATA_TYPES as D, parseUuidVersion as E, type GeneratedUuid as G, type PasswordCharsetInfo as P, type QrErrorLevel as Q, type RandomConfig as R, SYMBOL_CHARS as S, ULID_REGEX as U, DEFAULT_OPTIONS as a, DEFAULT_QR_OPTIONS as b, type DataType as c, type PasswordCrackTimeEstimate as d, type PasswordEntropyResult as e, type PasswordEntropyStrength as f, generators as g, type PasswordOptions as h, type QrOptions as i, type QrOutputFormat as j, type UuidVersion as k, checkStrength as l, estimatePasswordEntropy as m, generateBulk as n, generateBulkPasswords as o, generateBulkUlids as p, generateData as q, generatePassword as r, generateQrDataUrl as s, generateQrSvg as t, generateSingle as u, generateUlid as v, generateUuid as w, generateV4 as x, generateV7 as y, isValidUlid as z };

package/dist/{generators-BGtRGpJZ.d.ts → generators-Du8cBesn.d.ts}

@@ -7,6 +7,7 @@
  *  - uuid-generator  : generateV4, generateV7, generateUuid, generateBulk, isValidUuid, parseUuidVersion
  *  - ulid-generator  : generateUlid, generateBulkUlids, parseUlid, isValidUlid
  *  - password-generator : generatePassword, generateBulkPasswords, checkStrength
+ *  - password-entropy-estimator : estimatePasswordEntropy
  *  - random-data     : generateSingle, generateData
  *  - qr-code         : generateQrSvg, generateQrDataUrl
  */
@@ -50,6 +51,43 @@ declare function checkStrength(password: string): {
     label: 'Very Weak' | 'Weak' | 'Fair' | 'Strong' | 'Very Strong';
     color: string;
 };
+interface PasswordCharsetInfo {
+    hasLowercase: boolean;
+    hasUppercase: boolean;
+    hasDigits: boolean;
+    hasSymbols: boolean;
+    hasOther: boolean;
+    poolSize: number;
+}
+interface PasswordCrackTimeEstimate {
+    scenario: string;
+    guessesPerSecond: number;
+    humanReadable: string;
+}
+type PasswordEntropyStrength = 'very-weak' | 'weak' | 'fair' | 'strong' | 'very-strong';
+interface PasswordEntropyResult {
+    length: number;
+    charset: PasswordCharsetInfo;
+    entropyBits: number;
+    strength: PasswordEntropyStrength;
+    crackTimes: PasswordCrackTimeEstimate[];
+    warnings: string[];
+}
+/**
+ * Estimate a password's entropy in bits from the character classes it
+ * actually draws from (lowercase, uppercase, digits, symbols, other/Unicode),
+ * then derive a strength label and crack-time estimates at a few realistic
+ * guess rates. This is the classic pool-size x length method, the same
+ * approach used by most public entropy calculators: it measures resistance
+ * to brute force over the theoretical character space, not real-world
+ * guessability against a breach-database or dictionary attack — a common
+ * word with substitutions can score high here while being easy to guess in
+ * practice, which is why the pattern-based warnings below exist alongside
+ * the raw entropy figure rather than folded into it.
+ */
+declare function estimatePasswordEntropy(password: string): PasswordEntropyResult | {
+    error: string;
+};
 type DataType = 'name' | 'email' | 'uuid' | 'phone' | 'date' | 'number' | 'boolean' | 'color' | 'url' | 'ipv4' | 'sentence' | 'paragraph';
 interface RandomConfig {
     type: DataType;
@@ -86,6 +124,10 @@ declare const generators_DEFAULT_OPTIONS: typeof DEFAULT_OPTIONS;
 declare const generators_DEFAULT_QR_OPTIONS: typeof DEFAULT_QR_OPTIONS;
 type generators_DataType = DataType;
 type generators_GeneratedUuid = GeneratedUuid;
+type generators_PasswordCharsetInfo = PasswordCharsetInfo;
+type generators_PasswordCrackTimeEstimate = PasswordCrackTimeEstimate;
+type generators_PasswordEntropyResult = PasswordEntropyResult;
+type generators_PasswordEntropyStrength = PasswordEntropyStrength;
 type generators_PasswordOptions = PasswordOptions;
 type generators_QrErrorLevel = QrErrorLevel;
 type generators_QrOptions = QrOptions;
@@ -95,6 +137,7 @@ declare const generators_SYMBOL_CHARS: typeof SYMBOL_CHARS;
 declare const generators_ULID_REGEX: typeof ULID_REGEX;
 type generators_UuidVersion = UuidVersion;
 declare const generators_checkStrength: typeof checkStrength;
+declare const generators_estimatePasswordEntropy: typeof estimatePasswordEntropy;
 declare const generators_generateBulk: typeof generateBulk;
 declare const generators_generateBulkPasswords: typeof generateBulkPasswords;
 declare const generators_generateBulkUlids: typeof generateBulkUlids;
@@ -112,7 +155,7 @@ declare const generators_isValidUuid: typeof isValidUuid;
 declare const generators_parseUlid: typeof parseUlid;
 declare const generators_parseUuidVersion: typeof parseUuidVersion;
 declare namespace generators {
-  export { generators_AMBIGUOUS_CHARS as AMBIGUOUS_CHARS, generators_DATA_TYPES as DATA_TYPES, generators_DEFAULT_OPTIONS as DEFAULT_OPTIONS, generators_DEFAULT_QR_OPTIONS as DEFAULT_QR_OPTIONS, type generators_DataType as DataType, type generators_GeneratedUuid as GeneratedUuid, type generators_PasswordOptions as PasswordOptions, type generators_QrErrorLevel as QrErrorLevel, type generators_QrOptions as QrOptions, type generators_QrOutputFormat as QrOutputFormat, type generators_RandomConfig as RandomConfig, generators_SYMBOL_CHARS as SYMBOL_CHARS, generators_ULID_REGEX as ULID_REGEX, type generators_UuidVersion as UuidVersion, generators_checkStrength as checkStrength, generators_generateBulk as generateBulk, generators_generateBulkPasswords as generateBulkPasswords, generators_generateBulkUlids as generateBulkUlids, generators_generateData as generateData, generators_generatePassword as generatePassword, generators_generateQrDataUrl as generateQrDataUrl, generators_generateQrSvg as generateQrSvg, generators_generateSingle as generateSingle, generators_generateUlid as generateUlid, generators_generateUuid as generateUuid, generators_generateV4 as generateV4, generators_generateV7 as generateV7, generators_isValidUlid as isValidUlid, generators_isValidUuid as isValidUuid, generators_parseUlid as parseUlid, generators_parseUuidVersion as parseUuidVersion };
+  export { generators_AMBIGUOUS_CHARS as AMBIGUOUS_CHARS, generators_DATA_TYPES as DATA_TYPES, generators_DEFAULT_OPTIONS as DEFAULT_OPTIONS, generators_DEFAULT_QR_OPTIONS as DEFAULT_QR_OPTIONS, type generators_DataType as DataType, type generators_GeneratedUuid as GeneratedUuid, type generators_PasswordCharsetInfo as PasswordCharsetInfo, type generators_PasswordCrackTimeEstimate as PasswordCrackTimeEstimate, type generators_PasswordEntropyResult as PasswordEntropyResult, type generators_PasswordEntropyStrength as PasswordEntropyStrength, type generators_PasswordOptions as PasswordOptions, type generators_QrErrorLevel as QrErrorLevel, type generators_QrOptions as QrOptions, type generators_QrOutputFormat as QrOutputFormat, type generators_RandomConfig as RandomConfig, generators_SYMBOL_CHARS as SYMBOL_CHARS, generators_ULID_REGEX as ULID_REGEX, type generators_UuidVersion as UuidVersion, generators_checkStrength as checkStrength, generators_estimatePasswordEntropy as estimatePasswordEntropy, generators_generateBulk as generateBulk, generators_generateBulkPasswords as generateBulkPasswords, generators_generateBulkUlids as generateBulkUlids, generators_generateData as generateData, generators_generatePassword as generatePassword, generators_generateQrDataUrl as generateQrDataUrl, generators_generateQrSvg as generateQrSvg, generators_generateSingle as generateSingle, generators_generateUlid as generateUlid, generators_generateUuid as generateUuid, generators_generateV4 as generateV4, generators_generateV7 as generateV7, generators_isValidUlid as isValidUlid, generators_isValidUuid as isValidUuid, generators_parseUlid as parseUlid, generators_parseUuidVersion as parseUuidVersion };
 }
 
-export { AMBIGUOUS_CHARS as A, DATA_TYPES as D, type GeneratedUuid as G, type PasswordOptions as P, type QrErrorLevel as Q, type RandomConfig as R, SYMBOL_CHARS as S, ULID_REGEX as U, DEFAULT_OPTIONS as a, DEFAULT_QR_OPTIONS as b, type DataType as c, type QrOptions as d, type QrOutputFormat as e, type UuidVersion as f, generators as g, checkStrength as h, generateBulk as i, generateBulkPasswords as j, generateBulkUlids as k, generateData as l, generatePassword as m, generateQrDataUrl as n, generateQrSvg as o, generateSingle as p, generateUlid as q, generateUuid as r, generateV4 as s, generateV7 as t, isValidUlid as u, isValidUuid as v, parseUlid as w, parseUuidVersion as x };
+export { AMBIGUOUS_CHARS as A, isValidUuid as B, parseUlid as C, DATA_TYPES as D, parseUuidVersion as E, type GeneratedUuid as G, type PasswordCharsetInfo as P, type QrErrorLevel as Q, type RandomConfig as R, SYMBOL_CHARS as S, ULID_REGEX as U, DEFAULT_OPTIONS as a, DEFAULT_QR_OPTIONS as b, type DataType as c, type PasswordCrackTimeEstimate as d, type PasswordEntropyResult as e, type PasswordEntropyStrength as f, generators as g, type PasswordOptions as h, type QrOptions as i, type QrOutputFormat as j, type UuidVersion as k, checkStrength as l, estimatePasswordEntropy as m, generateBulk as n, generateBulkPasswords as o, generateBulkUlids as p, generateData as q, generatePassword as r, generateQrDataUrl as s, generateQrSvg as t, generateSingle as u, generateUlid as v, generateUuid as w, generateV4 as x, generateV7 as y, isValidUlid as z };

package/dist/index.cjs

@@ -53,6 +53,7 @@ __export(json_exports, {
   inferGoType: () => inferGoType,
   inferPythonType: () => inferPythonType,
   inferType: () => inferType,
+  jsonSchemaToTypescript: () => jsonSchemaToTypescript,
   jsonToCsv: () => jsonToCsv,
   jsonToGo: () => jsonToGo,
   jsonToPython: () => jsonToPython,
@@ -1340,6 +1341,105 @@ function resolveJsonPointer(json, pointer) {
   }
   return { pointer, found: true, value: current, tokens };
 }
+function _schemaRefName(ref) {
+  const parts = ref.split("/");
+  return _capitalize(parts[parts.length - 1] || "Ref");
+}
+function _schemaLiteralType(value) {
+  if (typeof value === "string") return JSON.stringify(value);
+  if (typeof value === "number" || typeof value === "boolean") return String(value);
+  if (value === null) return "null";
+  return JSON.stringify(value);
+}
+function _safePropertyKey(key) {
+  return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(key) ? key : JSON.stringify(key);
+}
+function _schemaToTsType(schema, name, interfaces) {
+  if (schema.$ref) return _schemaRefName(schema.$ref);
+  if (schema.const !== void 0) return _schemaLiteralType(schema.const);
+  if (schema.enum) return schema.enum.map(_schemaLiteralType).join(" | ");
+  if (schema.oneOf) return schema.oneOf.map((s, i) => _schemaToTsType(s, `${name}Variant${i}`, interfaces)).join(" | ");
+  if (schema.anyOf) return schema.anyOf.map((s, i) => _schemaToTsType(s, `${name}Variant${i}`, interfaces)).join(" | ");
+  if (schema.allOf) return schema.allOf.map((s, i) => _schemaToTsType(s, `${name}Part${i}`, interfaces)).join(" & ");
+  const types = Array.isArray(schema.type) ? schema.type : schema.type ? [schema.type] : [];
+  const nullable = types.includes("null");
+  const nonNullTypes = types.filter((t) => t !== "null");
+  const primaryType = nonNullTypes[0] ?? (schema.properties || schema.additionalProperties !== void 0 ? "object" : void 0);
+  let result;
+  switch (primaryType) {
+    case "string":
+      result = "string";
+      break;
+    case "number":
+    case "integer":
+      result = "number";
+      break;
+    case "boolean":
+      result = "boolean";
+      break;
+    case "array": {
+      const itemsSchema = Array.isArray(schema.items) ? schema.items[0] : schema.items;
+      const itemType = itemsSchema ? _schemaToTsType(itemsSchema, `${name}Item`, interfaces) : "unknown";
+      result = `${itemType}[]`;
+      break;
+    }
+    case "object": {
+      _buildSchemaInterface(schema, name, interfaces);
+      result = name;
+      break;
+    }
+    default:
+      result = "unknown";
+  }
+  return nullable ? `${result} | null` : result;
+}
+function _buildSchemaInterface(schema, name, interfaces) {
+  if (interfaces.has(name)) return;
+  const required = new Set(schema.required ?? []);
+  const lines = [`interface ${name} {`];
+  for (const [key, propSchema] of Object.entries(schema.properties ?? {})) {
+    if (propSchema.description) lines.push(`  /** ${propSchema.description} */`);
+    const optional = required.has(key) ? "" : "?";
+    const propType = _schemaToTsType(propSchema, _capitalize(key), interfaces);
+    lines.push(`  ${_safePropertyKey(key)}${optional}: ${propType};`);
+  }
+  if (schema.additionalProperties === true) {
+    lines.push("  [key: string]: unknown;");
+  } else if (schema.additionalProperties && typeof schema.additionalProperties === "object") {
+    const addType = _schemaToTsType(schema.additionalProperties, `${name}Value`, interfaces);
+    lines.push(`  [key: string]: ${addType};`);
+  }
+  lines.push("}");
+  interfaces.set(name, lines.join("\n"));
+}
+function jsonSchemaToTypescript(schemaJson, options) {
+  let schema;
+  try {
+    schema = JSON.parse(schemaJson);
+  } catch {
+    return { error: "Invalid JSON input" };
+  }
+  if (typeof schema !== "object" || schema === null || Array.isArray(schema)) {
+    return { error: "Schema must be a JSON object" };
+  }
+  const rootName = options?.rootName ?? "Root";
+  const typedSchema = schema;
+  const interfaces = /* @__PURE__ */ new Map();
+  const defs = { ...typedSchema.$defs ?? {}, ...typedSchema.definitions ?? {} };
+  for (const [defName, defSchema] of Object.entries(defs)) {
+    const defTypeName = _capitalize(defName);
+    const defType = _schemaToTsType(defSchema, defTypeName, interfaces);
+    if (!interfaces.has(defTypeName)) {
+      interfaces.set(defTypeName, `type ${defTypeName} = ${defType};`);
+    }
+  }
+  const rootType = _schemaToTsType(typedSchema, rootName, interfaces);
+  const parts = [...interfaces.values()];
+  if (!interfaces.has(rootName)) {
+    parts.push(`type ${rootName} = ${rootType};`);
+  }
+  return parts.join("\n\n");
+}
 
 // src/tools/encoding.ts
 var encoding_exports = {};
@@ -5849,6 +5949,7 @@ __export(generators_exports, {
   SYMBOL_CHARS: () => SYMBOL_CHARS,
   ULID_REGEX: () => ULID_REGEX,
   checkStrength: () => checkStrength,
+  estimatePasswordEntropy: () => estimatePasswordEntropy,
   generateBulk: () => generateBulk,
   generateBulkPasswords: () => generateBulkPasswords,
   generateBulkUlids: () => generateBulkUlids,
@@ -6065,6 +6166,111 @@ function checkStrength(password) {
     color: levels[score].color
   };
 }
+var _SYMBOL_POOL_CHARS = " !\"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~";
+var _SYMBOL_POOL_SET = new Set(_SYMBOL_POOL_CHARS.split(""));
+function _hasSymbolChar(password) {
+  for (const ch of password) {
+    if (_SYMBOL_POOL_SET.has(ch)) return true;
+  }
+  return false;
+}
+function _hasSequentialRun(password, minRun) {
+  let ascRun = 1;
+  let descRun = 1;
+  for (let i = 1; i < password.length; i++) {
+    const prev = password.charCodeAt(i - 1);
+    const curr = password.charCodeAt(i);
+    if (curr === prev + 1) {
+      ascRun++;
+      descRun = 1;
+    } else if (curr === prev - 1) {
+      descRun++;
+      ascRun = 1;
+    } else {
+      ascRun = 1;
+      descRun = 1;
+    }
+    if (ascRun >= minRun || descRun >= minRun) return true;
+  }
+  return false;
+}
+function _formatCrackDuration(seconds) {
+  if (!isFinite(seconds)) return "effectively never";
+  if (seconds < 1) return "instantly";
+  const units = [
+    ["century", 315576e4],
+    ["year", 31557600],
+    ["month", 2629800],
+    ["day", 86400],
+    ["hour", 3600],
+    ["minute", 60],
+    ["second", 1]
+  ];
+  for (const [name, unitSeconds] of units) {
+    if (seconds >= unitSeconds) {
+      const value = seconds / unitSeconds;
+      if (name === "century" && value > 1e3) return "longer than the age of the universe";
+      const rounded = value >= 100 ? Math.round(value) : Math.round(value * 10) / 10;
+      const plural = name === "century" ? "centuries" : `${name}s`;
+      return `${rounded} ${rounded === 1 ? name : plural}`;
+    }
+  }
+  return "instantly";
+}
+function estimatePasswordEntropy(password) {
+  if (!password) return { error: "Password is required" };
+  const hasLowercase = /[a-z]/.test(password);
+  const hasUppercase = /[A-Z]/.test(password);
+  const hasDigits = /[0-9]/.test(password);
+  const hasSymbols = _hasSymbolChar(password);
+  const hasOther = /[^\x20-\x7e]/.test(password);
+  let poolSize = 0;
+  if (hasLowercase) poolSize += 26;
+  if (hasUppercase) poolSize += 26;
+  if (hasDigits) poolSize += 10;
+  if (hasSymbols) poolSize += _SYMBOL_POOL_CHARS.length;
+  if (hasOther) poolSize += 100;
+  const entropyBits = Math.round(password.length * Math.log2(poolSize) * 100) / 100;
+  let strength;
+  if (entropyBits < 28) strength = "very-weak";
+  else if (entropyBits < 36) strength = "weak";
+  else if (entropyBits < 60) strength = "fair";
+  else if (entropyBits < 128) strength = "strong";
+  else strength = "very-strong";
+  const averageGuesses = Math.pow(2, entropyBits) / 2;
+  const scenarios = [
+    { scenario: "Online, throttled (100 guesses/hour)", guessesPerSecond: 100 / 3600 },
+    { scenario: "Online, unthrottled (10 guesses/sec)", guessesPerSecond: 10 },
+    { scenario: "Offline, slow hash e.g. bcrypt (10k guesses/sec)", guessesPerSecond: 1e4 },
+    { scenario: "Offline, fast hash / GPU cluster (10B guesses/sec)", guessesPerSecond: 1e10 }
+  ];
+  const crackTimes = scenarios.map((s) => ({
+    scenario: s.scenario,
+    guessesPerSecond: s.guessesPerSecond,
+    humanReadable: _formatCrackDuration(averageGuesses / s.guessesPerSecond)
+  }));
+  const warnings = [];
+  if (password.length < 8) {
+    warnings.push("Shorter than 8 characters \u2014 most sites and cracking tools treat this as trivially weak regardless of entropy.");
+  }
+  if (/(.)\1{2,}/.test(password)) {
+    warnings.push('Contains a repeated character run (e.g. "aaa"), which is easier to guess than the entropy figure implies.');
+  }
+  if (_hasSequentialRun(password, 3)) {
+    warnings.push('Contains a sequential run (e.g. "abc" or "321"), which is easier to guess than the entropy figure implies.');
+  }
+  if (poolSize <= 26) {
+    warnings.push("Uses only one character class \u2014 mixing in uppercase, digits, or symbols raises the character pool and entropy.");
+  }
+  return {
+    length: password.length,
+    charset: { hasLowercase, hasUppercase, hasDigits, hasSymbols, hasOther, poolSize },
+    entropyBits,
+    strength,
+    crackTimes,
+    warnings
+  };
+}
 var DATA_TYPES = [
   { value: "name", label: "Full Name", example: "John Smith" },
   { value: "email", label: "Email Address", example: "john.smith@gmail.com" },
@@ -8833,6 +9039,7 @@ __export(network_exports, {
   parseDnsResponse: () => parseDnsResponse,
   parseGeoResponse: () => parseGeoResponse,
   parseHar: () => parseHar,
+  parseIpv6Address: () => parseIpv6Address,
   parseUserAgent: () => parseUserAgent,
   searchHeaders: () => searchHeaders,
   searchStatusCodes: () => searchStatusCodes,
@@ -10620,6 +10827,94 @@ function buildCacheControl(options = {}) {
   const snippet = `Cache-Control: ${header}`;
   return { header, headerName: "Cache-Control", snippet, directives, warnings };
 }
+function isValidIpv6HexGroup(g) {
+  return /^[0-9a-fA-F]{1,4}$/.test(g);
+}
+function isValidIpv6Ipv4Quad(quad) {
+  const parts = quad.split(".");
+  if (parts.length !== 4) return false;
+  return parts.every((p) => /^\d{1,3}$/.test(p) && Number(p) <= 255);
+}
+function classifyIpv6(groups) {
+  const first = parseInt(groups[0], 16);
+  if (groups.every((g) => g === "0000")) return "unspecified";
+  if (groups.slice(0, 7).every((g) => g === "0000") && groups[7] === "0001") return "loopback";
+  if (groups.slice(0, 4).every((g) => g === "0000") && groups[4] === "0000" && groups[5] === "ffff") return "ipv4-mapped";
+  if (groups[0] === "2001" && groups[1] === "0db8") return "documentation";
+  if ((first & 65280) === 65280) return "multicast";
+  if ((first & 65472) === 65152) return "link-local";
+  if ((first & 65024) === 64512) return "unique-local";
+  return "global-unicast";
+}
+function compressIpv6Groups(groups) {
+  const short = groups.map((g) => g.replace(/^0+(?=.)/, ""));
+  let bestStart = -1;
+  let bestLen = 0;
+  let curStart = -1;
+  let curLen = 0;
+  for (let i = 0; i < short.length; i++) {
+    if (short[i] === "0") {
+      if (curStart === -1) curStart = i;
+      curLen++;
+      if (curLen > bestLen) {
+        bestLen = curLen;
+        bestStart = curStart;
+      }
+    } else {
+      curStart = -1;
+      curLen = 0;
+    }
+  }
+  if (bestLen < 2) return short.join(":");
+  const before = short.slice(0, bestStart).join(":");
+  const after = short.slice(bestStart + bestLen).join(":");
+  return `${before}::${after}`;
+}
+function parseIpv6Address(input) {
+  let s = input.trim();
+  if (s.startsWith("[") && s.includes("]")) s = s.slice(1, s.indexOf("]"));
+  let zoneId = null;
+  const pctIdx = s.indexOf("%");
+  if (pctIdx !== -1) {
+    zoneId = s.slice(pctIdx + 1);
+    s = s.slice(0, pctIdx);
+  }
+  if (!s) return { error: "Empty address" };
+  const doubleColonCount = (s.match(/::/g) ?? []).length;
+  if (doubleColonCount > 1) return { error: 'Address contains more than one "::"' };
+  const ipv4Match = s.match(/(\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3})$/);
+  if (ipv4Match) {
+    const quad = ipv4Match[1];
+    if (!isValidIpv6Ipv4Quad(quad)) return { error: `Invalid embedded IPv4 address: ${quad}` };
+    const parts = quad.split(".").map(Number);
+    const hi = (parts[0] << 8 | parts[1]).toString(16);
+    const lo = (parts[2] << 8 | parts[3]).toString(16);
+    s = s.slice(0, s.length - quad.length) + `${hi}:${lo}`;
+  }
+  let groups;
+  if (s.includes("::")) {
+    const [left, right] = s.split("::");
+    const leftGroups = left ? left.split(":") : [];
+    const rightGroups = right ? right.split(":") : [];
+    const missing = 8 - (leftGroups.length + rightGroups.length);
+    if (missing < 1) return { error: 'The "::" shorthand must represent at least one group of zeros' };
+    if (![...leftGroups, ...rightGroups].every(isValidIpv6HexGroup)) return { error: "Invalid hex group in address" };
+    groups = [...leftGroups, ...Array(missing).fill("0"), ...rightGroups];
+  } else {
+    groups = s.split(":");
+    if (groups.length !== 8) return { error: `Expected 8 groups, got ${groups.length}` };
+    if (!groups.every(isValidIpv6HexGroup)) return { error: "Invalid hex group in address" };
+  }
+  const expandedGroups = groups.map((g) => g.padStart(4, "0").toLowerCase());
+  const suffix = zoneId ? `%${zoneId}` : "";
+  return {
+    expanded: expandedGroups.join(":") + suffix,
+    compressed: compressIpv6Groups(expandedGroups) + suffix,
+    groups: expandedGroups,
+    zoneId,
+    addressType: classifyIpv6(expandedGroups)
+  };
+}
 
 // src/tools/api.ts
 var api_exports = {};
@@ -19237,6 +19532,7 @@ __export(media_exports, {
   readId3Tags: () => readId3Tags,
   readImageInfo: () => readImageInfo,
   readPdfMetadata: () => readPdfMetadata,
+  readPdfPageDimensions: () => readPdfPageDimensions,
   readVideoInfo: () => readVideoInfo,
   readWavInfo: () => readWavInfo
 });
@@ -19696,6 +19992,116 @@ function readPdfMetadata(bytes) {
     encrypted
   };
 }
+var PDF_COMMON_PAPER_SIZES = [
+  { name: "Letter", widthPt: 612, heightPt: 792 },
+  { name: "Legal", widthPt: 612, heightPt: 1008 },
+  { name: "Tabloid", widthPt: 792, heightPt: 1224 },
+  { name: "A3", widthPt: 842, heightPt: 1191 },
+  { name: "A4", widthPt: 595, heightPt: 842 },
+  { name: "A5", widthPt: 420, heightPt: 595 },
+  { name: "B5", widthPt: 499, heightPt: 709 }
+];
+function matchPaperSize(widthPt, heightPt) {
+  for (const size of PDF_COMMON_PAPER_SIZES) {
+    const w = Math.abs(widthPt - size.widthPt) <= 1;
+    const h = Math.abs(heightPt - size.heightPt) <= 1;
+    const wSwapped = Math.abs(widthPt - size.heightPt) <= 1;
+    const hSwapped = Math.abs(heightPt - size.widthPt) <= 1;
+    if (w && h || wSwapped && hSwapped) return size.name;
+  }
+  return null;
+}
+function parsePdfMediaBox(dict) {
+  const m = dict.match(/\/MediaBox\s*\[\s*(-?[\d.]+)\s+(-?[\d.]+)\s+(-?[\d.]+)\s+(-?[\d.]+)\s*\]/);
+  if (!m) return null;
+  return [Number(m[1]), Number(m[2]), Number(m[3]), Number(m[4])];
+}
+function parsePdfRotate(dict) {
+  const m = dict.match(/\/Rotate\s+(-?\d+)/);
+  return m ? Number(m[1]) : null;
+}
+function buildPdfPageDimension(pageNumber, mediaBox, rotate) {
+  const rotation = (rotate % 360 + 360) % 360;
+  if (!mediaBox) {
+    return { pageNumber, widthPt: null, heightPt: null, widthIn: null, heightIn: null, rotation, orientation: null, paperSize: null };
+  }
+  const [llx, lly, urx, ury] = mediaBox;
+  let widthPt = Math.abs(urx - llx);
+  let heightPt = Math.abs(ury - lly);
+  if (rotation === 90 || rotation === 270) [widthPt, heightPt] = [heightPt, widthPt];
+  const orientation = widthPt === heightPt ? "square" : widthPt > heightPt ? "landscape" : "portrait";
+  return {
+    pageNumber,
+    widthPt: round22(widthPt),
+    heightPt: round22(heightPt),
+    widthIn: round22(widthPt / 72),
+    heightIn: round22(heightPt / 72),
+    rotation,
+    orientation,
+    paperSize: matchPaperSize(widthPt, heightPt)
+  };
+}
+function walkPdfPageTree(objMap, nodeBody, inherited, visited, nodeKey, out) {
+  if (visited.has(nodeKey)) return;
+  visited.add(nodeKey);
+  const mediaBox = parsePdfMediaBox(nodeBody) ?? inherited.mediaBox;
+  const rotateMatch = parsePdfRotate(nodeBody);
+  const rotate = rotateMatch !== null ? rotateMatch : inherited.rotate;
+  if (/\/Type\s*\/Page(?!s)\b/.test(nodeBody)) {
+    out.push(buildPdfPageDimension(out.length + 1, mediaBox, rotate));
+    return;
+  }
+  const kidsMatch = nodeBody.match(/\/Kids\s*\[([^\]]*)\]/);
+  if (!kidsMatch) return;
+  const kidRefs = [...kidsMatch[1].matchAll(/(\d+)\s+(\d+)\s+R/g)];
+  for (const ref of kidRefs) {
+    const key = `${ref[1]} ${ref[2]}`;
+    const body = objMap.get(key);
+    if (body) walkPdfPageTree(objMap, body, { mediaBox, rotate }, visited, key, out);
+  }
+}
+function readPdfPageDimensions(bytes) {
+  if (bytes.length < 8) return { error: "File too small to be a PDF" };
+  const header = bytesToLatin1(bytes.subarray(0, 16));
+  const versionMatch = header.match(/%PDF-(\d\.\d)/);
+  if (!versionMatch) return { error: "Not a valid PDF file (missing %PDF header)" };
+  const version2 = versionMatch[1];
+  const text = bytesToLatin1(bytes);
+  const objBlocks = [...text.matchAll(/(\d+)\s+(\d+)\s+obj([\s\S]*?)endobj/g)];
+  const objMap = /* @__PURE__ */ new Map();
+  for (const b of objBlocks) objMap.set(`${b[1]} ${b[2]}`, b[3]);
+  const out = [];
+  const visited = /* @__PURE__ */ new Set();
+  let pagesRootBody = null;
+  const trailerMatches = [...text.matchAll(/trailer\s*<<([\s\S]*?)>>/g)];
+  if (trailerMatches.length > 0) {
+    const trailer = trailerMatches[trailerMatches.length - 1][1];
+    const rootRef = trailer.match(/\/Root\s+(\d+)\s+(\d+)\s+R/);
+    if (rootRef) {
+      const catalogBody = objMap.get(`${rootRef[1]} ${rootRef[2]}`);
+      const pagesRef = catalogBody?.match(/\/Pages\s+(\d+)\s+(\d+)\s+R/);
+      if (pagesRef) pagesRootBody = objMap.get(`${pagesRef[1]} ${pagesRef[2]}`) ?? null;
+    }
+  }
+  if (!pagesRootBody) {
+    for (const b of objBlocks) {
+      if (/\/Type\s*\/Pages\b/.test(b[3]) && !/\/Parent\s+\d+\s+\d+\s+R/.test(b[3])) {
+        pagesRootBody = b[3];
+        break;
+      }
+    }
+  }
+  if (pagesRootBody) walkPdfPageTree(objMap, pagesRootBody, { mediaBox: null, rotate: 0 }, visited, "root", out);
+  if (out.length === 0) {
+    for (const b of objBlocks) {
+      if (/\/Type\s*\/Page(?!s)\b/.test(b[3])) {
+        out.push(buildPdfPageDimension(out.length + 1, parsePdfMediaBox(b[3]), parsePdfRotate(b[3]) ?? 0));
+      }
+    }
+  }
+  if (out.length === 0) return { error: "Could not locate any page objects in this PDF" };
+  return { version: version2, pageCount: out.length, pages: out };
+}
 var AUDIO_FORMAT_LABELS = {
   1: "PCM",
   3: "IEEE float",

package/dist/index.d.cts

@@ -1,19 +1,19 @@
-export { j as json } from './json-DEVFIpsC.cjs';
+export { j as json } from './json-Ta9JykSB.cjs';
 export { e as encoding } from './encoding-Dk3wpmb3.cjs';
 export { h as hashing } from './hashing-CnetQFD_.cjs';
 export { t as text } from './text-D1fySkCB.cjs';
 export { d as data } from './data-XRb0D7Zn.cjs';
-export { g as generators } from './generators-BGtRGpJZ.cjs';
+export { g as generators } from './generators-Du8cBesn.cjs';
 export { t as time } from './time-KqJjdqII.cjs';
 export { u as units } from './units-COt5uI20.cjs';
-export { n as network } from './network-BJOjJnmY.cjs';
+export { n as network } from './network-D7Epuerc.cjs';
 export { a as api } from './api-DmTNE4c1.cjs';
 export { c as code } from './code-DaRvff2v.cjs';
 export { c as color } from './color-tPwZCr9H.cjs';
 export { c as css } from './css-Cf7AMGM-.cjs';
 export { m as misc } from './misc-CA3N198T.cjs';
 export { a as ai_agent } from './ai_agent-B-c59NXD.cjs';
-export { m as media } from './media-cuxfzXxw.cjs';
+export { m as media } from './media-fD8dJ5qR.cjs';
 
 declare const version = "0.1.0";