@itshackers/utilix 0.0.0-stage → 0.3.0

package/dist/password/index.cjs

@@ -0,0 +1,71 @@
+'use strict';
+
+// src/internal/random.ts
+function getCrypto() {
+  const cryptoApi = globalThis.crypto;
+  if (!cryptoApi?.getRandomValues) {
+    throw new Error("Secure random number generation is not available in this runtime");
+  }
+  return cryptoApi;
+}
+function randomIndex(length) {
+  if (length <= 0) {
+    throw new RangeError("length must be greater than 0");
+  }
+  const cryptoApi = getCrypto();
+  const limit = 4294967296;
+  const unbiasedMax = Math.floor(limit / length) * length;
+  const bytes = new Uint32Array(1);
+  let value = 0;
+  do {
+    cryptoApi.getRandomValues(bytes);
+    value = bytes[0] ?? 0;
+  } while (value >= unbiasedMax);
+  return value % length;
+}
+function pickCharacter(charset) {
+  return charset[randomIndex(charset.length)] ?? charset[0] ?? "A";
+}
+function shuffle(items) {
+  const result = [...items];
+  for (let index = result.length - 1; index > 0; index -= 1) {
+    const swapIndex = randomIndex(index + 1);
+    const current = result[index];
+    const other = result[swapIndex];
+    if (current === void 0 || other === void 0) {
+      continue;
+    }
+    result[index] = other;
+    result[swapIndex] = current;
+  }
+  return result;
+}
+
+// src/password/index.ts
+var UPPERCASE = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
+var LOWERCASE = "abcdefghijklmnopqrstuvwxyz";
+var NUMBERS = "0123456789";
+var SPECIAL = "!@#$%^&*()_+-=[]{}|;:,.<>?";
+var ALL_CHARACTERS = `${UPPERCASE}${LOWERCASE}${NUMBERS}${SPECIAL}`;
+var MIN_PASSWORD_LENGTH = 8;
+var DEFAULT_PASSWORD_LENGTH = 12;
+function generatePassword(length = DEFAULT_PASSWORD_LENGTH) {
+  if (!Number.isInteger(length) || length < MIN_PASSWORD_LENGTH) {
+    throw new RangeError(`length must be an integer greater than or equal to ${MIN_PASSWORD_LENGTH}`);
+  }
+  const required = [
+    pickCharacter(UPPERCASE),
+    pickCharacter(LOWERCASE),
+    pickCharacter(NUMBERS),
+    pickCharacter(SPECIAL)
+  ];
+  const remaining = Array.from(
+    { length: length - required.length },
+    () => pickCharacter(ALL_CHARACTERS)
+  );
+  return shuffle([...required, ...remaining]).join("");
+}
+
+exports.generatePassword = generatePassword;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/password/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/internal/random.ts","../../src/password/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["function getCrypto(): Crypto {\r\n  const cryptoApi = globalThis.crypto;\r\n  if (!cryptoApi?.getRandomValues) {\r\n    throw new Error(\"Secure random number generation is not available in this runtime\");\r\n  }\r\n\r\n  return cryptoApi;\r\n}\r\n\r\nexport function randomIndex(length: number): number {\r\n  if (length <= 0) {\r\n    throw new RangeError(\"length must be greater than 0\");\r\n  }\r\n\r\n  const cryptoApi = getCrypto();\r\n  const limit = 0x1_0000_0000;\r\n  const unbiasedMax = Math.floor(limit / length) * length;\r\n  const bytes = new Uint32Array(1);\r\n\r\n  let value = 0;\r\n  do {\r\n    cryptoApi.getRandomValues(bytes);\r\n    value = bytes[0] ?? 0;\r\n  } while (value >= unbiasedMax);\r\n\r\n  return value % length;\r\n}\r\n\r\nexport function pickCharacter(charset: string): string {\r\n  return charset[randomIndex(charset.length)] ?? charset[0] ?? \"A\";\r\n}\r\n\r\nexport function randomString(length: number, charset: string): string {\r\n  return Array.from({ length }, () => pickCharacter(charset)).join(\"\");\r\n}\r\n\r\nexport function shuffle<T>(items: T[]): T[] {\r\n  const result = [...items];\r\n  for (let index = result.length - 1; index > 0; index -= 1) {\r\n    const swapIndex = randomIndex(index + 1);\r\n    const current = result[index];\r\n    const other = result[swapIndex];\r\n    if (current === undefined || other === undefined) {\r\n      continue;\r\n    }\r\n    result[index] = other;\r\n    result[swapIndex] = current;\r\n  }\r\n  return result;\r\n}\r\n","import { pickCharacter, shuffle } from \"../internal/random.js\";\r\n\r\nconst UPPERCASE = \"ABCDEFGHIJKLMNOPQRSTUVWXYZ\";\r\nconst LOWERCASE = \"abcdefghijklmnopqrstuvwxyz\";\r\nconst NUMBERS = \"0123456789\";\r\nconst SPECIAL = \"!@#$%^&*()_+-=[]{}|;:,.<>?\";\r\nconst ALL_CHARACTERS = `${UPPERCASE}${LOWERCASE}${NUMBERS}${SPECIAL}`;\r\nconst MIN_PASSWORD_LENGTH = 8;\r\nconst DEFAULT_PASSWORD_LENGTH = 12;\r\n\r\n/**\r\n * Generates a password with at least one uppercase letter, lowercase letter,\r\n * number, and special character. Uses `crypto.getRandomValues`.\r\n *\r\n * This is not a password-policy engine and does not hash passwords.\r\n *\r\n * @throws {RangeError} When `length` is below 8 or not an integer.\r\n *\r\n * @example\r\n * generatePassword()\r\n * generatePassword(16)\r\n */\r\nexport function generatePassword(length = DEFAULT_PASSWORD_LENGTH): string {\r\n  if (!Number.isInteger(length) || length < MIN_PASSWORD_LENGTH) {\r\n    throw new RangeError(`length must be an integer greater than or equal to ${MIN_PASSWORD_LENGTH}`);\r\n  }\r\n\r\n  const required = [\r\n    pickCharacter(UPPERCASE),\r\n    pickCharacter(LOWERCASE),\r\n    pickCharacter(NUMBERS),\r\n    pickCharacter(SPECIAL),\r\n  ];\r\n\r\n  const remaining = Array.from({ length: length - required.length }, () =>\r\n    pickCharacter(ALL_CHARACTERS),\r\n  );\r\n\r\n  return shuffle([...required, ...remaining]).join(\"\");\r\n}\r\n"]}

package/dist/password/index.d.cts

@@ -0,0 +1,15 @@
+/**
+ * Generates a password with at least one uppercase letter, lowercase letter,
+ * number, and special character. Uses `crypto.getRandomValues`.
+ *
+ * This is not a password-policy engine and does not hash passwords.
+ *
+ * @throws {RangeError} When `length` is below 8 or not an integer.
+ *
+ * @example
+ * generatePassword()
+ * generatePassword(16)
+ */
+declare function generatePassword(length?: number): string;
+
+export { generatePassword };

package/dist/password/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Generates a password with at least one uppercase letter, lowercase letter,
+ * number, and special character. Uses `crypto.getRandomValues`.
+ *
+ * This is not a password-policy engine and does not hash passwords.
+ *
+ * @throws {RangeError} When `length` is below 8 or not an integer.
+ *
+ * @example
+ * generatePassword()
+ * generatePassword(16)
+ */
+declare function generatePassword(length?: number): string;
+
+export { generatePassword };

package/dist/password/index.js

@@ -0,0 +1,69 @@
+// src/internal/random.ts
+function getCrypto() {
+  const cryptoApi = globalThis.crypto;
+  if (!cryptoApi?.getRandomValues) {
+    throw new Error("Secure random number generation is not available in this runtime");
+  }
+  return cryptoApi;
+}
+function randomIndex(length) {
+  if (length <= 0) {
+    throw new RangeError("length must be greater than 0");
+  }
+  const cryptoApi = getCrypto();
+  const limit = 4294967296;
+  const unbiasedMax = Math.floor(limit / length) * length;
+  const bytes = new Uint32Array(1);
+  let value = 0;
+  do {
+    cryptoApi.getRandomValues(bytes);
+    value = bytes[0] ?? 0;
+  } while (value >= unbiasedMax);
+  return value % length;
+}
+function pickCharacter(charset) {
+  return charset[randomIndex(charset.length)] ?? charset[0] ?? "A";
+}
+function shuffle(items) {
+  const result = [...items];
+  for (let index = result.length - 1; index > 0; index -= 1) {
+    const swapIndex = randomIndex(index + 1);
+    const current = result[index];
+    const other = result[swapIndex];
+    if (current === void 0 || other === void 0) {
+      continue;
+    }
+    result[index] = other;
+    result[swapIndex] = current;
+  }
+  return result;
+}
+
+// src/password/index.ts
+var UPPERCASE = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
+var LOWERCASE = "abcdefghijklmnopqrstuvwxyz";
+var NUMBERS = "0123456789";
+var SPECIAL = "!@#$%^&*()_+-=[]{}|;:,.<>?";
+var ALL_CHARACTERS = `${UPPERCASE}${LOWERCASE}${NUMBERS}${SPECIAL}`;
+var MIN_PASSWORD_LENGTH = 8;
+var DEFAULT_PASSWORD_LENGTH = 12;
+function generatePassword(length = DEFAULT_PASSWORD_LENGTH) {
+  if (!Number.isInteger(length) || length < MIN_PASSWORD_LENGTH) {
+    throw new RangeError(`length must be an integer greater than or equal to ${MIN_PASSWORD_LENGTH}`);
+  }
+  const required = [
+    pickCharacter(UPPERCASE),
+    pickCharacter(LOWERCASE),
+    pickCharacter(NUMBERS),
+    pickCharacter(SPECIAL)
+  ];
+  const remaining = Array.from(
+    { length: length - required.length },
+    () => pickCharacter(ALL_CHARACTERS)
+  );
+  return shuffle([...required, ...remaining]).join("");
+}
+
+export { generatePassword };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/password/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/internal/random.ts","../../src/password/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["function getCrypto(): Crypto {\r\n  const cryptoApi = globalThis.crypto;\r\n  if (!cryptoApi?.getRandomValues) {\r\n    throw new Error(\"Secure random number generation is not available in this runtime\");\r\n  }\r\n\r\n  return cryptoApi;\r\n}\r\n\r\nexport function randomIndex(length: number): number {\r\n  if (length <= 0) {\r\n    throw new RangeError(\"length must be greater than 0\");\r\n  }\r\n\r\n  const cryptoApi = getCrypto();\r\n  const limit = 0x1_0000_0000;\r\n  const unbiasedMax = Math.floor(limit / length) * length;\r\n  const bytes = new Uint32Array(1);\r\n\r\n  let value = 0;\r\n  do {\r\n    cryptoApi.getRandomValues(bytes);\r\n    value = bytes[0] ?? 0;\r\n  } while (value >= unbiasedMax);\r\n\r\n  return value % length;\r\n}\r\n\r\nexport function pickCharacter(charset: string): string {\r\n  return charset[randomIndex(charset.length)] ?? charset[0] ?? \"A\";\r\n}\r\n\r\nexport function randomString(length: number, charset: string): string {\r\n  return Array.from({ length }, () => pickCharacter(charset)).join(\"\");\r\n}\r\n\r\nexport function shuffle<T>(items: T[]): T[] {\r\n  const result = [...items];\r\n  for (let index = result.length - 1; index > 0; index -= 1) {\r\n    const swapIndex = randomIndex(index + 1);\r\n    const current = result[index];\r\n    const other = result[swapIndex];\r\n    if (current === undefined || other === undefined) {\r\n      continue;\r\n    }\r\n    result[index] = other;\r\n    result[swapIndex] = current;\r\n  }\r\n  return result;\r\n}\r\n","import { pickCharacter, shuffle } from \"../internal/random.js\";\r\n\r\nconst UPPERCASE = \"ABCDEFGHIJKLMNOPQRSTUVWXYZ\";\r\nconst LOWERCASE = \"abcdefghijklmnopqrstuvwxyz\";\r\nconst NUMBERS = \"0123456789\";\r\nconst SPECIAL = \"!@#$%^&*()_+-=[]{}|;:,.<>?\";\r\nconst ALL_CHARACTERS = `${UPPERCASE}${LOWERCASE}${NUMBERS}${SPECIAL}`;\r\nconst MIN_PASSWORD_LENGTH = 8;\r\nconst DEFAULT_PASSWORD_LENGTH = 12;\r\n\r\n/**\r\n * Generates a password with at least one uppercase letter, lowercase letter,\r\n * number, and special character. Uses `crypto.getRandomValues`.\r\n *\r\n * This is not a password-policy engine and does not hash passwords.\r\n *\r\n * @throws {RangeError} When `length` is below 8 or not an integer.\r\n *\r\n * @example\r\n * generatePassword()\r\n * generatePassword(16)\r\n */\r\nexport function generatePassword(length = DEFAULT_PASSWORD_LENGTH): string {\r\n  if (!Number.isInteger(length) || length < MIN_PASSWORD_LENGTH) {\r\n    throw new RangeError(`length must be an integer greater than or equal to ${MIN_PASSWORD_LENGTH}`);\r\n  }\r\n\r\n  const required = [\r\n    pickCharacter(UPPERCASE),\r\n    pickCharacter(LOWERCASE),\r\n    pickCharacter(NUMBERS),\r\n    pickCharacter(SPECIAL),\r\n  ];\r\n\r\n  const remaining = Array.from({ length: length - required.length }, () =>\r\n    pickCharacter(ALL_CHARACTERS),\r\n  );\r\n\r\n  return shuffle([...required, ...remaining]).join(\"\");\r\n}\r\n"]}

package/dist/phone/index.cjs

@@ -0,0 +1,19 @@
+'use strict';
+
+// src/phone/index.ts
+var INDIAN_MOBILE_PATTERN = /^[6-9]\d{9}$/;
+function normalizeMobile(value) {
+  if (value == null) {
+    return null;
+  }
+  const digits = String(value).replace(/\D/g, "");
+  if (digits.length === 0) {
+    return null;
+  }
+  const withoutCountryCode = digits.length > 10 && (digits.startsWith("91") || digits.startsWith("0")) ? digits.slice(-10) : digits.length >= 10 ? digits.slice(-10) : digits;
+  return INDIAN_MOBILE_PATTERN.test(withoutCountryCode) ? withoutCountryCode : null;
+}
+
+exports.normalizeMobile = normalizeMobile;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/phone/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/phone/index.ts"],"names":[],"mappings":";;;AAAA,IAAM,qBAAA,GAAwB,cAAA;AAWvB,SAAS,gBAAgB,KAAA,EAA+B;AAC7D,EAAA,IAAI,SAAS,IAAA,EAAM;AACjB,IAAA,OAAO,IAAA;AAAA,EACT;AAEA,EAAA,MAAM,SAAS,MAAA,CAAO,KAAK,CAAA,CAAE,OAAA,CAAQ,OAAO,EAAE,CAAA;AAC9C,EAAA,IAAI,MAAA,CAAO,WAAW,CAAA,EAAG;AACvB,IAAA,OAAO,IAAA;AAAA,EACT;AAEA,EAAA,MAAM,kBAAA,GACJ,OAAO,MAAA,GAAS,EAAA,KAAO,OAAO,UAAA,CAAW,IAAI,CAAA,IAAK,MAAA,CAAO,UAAA,CAAW,GAAG,KACnE,MAAA,CAAO,KAAA,CAAM,GAAG,CAAA,GAChB,MAAA,CAAO,UAAU,EAAA,GACf,MAAA,CAAO,KAAA,CAAM,GAAG,CAAA,GAChB,MAAA;AAER,EAAA,OAAO,qBAAA,CAAsB,IAAA,CAAK,kBAAkB,CAAA,GAAI,kBAAA,GAAqB,IAAA;AAC/E","file":"index.cjs","sourcesContent":["const INDIAN_MOBILE_PATTERN = /^[6-9]\\d{9}$/;\r\n\r\n/**\r\n * Normalizes an Indian mobile number to 10 digits starting with 6-9.\r\n * Country-code prefixes such as `+91` or `91` are removed when present.\r\n * Returns `null` for empty or invalid numbers.\r\n *\r\n * @example\r\n * normalizeMobile(\"+91 98765 43210\") // \"9876543210\"\r\n * normalizeMobile(\"12345\") // null\r\n */\r\nexport function normalizeMobile(value: unknown): string | null {\r\n  if (value == null) {\r\n    return null;\r\n  }\r\n\r\n  const digits = String(value).replace(/\\D/g, \"\");\r\n  if (digits.length === 0) {\r\n    return null;\r\n  }\r\n\r\n  const withoutCountryCode =\r\n    digits.length > 10 && (digits.startsWith(\"91\") || digits.startsWith(\"0\"))\r\n      ? digits.slice(-10)\r\n      : digits.length >= 10\r\n        ? digits.slice(-10)\r\n        : digits;\r\n\r\n  return INDIAN_MOBILE_PATTERN.test(withoutCountryCode) ? withoutCountryCode : null;\r\n}\r\n"]}

package/dist/phone/index.d.cts

@@ -0,0 +1,12 @@
+/**
+ * Normalizes an Indian mobile number to 10 digits starting with 6-9.
+ * Country-code prefixes such as `+91` or `91` are removed when present.
+ * Returns `null` for empty or invalid numbers.
+ *
+ * @example
+ * normalizeMobile("+91 98765 43210") // "9876543210"
+ * normalizeMobile("12345") // null
+ */
+declare function normalizeMobile(value: unknown): string | null;
+
+export { normalizeMobile };

package/dist/phone/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Normalizes an Indian mobile number to 10 digits starting with 6-9.
+ * Country-code prefixes such as `+91` or `91` are removed when present.
+ * Returns `null` for empty or invalid numbers.
+ *
+ * @example
+ * normalizeMobile("+91 98765 43210") // "9876543210"
+ * normalizeMobile("12345") // null
+ */
+declare function normalizeMobile(value: unknown): string | null;
+
+export { normalizeMobile };

package/dist/phone/index.js

@@ -0,0 +1,17 @@
+// src/phone/index.ts
+var INDIAN_MOBILE_PATTERN = /^[6-9]\d{9}$/;
+function normalizeMobile(value) {
+  if (value == null) {
+    return null;
+  }
+  const digits = String(value).replace(/\D/g, "");
+  if (digits.length === 0) {
+    return null;
+  }
+  const withoutCountryCode = digits.length > 10 && (digits.startsWith("91") || digits.startsWith("0")) ? digits.slice(-10) : digits.length >= 10 ? digits.slice(-10) : digits;
+  return INDIAN_MOBILE_PATTERN.test(withoutCountryCode) ? withoutCountryCode : null;
+}
+
+export { normalizeMobile };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/phone/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/phone/index.ts"],"names":[],"mappings":";AAAA,IAAM,qBAAA,GAAwB,cAAA;AAWvB,SAAS,gBAAgB,KAAA,EAA+B;AAC7D,EAAA,IAAI,SAAS,IAAA,EAAM;AACjB,IAAA,OAAO,IAAA;AAAA,EACT;AAEA,EAAA,MAAM,SAAS,MAAA,CAAO,KAAK,CAAA,CAAE,OAAA,CAAQ,OAAO,EAAE,CAAA;AAC9C,EAAA,IAAI,MAAA,CAAO,WAAW,CAAA,EAAG;AACvB,IAAA,OAAO,IAAA;AAAA,EACT;AAEA,EAAA,MAAM,kBAAA,GACJ,OAAO,MAAA,GAAS,EAAA,KAAO,OAAO,UAAA,CAAW,IAAI,CAAA,IAAK,MAAA,CAAO,UAAA,CAAW,GAAG,KACnE,MAAA,CAAO,KAAA,CAAM,GAAG,CAAA,GAChB,MAAA,CAAO,UAAU,EAAA,GACf,MAAA,CAAO,KAAA,CAAM,GAAG,CAAA,GAChB,MAAA;AAER,EAAA,OAAO,qBAAA,CAAsB,IAAA,CAAK,kBAAkB,CAAA,GAAI,kBAAA,GAAqB,IAAA;AAC/E","file":"index.js","sourcesContent":["const INDIAN_MOBILE_PATTERN = /^[6-9]\\d{9}$/;\r\n\r\n/**\r\n * Normalizes an Indian mobile number to 10 digits starting with 6-9.\r\n * Country-code prefixes such as `+91` or `91` are removed when present.\r\n * Returns `null` for empty or invalid numbers.\r\n *\r\n * @example\r\n * normalizeMobile(\"+91 98765 43210\") // \"9876543210\"\r\n * normalizeMobile(\"12345\") // null\r\n */\r\nexport function normalizeMobile(value: unknown): string | null {\r\n  if (value == null) {\r\n    return null;\r\n  }\r\n\r\n  const digits = String(value).replace(/\\D/g, \"\");\r\n  if (digits.length === 0) {\r\n    return null;\r\n  }\r\n\r\n  const withoutCountryCode =\r\n    digits.length > 10 && (digits.startsWith(\"91\") || digits.startsWith(\"0\"))\r\n      ? digits.slice(-10)\r\n      : digits.length >= 10\r\n        ? digits.slice(-10)\r\n        : digits;\r\n\r\n  return INDIAN_MOBILE_PATTERN.test(withoutCountryCode) ? withoutCountryCode : null;\r\n}\r\n"]}

package/dist/regex/index.cjs

@@ -0,0 +1,73 @@
+'use strict';
+
+// src/internal/validation.ts
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
+// src/regex/index.ts
+var ValidationPatterns = {
+  YEAR: /^\d{4}$/,
+  OTP: /^\d{6}$/,
+  PINCODE: /^\d{6}$/,
+  POSTAL_CODE: /^\d{6}$/,
+  NUMERIC: /^[0-9]+$/,
+  MOBILE: /^[6-9]\d{9}$/,
+  NAME: /^[a-zA-Z\s\-']+$/,
+  ALPHABETIC: /^[a-zA-Z]+$/,
+  LOWERCASE_ONLY: /^[a-z_]+$/,
+  UPPERCASE_ONLY: /^[A-Z_]+$/,
+  USERNAME: /^[a-zA-Z0-9_-]+$/,
+  LOWER_NUMERIC: /^[a-z0-9_]+$/,
+  UPPER_NUMERIC: /^[A-Z0-9_]+$/,
+  LOWER_WITH_HYPHENS: /^[a-z-]+$/,
+  UPPER_WITH_HYPHENS: /^[A-Z-]+$/,
+  ALPHANUMERIC: /^[a-zA-Z0-9-\s]+$/,
+  PERMISSION_NAME: /^[a-z0-9._-]+$/,
+  AADHAR_CARD: /^[2-9][0-9]{11}$/,
+  LOWER_NUMERIC_WITH_HYPHENS: /^[a-z0-9-]+$/,
+  UPPER_NUMERIC_WITH_HYPHENS: /^[A-Z0-9-]+$/,
+  ALPHANUMERIC_WITH_SPACES: /^[a-zA-Z0-9\s]+$/,
+  ALPHANUMERIC_WITHOUT_SPACES: /^[a-zA-Z0-9]+$/,
+  PAN_CARD: /^[A-Za-z]{5}[0-9]{4}[A-Za-z]$/,
+  ALPHANUMERIC_WITH_UNDERSCORES: /^[a-zA-Z0-9-_]+$/,
+  MODEL_NAME: /^[a-zA-Z0-9_\s\-/\\*+()[\]:'",.%&]+$/,
+  NOTE: /^[a-zA-Z0-9\s/\\,.\-_+=<>()[\]{}@#$%^&*~`"',;:’]+$/,
+  EMAIL: /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/,
+  VEHICLE_NUMBER: /^[A-Za-z]{2}\d{1,2}[A-Za-z]{1,3}\d{1,4}$/,
+  PASSWORD: /^(?=.*[a-zA-Z])(?=.*[0-9])(?=.*[@$!%*?&])[a-zA-Z0-9@$!%*?&]{8,16}$/,
+  URL: /^https?:\/\/(?:www\.)?[-a-zA-Z0-9@:%._+~#=]{1,256}\.[a-zA-Z0-9()]{1,6}\b(?:[-a-zA-Z0-9()@:%_+.~#?&/=]*)$/,
+  DATE: /^\d{4}-\d{2}-\d{2}$/,
+  CURRENCY: /^\d+(?:\.\d{1,2})?$/,
+  TIME: /^(?:[01]?\d|2[0-3]):[0-5]\d$/,
+  MESSAGE: /^[a-zA-Z0-9\s.,!?_\-@#()&%$+=:;"'<>[\]{}|\\/]+$/,
+  DOMAIN_HOSTNAME: /^(?=.{1,253}$)(?:localhost|(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z]{2,}|[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?)$/i
+};
+function testPattern(value, pattern) {
+  if (typeof pattern === "string") {
+    const namedPattern = ValidationPatterns[pattern];
+    if (!namedPattern) {
+      throw new TypeError(`Unknown validation pattern: ${pattern}`);
+    }
+    return namedPattern.test(value);
+  }
+  return pattern.test(value);
+}
+function getPattern(name) {
+  const pattern = ValidationPatterns[name];
+  if (!pattern) {
+    throw new TypeError(`Unknown validation pattern: ${name}`);
+  }
+  return pattern;
+}
+function escapeRegex(value) {
+  return escapeRegExp(value);
+}
+
+exports.ValidationPatterns = ValidationPatterns;
+exports.escapeRegExp = escapeRegex;
+exports.escapeRegex = escapeRegex;
+exports.getPattern = getPattern;
+exports.testPattern = testPattern;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/regex/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/internal/validation.ts","../../src/regex/index.ts"],"names":[],"mappings":";;;AASO,SAAS,aAAa,KAAA,EAAuB;AAClD,EAAA,OAAO,KAAA,CAAM,OAAA,CAAQ,qBAAA,EAAuB,MAAM,CAAA;AACpD;;;ACJO,IAAM,kBAAA,GAAqB;AAAA,EAChC,IAAA,EAAM,SAAA;AAAA,EACN,GAAA,EAAK,SAAA;AAAA,EACL,OAAA,EAAS,SAAA;AAAA,EACT,WAAA,EAAa,SAAA;AAAA,EACb,OAAA,EAAS,UAAA;AAAA,EACT,MAAA,EAAQ,cAAA;AAAA,EACR,IAAA,EAAM,kBAAA;AAAA,EACN,UAAA,EAAY,aAAA;AAAA,EACZ,cAAA,EAAgB,WAAA;AAAA,EAChB,cAAA,EAAgB,WAAA;AAAA,EAChB,QAAA,EAAU,kBAAA;AAAA,EACV,aAAA,EAAe,cAAA;AAAA,EACf,aAAA,EAAe,cAAA;AAAA,EACf,kBAAA,EAAoB,WAAA;AAAA,EACpB,kBAAA,EAAoB,WAAA;AAAA,EACpB,YAAA,EAAc,mBAAA;AAAA,EACd,eAAA,EAAiB,gBAAA;AAAA,EACjB,WAAA,EAAa,kBAAA;AAAA,EACb,0BAAA,EAA4B,cAAA;AAAA,EAC5B,0BAAA,EAA4B,cAAA;AAAA,EAC5B,wBAAA,EAA0B,kBAAA;AAAA,EAC1B,2BAAA,EAA6B,gBAAA;AAAA,EAC7B,QAAA,EAAU,+BAAA;AAAA,EACV,6BAAA,EAA+B,kBAAA;AAAA,EAC/B,UAAA,EAAY,sCAAA;AAAA,EACZ,IAAA,EAAM,oDAAA;AAAA,EACN,KAAA,EAAO,kDAAA;AAAA,EACP,cAAA,EAAgB,0CAAA;AAAA,EAChB,QAAA,EAAU,oEAAA;AAAA,EACV,GAAA,EAAK,0GAAA;AAAA,EACL,IAAA,EAAM,qBAAA;AAAA,EACN,QAAA,EAAU,qBAAA;AAAA,EACV,IAAA,EAAM,8BAAA;AAAA,EACN,OAAA,EAAS,iDAAA;AAAA,EACT,eAAA,EACE;AACJ;AAWO,SAAS,WAAA,CACd,OACA,OAAA,EACS;AACT,EAAA,IAAI,OAAO,YAAY,QAAA,EAAU;AAC/B,IAAA,MAAM,YAAA,GAAe,mBAAmB,OAAO,CAAA;AAC/C,IAAA,IAAI,CAAC,YAAA,EAAc;AACjB,MAAA,MAAM,IAAI,SAAA,CAAU,CAAA,4BAAA,EAA+B,OAAO,CAAA,CAAE,CAAA;AAAA,IAC9D;AACA,IAAA,OAAO,YAAA,CAAa,KAAK,KAAK,CAAA;AAAA,EAChC;AAEA,EAAA,OAAO,OAAA,CAAQ,KAAK,KAAK,CAAA;AAC3B;AAQO,SAAS,WAAW,IAAA,EAAqC;AAC9D,EAAA,MAAM,OAAA,GAAU,mBAAmB,IAAI,CAAA;AACvC,EAAA,IAAI,CAAC,OAAA,EAAS;AACZ,IAAA,MAAM,IAAI,SAAA,CAAU,CAAA,4BAAA,EAA+B,IAAI,CAAA,CAAE,CAAA;AAAA,EAC3D;AAEA,EAAA,OAAO,OAAA;AACT;AAKO,SAAS,YAAY,KAAA,EAAuB;AACjD,EAAA,OAAO,aAAa,KAAK,CAAA;AAC3B","file":"index.cjs","sourcesContent":["export function assertFiniteNumber(\r\n  value: unknown,\r\n  name: string,\r\n): asserts value is number {\r\n  if (typeof value !== \"number\" || !Number.isFinite(value)) {\r\n    throw new TypeError(`${name} must be a finite number`);\r\n  }\r\n}\r\n\r\nexport function escapeRegExp(value: string): string {\r\n  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\r\n}\r\n","import { escapeRegExp } from \"../internal/validation.js\";\r\n\r\n/**\r\n * Shared validation regular expressions for Indian and general form fields.\r\n * These patterns check shape only. They do not verify checksums, ownership,\r\n * or whether a value is officially issued.\r\n */\r\nexport const ValidationPatterns = {\r\n  YEAR: /^\\d{4}$/,\r\n  OTP: /^\\d{6}$/,\r\n  PINCODE: /^\\d{6}$/,\r\n  POSTAL_CODE: /^\\d{6}$/,\r\n  NUMERIC: /^[0-9]+$/,\r\n  MOBILE: /^[6-9]\\d{9}$/,\r\n  NAME: /^[a-zA-Z\\s\\-']+$/,\r\n  ALPHABETIC: /^[a-zA-Z]+$/,\r\n  LOWERCASE_ONLY: /^[a-z_]+$/,\r\n  UPPERCASE_ONLY: /^[A-Z_]+$/,\r\n  USERNAME: /^[a-zA-Z0-9_-]+$/,\r\n  LOWER_NUMERIC: /^[a-z0-9_]+$/,\r\n  UPPER_NUMERIC: /^[A-Z0-9_]+$/,\r\n  LOWER_WITH_HYPHENS: /^[a-z-]+$/,\r\n  UPPER_WITH_HYPHENS: /^[A-Z-]+$/,\r\n  ALPHANUMERIC: /^[a-zA-Z0-9-\\s]+$/,\r\n  PERMISSION_NAME: /^[a-z0-9._-]+$/,\r\n  AADHAR_CARD: /^[2-9][0-9]{11}$/,\r\n  LOWER_NUMERIC_WITH_HYPHENS: /^[a-z0-9-]+$/,\r\n  UPPER_NUMERIC_WITH_HYPHENS: /^[A-Z0-9-]+$/,\r\n  ALPHANUMERIC_WITH_SPACES: /^[a-zA-Z0-9\\s]+$/,\r\n  ALPHANUMERIC_WITHOUT_SPACES: /^[a-zA-Z0-9]+$/,\r\n  PAN_CARD: /^[A-Za-z]{5}[0-9]{4}[A-Za-z]$/,\r\n  ALPHANUMERIC_WITH_UNDERSCORES: /^[a-zA-Z0-9-_]+$/,\r\n  MODEL_NAME: /^[a-zA-Z0-9_\\s\\-/\\\\*+()[\\]:'\",.%&]+$/,\r\n  NOTE: /^[a-zA-Z0-9\\s/\\\\,.\\-_+=<>()[\\]{}@#$%^&*~`\"',;:’]+$/,\r\n  EMAIL: /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$/,\r\n  VEHICLE_NUMBER: /^[A-Za-z]{2}\\d{1,2}[A-Za-z]{1,3}\\d{1,4}$/,\r\n  PASSWORD: /^(?=.*[a-zA-Z])(?=.*[0-9])(?=.*[@$!%*?&])[a-zA-Z0-9@$!%*?&]{8,16}$/,\r\n  URL: /^https?:\\/\\/(?:www\\.)?[-a-zA-Z0-9@:%._+~#=]{1,256}\\.[a-zA-Z0-9()]{1,6}\\b(?:[-a-zA-Z0-9()@:%_+.~#?&/=]*)$/,\r\n  DATE: /^\\d{4}-\\d{2}-\\d{2}$/,\r\n  CURRENCY: /^\\d+(?:\\.\\d{1,2})?$/,\r\n  TIME: /^(?:[01]?\\d|2[0-3]):[0-5]\\d$/,\r\n  MESSAGE: /^[a-zA-Z0-9\\s.,!?_\\-@#()&%$+=:;\"'<>[\\]{}|\\\\/]+$/,\r\n  DOMAIN_HOSTNAME:\r\n    /^(?=.{1,253}$)(?:localhost|(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)+[a-z]{2,}|[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?)$/i,\r\n} as const;\r\n\r\nexport type ValidationPatternName = keyof typeof ValidationPatterns;\r\n\r\n/**\r\n * Tests a string against a named validation pattern or a custom regular expression.\r\n *\r\n * @example\r\n * testPattern(\"9876543210\", \"MOBILE\") // true\r\n * testPattern(\"user@example.com\", ValidationPatterns.EMAIL) // true\r\n */\r\nexport function testPattern(\r\n  value: string,\r\n  pattern: ValidationPatternName | RegExp,\r\n): boolean {\r\n  if (typeof pattern === \"string\") {\r\n    const namedPattern = ValidationPatterns[pattern];\r\n    if (!namedPattern) {\r\n      throw new TypeError(`Unknown validation pattern: ${pattern}`);\r\n    }\r\n    return namedPattern.test(value);\r\n  }\r\n\r\n  return pattern.test(value);\r\n}\r\n\r\n/**\r\n * Returns a named validation pattern.\r\n *\r\n * @example\r\n * getPattern(\"PINCODE\") // /^\\d{6}$/\r\n */\r\nexport function getPattern(name: ValidationPatternName): RegExp {\r\n  const pattern = ValidationPatterns[name];\r\n  if (!pattern) {\r\n    throw new TypeError(`Unknown validation pattern: ${name}`);\r\n  }\r\n\r\n  return pattern;\r\n}\r\n\r\n/**\r\n * Escapes special regular-expression characters in a string.\r\n */\r\nexport function escapeRegex(value: string): string {\r\n  return escapeRegExp(value);\r\n}\r\n\r\nexport { escapeRegex as escapeRegExp };\r\n"]}

package/dist/regex/index.d.cts

@@ -0,0 +1,65 @@
+/**
+ * Shared validation regular expressions for Indian and general form fields.
+ * These patterns check shape only. They do not verify checksums, ownership,
+ * or whether a value is officially issued.
+ */
+declare const ValidationPatterns: {
+    readonly YEAR: RegExp;
+    readonly OTP: RegExp;
+    readonly PINCODE: RegExp;
+    readonly POSTAL_CODE: RegExp;
+    readonly NUMERIC: RegExp;
+    readonly MOBILE: RegExp;
+    readonly NAME: RegExp;
+    readonly ALPHABETIC: RegExp;
+    readonly LOWERCASE_ONLY: RegExp;
+    readonly UPPERCASE_ONLY: RegExp;
+    readonly USERNAME: RegExp;
+    readonly LOWER_NUMERIC: RegExp;
+    readonly UPPER_NUMERIC: RegExp;
+    readonly LOWER_WITH_HYPHENS: RegExp;
+    readonly UPPER_WITH_HYPHENS: RegExp;
+    readonly ALPHANUMERIC: RegExp;
+    readonly PERMISSION_NAME: RegExp;
+    readonly AADHAR_CARD: RegExp;
+    readonly LOWER_NUMERIC_WITH_HYPHENS: RegExp;
+    readonly UPPER_NUMERIC_WITH_HYPHENS: RegExp;
+    readonly ALPHANUMERIC_WITH_SPACES: RegExp;
+    readonly ALPHANUMERIC_WITHOUT_SPACES: RegExp;
+    readonly PAN_CARD: RegExp;
+    readonly ALPHANUMERIC_WITH_UNDERSCORES: RegExp;
+    readonly MODEL_NAME: RegExp;
+    readonly NOTE: RegExp;
+    readonly EMAIL: RegExp;
+    readonly VEHICLE_NUMBER: RegExp;
+    readonly PASSWORD: RegExp;
+    readonly URL: RegExp;
+    readonly DATE: RegExp;
+    readonly CURRENCY: RegExp;
+    readonly TIME: RegExp;
+    readonly MESSAGE: RegExp;
+    readonly DOMAIN_HOSTNAME: RegExp;
+};
+type ValidationPatternName = keyof typeof ValidationPatterns;
+/**
+ * Tests a string against a named validation pattern or a custom regular expression.
+ *
+ * @example
+ * testPattern("9876543210", "MOBILE") // true
+ * testPattern("user@example.com", ValidationPatterns.EMAIL) // true
+ */
+declare function testPattern(value: string, pattern: ValidationPatternName | RegExp): boolean;
+/**
+ * Returns a named validation pattern.
+ *
+ * @example
+ * getPattern("PINCODE") // /^\d{6}$/
+ */
+declare function getPattern(name: ValidationPatternName): RegExp;
+/**
+ * Escapes special regular-expression characters in a string.
+ */
+declare function escapeRegex(value: string): string;
+
+export { ValidationPatterns, escapeRegex as escapeRegExp, escapeRegex, getPattern, testPattern };
+export type { ValidationPatternName };

package/dist/regex/index.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Shared validation regular expressions for Indian and general form fields.
+ * These patterns check shape only. They do not verify checksums, ownership,
+ * or whether a value is officially issued.
+ */
+declare const ValidationPatterns: {
+    readonly YEAR: RegExp;
+    readonly OTP: RegExp;
+    readonly PINCODE: RegExp;
+    readonly POSTAL_CODE: RegExp;
+    readonly NUMERIC: RegExp;
+    readonly MOBILE: RegExp;
+    readonly NAME: RegExp;
+    readonly ALPHABETIC: RegExp;
+    readonly LOWERCASE_ONLY: RegExp;
+    readonly UPPERCASE_ONLY: RegExp;
+    readonly USERNAME: RegExp;
+    readonly LOWER_NUMERIC: RegExp;
+    readonly UPPER_NUMERIC: RegExp;
+    readonly LOWER_WITH_HYPHENS: RegExp;
+    readonly UPPER_WITH_HYPHENS: RegExp;
+    readonly ALPHANUMERIC: RegExp;
+    readonly PERMISSION_NAME: RegExp;
+    readonly AADHAR_CARD: RegExp;
+    readonly LOWER_NUMERIC_WITH_HYPHENS: RegExp;
+    readonly UPPER_NUMERIC_WITH_HYPHENS: RegExp;
+    readonly ALPHANUMERIC_WITH_SPACES: RegExp;
+    readonly ALPHANUMERIC_WITHOUT_SPACES: RegExp;
+    readonly PAN_CARD: RegExp;
+    readonly ALPHANUMERIC_WITH_UNDERSCORES: RegExp;
+    readonly MODEL_NAME: RegExp;
+    readonly NOTE: RegExp;
+    readonly EMAIL: RegExp;
+    readonly VEHICLE_NUMBER: RegExp;
+    readonly PASSWORD: RegExp;
+    readonly URL: RegExp;
+    readonly DATE: RegExp;
+    readonly CURRENCY: RegExp;
+    readonly TIME: RegExp;
+    readonly MESSAGE: RegExp;
+    readonly DOMAIN_HOSTNAME: RegExp;
+};
+type ValidationPatternName = keyof typeof ValidationPatterns;
+/**
+ * Tests a string against a named validation pattern or a custom regular expression.
+ *
+ * @example
+ * testPattern("9876543210", "MOBILE") // true
+ * testPattern("user@example.com", ValidationPatterns.EMAIL) // true
+ */
+declare function testPattern(value: string, pattern: ValidationPatternName | RegExp): boolean;
+/**
+ * Returns a named validation pattern.
+ *
+ * @example
+ * getPattern("PINCODE") // /^\d{6}$/
+ */
+declare function getPattern(name: ValidationPatternName): RegExp;
+/**
+ * Escapes special regular-expression characters in a string.
+ */
+declare function escapeRegex(value: string): string;
+
+export { ValidationPatterns, escapeRegex as escapeRegExp, escapeRegex, getPattern, testPattern };
+export type { ValidationPatternName };

package/dist/regex/index.js

@@ -0,0 +1,67 @@
+// src/internal/validation.ts
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
+// src/regex/index.ts
+var ValidationPatterns = {
+  YEAR: /^\d{4}$/,
+  OTP: /^\d{6}$/,
+  PINCODE: /^\d{6}$/,
+  POSTAL_CODE: /^\d{6}$/,
+  NUMERIC: /^[0-9]+$/,
+  MOBILE: /^[6-9]\d{9}$/,
+  NAME: /^[a-zA-Z\s\-']+$/,
+  ALPHABETIC: /^[a-zA-Z]+$/,
+  LOWERCASE_ONLY: /^[a-z_]+$/,
+  UPPERCASE_ONLY: /^[A-Z_]+$/,
+  USERNAME: /^[a-zA-Z0-9_-]+$/,
+  LOWER_NUMERIC: /^[a-z0-9_]+$/,
+  UPPER_NUMERIC: /^[A-Z0-9_]+$/,
+  LOWER_WITH_HYPHENS: /^[a-z-]+$/,
+  UPPER_WITH_HYPHENS: /^[A-Z-]+$/,
+  ALPHANUMERIC: /^[a-zA-Z0-9-\s]+$/,
+  PERMISSION_NAME: /^[a-z0-9._-]+$/,
+  AADHAR_CARD: /^[2-9][0-9]{11}$/,
+  LOWER_NUMERIC_WITH_HYPHENS: /^[a-z0-9-]+$/,
+  UPPER_NUMERIC_WITH_HYPHENS: /^[A-Z0-9-]+$/,
+  ALPHANUMERIC_WITH_SPACES: /^[a-zA-Z0-9\s]+$/,
+  ALPHANUMERIC_WITHOUT_SPACES: /^[a-zA-Z0-9]+$/,
+  PAN_CARD: /^[A-Za-z]{5}[0-9]{4}[A-Za-z]$/,
+  ALPHANUMERIC_WITH_UNDERSCORES: /^[a-zA-Z0-9-_]+$/,
+  MODEL_NAME: /^[a-zA-Z0-9_\s\-/\\*+()[\]:'",.%&]+$/,
+  NOTE: /^[a-zA-Z0-9\s/\\,.\-_+=<>()[\]{}@#$%^&*~`"',;:’]+$/,
+  EMAIL: /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/,
+  VEHICLE_NUMBER: /^[A-Za-z]{2}\d{1,2}[A-Za-z]{1,3}\d{1,4}$/,
+  PASSWORD: /^(?=.*[a-zA-Z])(?=.*[0-9])(?=.*[@$!%*?&])[a-zA-Z0-9@$!%*?&]{8,16}$/,
+  URL: /^https?:\/\/(?:www\.)?[-a-zA-Z0-9@:%._+~#=]{1,256}\.[a-zA-Z0-9()]{1,6}\b(?:[-a-zA-Z0-9()@:%_+.~#?&/=]*)$/,
+  DATE: /^\d{4}-\d{2}-\d{2}$/,
+  CURRENCY: /^\d+(?:\.\d{1,2})?$/,
+  TIME: /^(?:[01]?\d|2[0-3]):[0-5]\d$/,
+  MESSAGE: /^[a-zA-Z0-9\s.,!?_\-@#()&%$+=:;"'<>[\]{}|\\/]+$/,
+  DOMAIN_HOSTNAME: /^(?=.{1,253}$)(?:localhost|(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z]{2,}|[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?)$/i
+};
+function testPattern(value, pattern) {
+  if (typeof pattern === "string") {
+    const namedPattern = ValidationPatterns[pattern];
+    if (!namedPattern) {
+      throw new TypeError(`Unknown validation pattern: ${pattern}`);
+    }
+    return namedPattern.test(value);
+  }
+  return pattern.test(value);
+}
+function getPattern(name) {
+  const pattern = ValidationPatterns[name];
+  if (!pattern) {
+    throw new TypeError(`Unknown validation pattern: ${name}`);
+  }
+  return pattern;
+}
+function escapeRegex(value) {
+  return escapeRegExp(value);
+}
+
+export { ValidationPatterns, escapeRegex as escapeRegExp, escapeRegex, getPattern, testPattern };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/regex/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/internal/validation.ts","../../src/regex/index.ts"],"names":[],"mappings":";AASO,SAAS,aAAa,KAAA,EAAuB;AAClD,EAAA,OAAO,KAAA,CAAM,OAAA,CAAQ,qBAAA,EAAuB,MAAM,CAAA;AACpD;;;ACJO,IAAM,kBAAA,GAAqB;AAAA,EAChC,IAAA,EAAM,SAAA;AAAA,EACN,GAAA,EAAK,SAAA;AAAA,EACL,OAAA,EAAS,SAAA;AAAA,EACT,WAAA,EAAa,SAAA;AAAA,EACb,OAAA,EAAS,UAAA;AAAA,EACT,MAAA,EAAQ,cAAA;AAAA,EACR,IAAA,EAAM,kBAAA;AAAA,EACN,UAAA,EAAY,aAAA;AAAA,EACZ,cAAA,EAAgB,WAAA;AAAA,EAChB,cAAA,EAAgB,WAAA;AAAA,EAChB,QAAA,EAAU,kBAAA;AAAA,EACV,aAAA,EAAe,cAAA;AAAA,EACf,aAAA,EAAe,cAAA;AAAA,EACf,kBAAA,EAAoB,WAAA;AAAA,EACpB,kBAAA,EAAoB,WAAA;AAAA,EACpB,YAAA,EAAc,mBAAA;AAAA,EACd,eAAA,EAAiB,gBAAA;AAAA,EACjB,WAAA,EAAa,kBAAA;AAAA,EACb,0BAAA,EAA4B,cAAA;AAAA,EAC5B,0BAAA,EAA4B,cAAA;AAAA,EAC5B,wBAAA,EAA0B,kBAAA;AAAA,EAC1B,2BAAA,EAA6B,gBAAA;AAAA,EAC7B,QAAA,EAAU,+BAAA;AAAA,EACV,6BAAA,EAA+B,kBAAA;AAAA,EAC/B,UAAA,EAAY,sCAAA;AAAA,EACZ,IAAA,EAAM,oDAAA;AAAA,EACN,KAAA,EAAO,kDAAA;AAAA,EACP,cAAA,EAAgB,0CAAA;AAAA,EAChB,QAAA,EAAU,oEAAA;AAAA,EACV,GAAA,EAAK,0GAAA;AAAA,EACL,IAAA,EAAM,qBAAA;AAAA,EACN,QAAA,EAAU,qBAAA;AAAA,EACV,IAAA,EAAM,8BAAA;AAAA,EACN,OAAA,EAAS,iDAAA;AAAA,EACT,eAAA,EACE;AACJ;AAWO,SAAS,WAAA,CACd,OACA,OAAA,EACS;AACT,EAAA,IAAI,OAAO,YAAY,QAAA,EAAU;AAC/B,IAAA,MAAM,YAAA,GAAe,mBAAmB,OAAO,CAAA;AAC/C,IAAA,IAAI,CAAC,YAAA,EAAc;AACjB,MAAA,MAAM,IAAI,SAAA,CAAU,CAAA,4BAAA,EAA+B,OAAO,CAAA,CAAE,CAAA;AAAA,IAC9D;AACA,IAAA,OAAO,YAAA,CAAa,KAAK,KAAK,CAAA;AAAA,EAChC;AAEA,EAAA,OAAO,OAAA,CAAQ,KAAK,KAAK,CAAA;AAC3B;AAQO,SAAS,WAAW,IAAA,EAAqC;AAC9D,EAAA,MAAM,OAAA,GAAU,mBAAmB,IAAI,CAAA;AACvC,EAAA,IAAI,CAAC,OAAA,EAAS;AACZ,IAAA,MAAM,IAAI,SAAA,CAAU,CAAA,4BAAA,EAA+B,IAAI,CAAA,CAAE,CAAA;AAAA,EAC3D;AAEA,EAAA,OAAO,OAAA;AACT;AAKO,SAAS,YAAY,KAAA,EAAuB;AACjD,EAAA,OAAO,aAAa,KAAK,CAAA;AAC3B","file":"index.js","sourcesContent":["export function assertFiniteNumber(\r\n  value: unknown,\r\n  name: string,\r\n): asserts value is number {\r\n  if (typeof value !== \"number\" || !Number.isFinite(value)) {\r\n    throw new TypeError(`${name} must be a finite number`);\r\n  }\r\n}\r\n\r\nexport function escapeRegExp(value: string): string {\r\n  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\r\n}\r\n","import { escapeRegExp } from \"../internal/validation.js\";\r\n\r\n/**\r\n * Shared validation regular expressions for Indian and general form fields.\r\n * These patterns check shape only. They do not verify checksums, ownership,\r\n * or whether a value is officially issued.\r\n */\r\nexport const ValidationPatterns = {\r\n  YEAR: /^\\d{4}$/,\r\n  OTP: /^\\d{6}$/,\r\n  PINCODE: /^\\d{6}$/,\r\n  POSTAL_CODE: /^\\d{6}$/,\r\n  NUMERIC: /^[0-9]+$/,\r\n  MOBILE: /^[6-9]\\d{9}$/,\r\n  NAME: /^[a-zA-Z\\s\\-']+$/,\r\n  ALPHABETIC: /^[a-zA-Z]+$/,\r\n  LOWERCASE_ONLY: /^[a-z_]+$/,\r\n  UPPERCASE_ONLY: /^[A-Z_]+$/,\r\n  USERNAME: /^[a-zA-Z0-9_-]+$/,\r\n  LOWER_NUMERIC: /^[a-z0-9_]+$/,\r\n  UPPER_NUMERIC: /^[A-Z0-9_]+$/,\r\n  LOWER_WITH_HYPHENS: /^[a-z-]+$/,\r\n  UPPER_WITH_HYPHENS: /^[A-Z-]+$/,\r\n  ALPHANUMERIC: /^[a-zA-Z0-9-\\s]+$/,\r\n  PERMISSION_NAME: /^[a-z0-9._-]+$/,\r\n  AADHAR_CARD: /^[2-9][0-9]{11}$/,\r\n  LOWER_NUMERIC_WITH_HYPHENS: /^[a-z0-9-]+$/,\r\n  UPPER_NUMERIC_WITH_HYPHENS: /^[A-Z0-9-]+$/,\r\n  ALPHANUMERIC_WITH_SPACES: /^[a-zA-Z0-9\\s]+$/,\r\n  ALPHANUMERIC_WITHOUT_SPACES: /^[a-zA-Z0-9]+$/,\r\n  PAN_CARD: /^[A-Za-z]{5}[0-9]{4}[A-Za-z]$/,\r\n  ALPHANUMERIC_WITH_UNDERSCORES: /^[a-zA-Z0-9-_]+$/,\r\n  MODEL_NAME: /^[a-zA-Z0-9_\\s\\-/\\\\*+()[\\]:'\",.%&]+$/,\r\n  NOTE: /^[a-zA-Z0-9\\s/\\\\,.\\-_+=<>()[\\]{}@#$%^&*~`\"',;:’]+$/,\r\n  EMAIL: /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$/,\r\n  VEHICLE_NUMBER: /^[A-Za-z]{2}\\d{1,2}[A-Za-z]{1,3}\\d{1,4}$/,\r\n  PASSWORD: /^(?=.*[a-zA-Z])(?=.*[0-9])(?=.*[@$!%*?&])[a-zA-Z0-9@$!%*?&]{8,16}$/,\r\n  URL: /^https?:\\/\\/(?:www\\.)?[-a-zA-Z0-9@:%._+~#=]{1,256}\\.[a-zA-Z0-9()]{1,6}\\b(?:[-a-zA-Z0-9()@:%_+.~#?&/=]*)$/,\r\n  DATE: /^\\d{4}-\\d{2}-\\d{2}$/,\r\n  CURRENCY: /^\\d+(?:\\.\\d{1,2})?$/,\r\n  TIME: /^(?:[01]?\\d|2[0-3]):[0-5]\\d$/,\r\n  MESSAGE: /^[a-zA-Z0-9\\s.,!?_\\-@#()&%$+=:;\"'<>[\\]{}|\\\\/]+$/,\r\n  DOMAIN_HOSTNAME:\r\n    /^(?=.{1,253}$)(?:localhost|(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)+[a-z]{2,}|[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?)$/i,\r\n} as const;\r\n\r\nexport type ValidationPatternName = keyof typeof ValidationPatterns;\r\n\r\n/**\r\n * Tests a string against a named validation pattern or a custom regular expression.\r\n *\r\n * @example\r\n * testPattern(\"9876543210\", \"MOBILE\") // true\r\n * testPattern(\"user@example.com\", ValidationPatterns.EMAIL) // true\r\n */\r\nexport function testPattern(\r\n  value: string,\r\n  pattern: ValidationPatternName | RegExp,\r\n): boolean {\r\n  if (typeof pattern === \"string\") {\r\n    const namedPattern = ValidationPatterns[pattern];\r\n    if (!namedPattern) {\r\n      throw new TypeError(`Unknown validation pattern: ${pattern}`);\r\n    }\r\n    return namedPattern.test(value);\r\n  }\r\n\r\n  return pattern.test(value);\r\n}\r\n\r\n/**\r\n * Returns a named validation pattern.\r\n *\r\n * @example\r\n * getPattern(\"PINCODE\") // /^\\d{6}$/\r\n */\r\nexport function getPattern(name: ValidationPatternName): RegExp {\r\n  const pattern = ValidationPatterns[name];\r\n  if (!pattern) {\r\n    throw new TypeError(`Unknown validation pattern: ${name}`);\r\n  }\r\n\r\n  return pattern;\r\n}\r\n\r\n/**\r\n * Escapes special regular-expression characters in a string.\r\n */\r\nexport function escapeRegex(value: string): string {\r\n  return escapeRegExp(value);\r\n}\r\n\r\nexport { escapeRegex as escapeRegExp };\r\n"]}

package/dist/response/index.cjs

@@ -0,0 +1,43 @@
+'use strict';
+
+// src/response/index.ts
+function createSuccessResponse(options = {}) {
+  const response = { success: true };
+  if (options.message) {
+    response.message = options.message;
+  }
+  if (options.data !== void 0) {
+    response.data = options.data;
+  }
+  if (options.meta !== void 0) {
+    response.meta = options.meta;
+  }
+  if (options.requestId) {
+    response.request_id = options.requestId;
+  }
+  return response;
+}
+function createErrorResponse(options = {}) {
+  const response = { success: false };
+  if (options.message) {
+    response.message = options.message;
+  }
+  if (options.code !== void 0) {
+    response.code = options.code;
+  }
+  if (options.errors !== void 0) {
+    response.errors = options.errors;
+  }
+  if (options.details !== void 0) {
+    response.details = options.details;
+  }
+  if (options.requestId) {
+    response.request_id = options.requestId;
+  }
+  return response;
+}
+
+exports.createErrorResponse = createErrorResponse;
+exports.createSuccessResponse = createSuccessResponse;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/response/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/response/index.ts"],"names":[],"mappings":";;;AAoCO,SAAS,qBAAA,CACd,OAAA,GAA2C,EAAC,EACxB;AACpB,EAAA,MAAM,QAAA,GAA+B,EAAE,OAAA,EAAS,IAAA,EAAK;AAErD,EAAA,IAAI,QAAQ,OAAA,EAAS;AACnB,IAAA,QAAA,CAAS,UAAU,OAAA,CAAQ,OAAA;AAAA,EAC7B;AACA,EAAA,IAAI,OAAA,CAAQ,SAAS,MAAA,EAAW;AAC9B,IAAA,QAAA,CAAS,OAAO,OAAA,CAAQ,IAAA;AAAA,EAC1B;AACA,EAAA,IAAI,OAAA,CAAQ,SAAS,MAAA,EAAW;AAC9B,IAAA,QAAA,CAAS,OAAO,OAAA,CAAQ,IAAA;AAAA,EAC1B;AACA,EAAA,IAAI,QAAQ,SAAA,EAAW;AACrB,IAAA,QAAA,CAAS,aAAa,OAAA,CAAQ,SAAA;AAAA,EAChC;AAEA,EAAA,OAAO,QAAA;AACT;AAMO,SAAS,mBAAA,CAAoB,OAAA,GAAsC,EAAC,EAAkB;AAC3F,EAAA,MAAM,QAAA,GAA0B,EAAE,OAAA,EAAS,KAAA,EAAM;AAEjD,EAAA,IAAI,QAAQ,OAAA,EAAS;AACnB,IAAA,QAAA,CAAS,UAAU,OAAA,CAAQ,OAAA;AAAA,EAC7B;AACA,EAAA,IAAI,OAAA,CAAQ,SAAS,MAAA,EAAW;AAC9B,IAAA,QAAA,CAAS,OAAO,OAAA,CAAQ,IAAA;AAAA,EAC1B;AACA,EAAA,IAAI,OAAA,CAAQ,WAAW,MAAA,EAAW;AAChC,IAAA,QAAA,CAAS,SAAS,OAAA,CAAQ,MAAA;AAAA,EAC5B;AACA,EAAA,IAAI,OAAA,CAAQ,YAAY,MAAA,EAAW;AACjC,IAAA,QAAA,CAAS,UAAU,OAAA,CAAQ,OAAA;AAAA,EAC7B;AACA,EAAA,IAAI,QAAQ,SAAA,EAAW;AACrB,IAAA,QAAA,CAAS,aAAa,OAAA,CAAQ,SAAA;AAAA,EAChC;AAEA,EAAA,OAAO,QAAA;AACT","file":"index.cjs","sourcesContent":["export interface SuccessResponse<T = unknown> {\r\n  success: true;\r\n  message?: string;\r\n  data?: T;\r\n  meta?: unknown;\r\n  request_id?: string;\r\n}\r\n\r\nexport interface ErrorResponse {\r\n  success: false;\r\n  message?: string;\r\n  code?: string | number;\r\n  errors?: unknown;\r\n  details?: unknown;\r\n  request_id?: string;\r\n}\r\n\r\nexport interface CreateSuccessResponseOptions<T> {\r\n  data?: T;\r\n  message?: string;\r\n  meta?: unknown;\r\n  requestId?: string;\r\n}\r\n\r\nexport interface CreateErrorResponseOptions {\r\n  message?: string;\r\n  code?: string | number;\r\n  errors?: unknown;\r\n  details?: unknown;\r\n  requestId?: string;\r\n}\r\n\r\n/**\r\n * Builds a framework-independent success payload.\r\n * This does not write HTTP headers or call Express `res.json`.\r\n */\r\nexport function createSuccessResponse<T>(\r\n  options: CreateSuccessResponseOptions<T> = {},\r\n): SuccessResponse<T> {\r\n  const response: SuccessResponse<T> = { success: true };\r\n\r\n  if (options.message) {\r\n    response.message = options.message;\r\n  }\r\n  if (options.data !== undefined) {\r\n    response.data = options.data;\r\n  }\r\n  if (options.meta !== undefined) {\r\n    response.meta = options.meta;\r\n  }\r\n  if (options.requestId) {\r\n    response.request_id = options.requestId;\r\n  }\r\n\r\n  return response;\r\n}\r\n\r\n/**\r\n * Builds a framework-independent error payload.\r\n * This does not write HTTP headers or call Express `res.json`.\r\n */\r\nexport function createErrorResponse(options: CreateErrorResponseOptions = {}): ErrorResponse {\r\n  const response: ErrorResponse = { success: false };\r\n\r\n  if (options.message) {\r\n    response.message = options.message;\r\n  }\r\n  if (options.code !== undefined) {\r\n    response.code = options.code;\r\n  }\r\n  if (options.errors !== undefined) {\r\n    response.errors = options.errors;\r\n  }\r\n  if (options.details !== undefined) {\r\n    response.details = options.details;\r\n  }\r\n  if (options.requestId) {\r\n    response.request_id = options.requestId;\r\n  }\r\n\r\n  return response;\r\n}\r\n"]}