@sudobility/types 1.9.52 → 1.9.54

package/dist/utils/validation/type-validation.cjs

@@ -8,7 +8,21 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseJson = exports.createAssertion = exports.isUrl = exports.isEmail = exports.isValidDate = exports.isErrorResponse = exports.isSuccessResponse = exports.isApiResponse = exports.optional = exports.validateArray = exports.hasRequiredProperties = exports.isNullish = exports.isArray = exports.isObject = exports.isBoolean = exports.isNumber = exports.isString = exports.createValidator = void 0;
 /**
- * Creates a validation function that safely checks if a value matches expected type
+ * Creates a validation function that safely checks if a value matches
+ * the expected type. Returns a {@link ValidationResult}.
+ *
+ * @template T - The validated type
+ * @param validationFn - Type guard function
+ * @param typeName - Name used in error messages
+ * @returns A function returning `ValidationResult<T>`
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const validateString = createValidator(isString, 'string');
+ * validateString('hi');  // { isValid: true, data: 'hi' }
+ * validateString(42);    // { isValid: false, error: 'Invalid string' }
+ * ```
  */
 const createValidator = (validationFn, typeName) => {
     return (data) => {
@@ -29,22 +43,49 @@ const createValidator = (validationFn, typeName) => {
 };
 exports.createValidator = createValidator;
 /**
- * Basic type validators
+ * Runtime type guard: checks if value is a `string`.
+ * @since 1.0.0
  */
 const isString = (value) => typeof value === 'string';
 exports.isString = isString;
+/**
+ * Runtime type guard: checks if value is a finite `number` (excludes NaN).
+ * @since 1.0.0
+ */
 const isNumber = (value) => typeof value === 'number' && !isNaN(value);
 exports.isNumber = isNumber;
+/**
+ * Runtime type guard: checks if value is a `boolean`.
+ * @since 1.0.0
+ */
 const isBoolean = (value) => typeof value === 'boolean';
 exports.isBoolean = isBoolean;
+/**
+ * Runtime type guard: checks if value is a non-null, non-array object.
+ * @since 1.0.0
+ */
 const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
 exports.isObject = isObject;
+/**
+ * Runtime type guard: checks if value is an array.
+ * @since 1.0.0
+ */
 const isArray = (value) => Array.isArray(value);
 exports.isArray = isArray;
+/**
+ * Runtime type guard: checks if value is `null` or `undefined`.
+ * @since 1.0.0
+ */
 const isNullish = (value) => value === null || value === undefined;
 exports.isNullish = isNullish;
 /**
- * Validates that an object has required properties
+ * Validates that an object has all required properties present.
+ *
+ * @template T - Expected object shape
+ * @param obj - Value to check
+ * @param requiredProps - Array of required property keys
+ * @returns True if obj has all required properties
+ * @since 1.0.0
  */
 const hasRequiredProperties = (obj, requiredProps) => {
     if (!(0, exports.isObject)(obj))
@@ -53,7 +94,13 @@ const hasRequiredProperties = (obj, requiredProps) => {
 };
 exports.hasRequiredProperties = hasRequiredProperties;
 /**
- * Validates array of objects with a validator function
+ * Validates that a value is an array where every item passes a validator.
+ *
+ * @template T - Expected item type
+ * @param data - Value to check
+ * @param itemValidator - Type guard for individual items
+ * @returns True if data is an array of T
+ * @since 1.0.0
  */
 const validateArray = (data, itemValidator) => {
     if (!(0, exports.isArray)(data))
@@ -62,14 +109,20 @@ const validateArray = (data, itemValidator) => {
 };
 exports.validateArray = validateArray;
 /**
- * Creates optional property validator
+ * Wraps a validator to also accept `undefined`.
+ *
+ * @template T - The validated type
+ * @param validator - Base type guard
+ * @returns Type guard that also accepts `undefined`
+ * @since 1.0.0
  */
 const optional = (validator) => (value) => {
     return value === undefined || validator(value);
 };
 exports.optional = optional;
 /**
- * Common pattern validators for API responses
+ * Check if data looks like an API response (has `success` boolean).
+ * @since 1.0.0
  */
 const isApiResponse = (data) => {
     return (0, exports.isObject)(data) && (0, exports.isBoolean)(data.success);
@@ -92,7 +145,8 @@ const isErrorResponse = (data) => {
 };
 exports.isErrorResponse = isErrorResponse;
 /**
- * Date validation
+ * Check if a value is a string that parses to a valid date.
+ * @since 1.0.0
  */
 const isValidDate = (value) => {
     if (!(0, exports.isString)(value))
@@ -102,7 +156,8 @@ const isValidDate = (value) => {
 };
 exports.isValidDate = isValidDate;
 /**
- * Email validation (basic)
+ * Basic email format validation.
+ * @since 1.0.0
  */
 const isEmail = (value) => {
     if (!(0, exports.isString)(value))
@@ -112,7 +167,8 @@ const isEmail = (value) => {
 };
 exports.isEmail = isEmail;
 /**
- * URL validation (basic)
+ * Basic URL validation using the `URL` constructor.
+ * @since 1.0.0
  */
 const isUrl = (value) => {
     if (!(0, exports.isString)(value))
@@ -127,7 +183,21 @@ const isUrl = (value) => {
 };
 exports.isUrl = isUrl;
 /**
- * Creates a type assertion function that throws on invalid data
+ * Creates a type assertion function that throws `TypeError` on
+ * invalid data. Use with `createValidator` for the non-throwing variant.
+ *
+ * @template T - The asserted type
+ * @param validator - Type guard function
+ * @param typeName - Name used in error messages
+ * @returns An assertion function
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const assertString = createAssertion(isString, 'string');
+ * assertString('hello'); // passes
+ * assertString(42);      // throws TypeError
+ * ```
  */
 const createAssertion = (validator, typeName) => {
     return (data, context = typeName) => {
@@ -138,7 +208,20 @@ const createAssertion = (validator, typeName) => {
 };
 exports.createAssertion = createAssertion;
 /**
- * Safe JSON parsing with validation
+ * Safely parse a JSON string, optionally validating the result.
+ * Returns a {@link ValidationResult} instead of throwing.
+ *
+ * @template T - Expected parsed type
+ * @param jsonString - JSON string to parse
+ * @param validator - Optional type guard to validate the parsed result
+ * @returns Validation result with parsed data or error
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const result = parseJson('{"name":"Alice"}');
+ * if (result.isValid) console.log(result.data);
+ * ```
  */
 const parseJson = (jsonString, validator) => {
     try {

package/dist/utils/validation/type-validation.d.ts

@@ -7,32 +7,85 @@
 import type { ValidationResult, Optional } from '../../types/common';
 export type { ValidationResult };
 /**
- * Creates a validation function that safely checks if a value matches expected type
+ * Creates a validation function that safely checks if a value matches
+ * the expected type. Returns a {@link ValidationResult}.
+ *
+ * @template T - The validated type
+ * @param validationFn - Type guard function
+ * @param typeName - Name used in error messages
+ * @returns A function returning `ValidationResult<T>`
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const validateString = createValidator(isString, 'string');
+ * validateString('hi');  // { isValid: true, data: 'hi' }
+ * validateString(42);    // { isValid: false, error: 'Invalid string' }
+ * ```
  */
 export declare const createValidator: <T>(validationFn: (data: unknown) => data is T, typeName: string) => (data: unknown) => ValidationResult<T>;
 /**
- * Basic type validators
+ * Runtime type guard: checks if value is a `string`.
+ * @since 1.0.0
  */
 export declare const isString: (value: unknown) => value is string;
+/**
+ * Runtime type guard: checks if value is a finite `number` (excludes NaN).
+ * @since 1.0.0
+ */
 export declare const isNumber: (value: unknown) => value is number;
+/**
+ * Runtime type guard: checks if value is a `boolean`.
+ * @since 1.0.0
+ */
 export declare const isBoolean: (value: unknown) => value is boolean;
+/**
+ * Runtime type guard: checks if value is a non-null, non-array object.
+ * @since 1.0.0
+ */
 export declare const isObject: (value: unknown) => value is Record<string, unknown>;
+/**
+ * Runtime type guard: checks if value is an array.
+ * @since 1.0.0
+ */
 export declare const isArray: (value: unknown) => value is unknown[];
+/**
+ * Runtime type guard: checks if value is `null` or `undefined`.
+ * @since 1.0.0
+ */
 export declare const isNullish: (value: unknown) => value is null | undefined;
 /**
- * Validates that an object has required properties
+ * Validates that an object has all required properties present.
+ *
+ * @template T - Expected object shape
+ * @param obj - Value to check
+ * @param requiredProps - Array of required property keys
+ * @returns True if obj has all required properties
+ * @since 1.0.0
  */
 export declare const hasRequiredProperties: <T extends Record<string, unknown>>(obj: unknown, requiredProps: (keyof T)[]) => obj is T;
 /**
- * Validates array of objects with a validator function
+ * Validates that a value is an array where every item passes a validator.
+ *
+ * @template T - Expected item type
+ * @param data - Value to check
+ * @param itemValidator - Type guard for individual items
+ * @returns True if data is an array of T
+ * @since 1.0.0
  */
 export declare const validateArray: <T>(data: unknown, itemValidator: (item: unknown) => item is T) => data is T[];
 /**
- * Creates optional property validator
+ * Wraps a validator to also accept `undefined`.
+ *
+ * @template T - The validated type
+ * @param validator - Base type guard
+ * @returns Type guard that also accepts `undefined`
+ * @since 1.0.0
  */
 export declare const optional: <T>(validator: (value: unknown) => value is T) => (value: unknown) => value is T | undefined;
 /**
- * Common pattern validators for API responses
+ * Check if data looks like an API response (has `success` boolean).
+ * @since 1.0.0
  */
 export declare const isApiResponse: (data: unknown) => data is {
     success: boolean;
@@ -46,23 +99,53 @@ export declare const isErrorResponse: (data: unknown) => data is {
     error: string;
 };
 /**
- * Date validation
+ * Check if a value is a string that parses to a valid date.
+ * @since 1.0.0
  */
 export declare const isValidDate: (value: unknown) => value is string;
 /**
- * Email validation (basic)
+ * Basic email format validation.
+ * @since 1.0.0
  */
 export declare const isEmail: (value: unknown) => value is string;
 /**
- * URL validation (basic)
+ * Basic URL validation using the `URL` constructor.
+ * @since 1.0.0
  */
 export declare const isUrl: (value: unknown) => value is string;
 /**
- * Creates a type assertion function that throws on invalid data
+ * Creates a type assertion function that throws `TypeError` on
+ * invalid data. Use with `createValidator` for the non-throwing variant.
+ *
+ * @template T - The asserted type
+ * @param validator - Type guard function
+ * @param typeName - Name used in error messages
+ * @returns An assertion function
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const assertString = createAssertion(isString, 'string');
+ * assertString('hello'); // passes
+ * assertString(42);      // throws TypeError
+ * ```
  */
 export declare const createAssertion: <T>(validator: (data: unknown) => data is T, typeName: string) => (data: unknown, context?: string) => asserts data is T;
 /**
- * Safe JSON parsing with validation
+ * Safely parse a JSON string, optionally validating the result.
+ * Returns a {@link ValidationResult} instead of throwing.
+ *
+ * @template T - Expected parsed type
+ * @param jsonString - JSON string to parse
+ * @param validator - Optional type guard to validate the parsed result
+ * @returns Validation result with parsed data or error
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const result = parseJson('{"name":"Alice"}');
+ * if (result.isValid) console.log(result.data);
+ * ```
  */
 export declare const parseJson: <T>(jsonString: string, validator?: Optional<(data: unknown) => data is T>) => ValidationResult<T>;
 //# sourceMappingURL=type-validation.d.ts.map

package/dist/utils/validation/type-validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"type-validation.d.ts","sourceRoot":"","sources":["../../../src/utils/validation/type-validation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"type-validation.d.ts","sourceRoot":"","sources":["../../../src/utils/validation/type-validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAGrE,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAEjC;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,EAC/B,cAAc,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,IAAI,CAAC,EAC1C,UAAU,MAAM,MAER,MAAM,OAAO,KAAG,gBAAgB,CAAC,CAAC,CAc3C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MACxB,CAAC;AAE5B;;;GAGG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MACP,CAAC;AAE7C;;;GAGG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,OACxB,CAAC;AAE7B;;;GAGG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CACH,CAAC;AAEvE;;;GAGG;AACH,eAAO,MAAM,OAAO,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,OAAO,EACnC,CAAC;AAEvB;;;GAGG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,IAAI,GAAG,SACpB,CAAC;AAExC;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrE,KAAK,OAAO,EACZ,eAAe,CAAC,MAAM,CAAC,CAAC,EAAE,KACzB,GAAG,IAAI,CAGT,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,EAC7B,MAAM,OAAO,EACb,eAAe,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,IAAI,CAAC,KAC1C,IAAI,IAAI,CAAC,EAGX,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,GAClB,CAAC,EAAE,WAAW,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,MAC5C,OAAO,OAAO,KAAG,KAAK,IAAI,CAAC,GAAG,SAE9B,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,OAAO,KAAG,IAAI,IAAI;IAAE,OAAO,EAAE,OAAO,CAAA;CAEvE,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,CAAC,EACjC,MAAM,OAAO,EACb,gBAAgB,QAAQ,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,KACvD,IAAI,IAAI;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAMlC,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,MAAM,OAAO,KACZ,IAAI,IAAI;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAOzC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAIrD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,OAAO,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAIjD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,KAAK,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAQ/C,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,EAC/B,WAAW,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,IAAI,CAAC,EACvC,UAAU,MAAM,MAER,MAAM,OAAO,EAAE,gBAAkB,KAAG,QAAQ,IAAI,IAAI,CAK7D,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,EACzB,YAAY,MAAM,EAClB,YAAY,QAAQ,CAAC,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,IAAI,CAAC,CAAC,KACjD,gBAAgB,CAAC,CAAC,CAqBpB,CAAC"}

package/dist/utils/validation/type-validation.js

@@ -8,7 +8,21 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseJson = exports.createAssertion = exports.isUrl = exports.isEmail = exports.isValidDate = exports.isErrorResponse = exports.isSuccessResponse = exports.isApiResponse = exports.optional = exports.validateArray = exports.hasRequiredProperties = exports.isNullish = exports.isArray = exports.isObject = exports.isBoolean = exports.isNumber = exports.isString = exports.createValidator = void 0;
 /**
- * Creates a validation function that safely checks if a value matches expected type
+ * Creates a validation function that safely checks if a value matches
+ * the expected type. Returns a {@link ValidationResult}.
+ *
+ * @template T - The validated type
+ * @param validationFn - Type guard function
+ * @param typeName - Name used in error messages
+ * @returns A function returning `ValidationResult<T>`
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const validateString = createValidator(isString, 'string');
+ * validateString('hi');  // { isValid: true, data: 'hi' }
+ * validateString(42);    // { isValid: false, error: 'Invalid string' }
+ * ```
  */
 const createValidator = (validationFn, typeName) => {
     return (data) => {
@@ -29,22 +43,49 @@ const createValidator = (validationFn, typeName) => {
 };
 exports.createValidator = createValidator;
 /**
- * Basic type validators
+ * Runtime type guard: checks if value is a `string`.
+ * @since 1.0.0
  */
 const isString = (value) => typeof value === 'string';
 exports.isString = isString;
+/**
+ * Runtime type guard: checks if value is a finite `number` (excludes NaN).
+ * @since 1.0.0
+ */
 const isNumber = (value) => typeof value === 'number' && !isNaN(value);
 exports.isNumber = isNumber;
+/**
+ * Runtime type guard: checks if value is a `boolean`.
+ * @since 1.0.0
+ */
 const isBoolean = (value) => typeof value === 'boolean';
 exports.isBoolean = isBoolean;
+/**
+ * Runtime type guard: checks if value is a non-null, non-array object.
+ * @since 1.0.0
+ */
 const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
 exports.isObject = isObject;
+/**
+ * Runtime type guard: checks if value is an array.
+ * @since 1.0.0
+ */
 const isArray = (value) => Array.isArray(value);
 exports.isArray = isArray;
+/**
+ * Runtime type guard: checks if value is `null` or `undefined`.
+ * @since 1.0.0
+ */
 const isNullish = (value) => value === null || value === undefined;
 exports.isNullish = isNullish;
 /**
- * Validates that an object has required properties
+ * Validates that an object has all required properties present.
+ *
+ * @template T - Expected object shape
+ * @param obj - Value to check
+ * @param requiredProps - Array of required property keys
+ * @returns True if obj has all required properties
+ * @since 1.0.0
  */
 const hasRequiredProperties = (obj, requiredProps) => {
     if (!(0, exports.isObject)(obj))
@@ -53,7 +94,13 @@ const hasRequiredProperties = (obj, requiredProps) => {
 };
 exports.hasRequiredProperties = hasRequiredProperties;
 /**
- * Validates array of objects with a validator function
+ * Validates that a value is an array where every item passes a validator.
+ *
+ * @template T - Expected item type
+ * @param data - Value to check
+ * @param itemValidator - Type guard for individual items
+ * @returns True if data is an array of T
+ * @since 1.0.0
  */
 const validateArray = (data, itemValidator) => {
     if (!(0, exports.isArray)(data))
@@ -62,14 +109,20 @@ const validateArray = (data, itemValidator) => {
 };
 exports.validateArray = validateArray;
 /**
- * Creates optional property validator
+ * Wraps a validator to also accept `undefined`.
+ *
+ * @template T - The validated type
+ * @param validator - Base type guard
+ * @returns Type guard that also accepts `undefined`
+ * @since 1.0.0
  */
 const optional = (validator) => (value) => {
     return value === undefined || validator(value);
 };
 exports.optional = optional;
 /**
- * Common pattern validators for API responses
+ * Check if data looks like an API response (has `success` boolean).
+ * @since 1.0.0
  */
 const isApiResponse = (data) => {
     return (0, exports.isObject)(data) && (0, exports.isBoolean)(data.success);
@@ -92,7 +145,8 @@ const isErrorResponse = (data) => {
 };
 exports.isErrorResponse = isErrorResponse;
 /**
- * Date validation
+ * Check if a value is a string that parses to a valid date.
+ * @since 1.0.0
  */
 const isValidDate = (value) => {
     if (!(0, exports.isString)(value))
@@ -102,7 +156,8 @@ const isValidDate = (value) => {
 };
 exports.isValidDate = isValidDate;
 /**
- * Email validation (basic)
+ * Basic email format validation.
+ * @since 1.0.0
  */
 const isEmail = (value) => {
     if (!(0, exports.isString)(value))
@@ -112,7 +167,8 @@ const isEmail = (value) => {
 };
 exports.isEmail = isEmail;
 /**
- * URL validation (basic)
+ * Basic URL validation using the `URL` constructor.
+ * @since 1.0.0
  */
 const isUrl = (value) => {
     if (!(0, exports.isString)(value))
@@ -127,7 +183,21 @@ const isUrl = (value) => {
 };
 exports.isUrl = isUrl;
 /**
- * Creates a type assertion function that throws on invalid data
+ * Creates a type assertion function that throws `TypeError` on
+ * invalid data. Use with `createValidator` for the non-throwing variant.
+ *
+ * @template T - The asserted type
+ * @param validator - Type guard function
+ * @param typeName - Name used in error messages
+ * @returns An assertion function
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const assertString = createAssertion(isString, 'string');
+ * assertString('hello'); // passes
+ * assertString(42);      // throws TypeError
+ * ```
  */
 const createAssertion = (validator, typeName) => {
     return (data, context = typeName) => {
@@ -138,7 +208,20 @@ const createAssertion = (validator, typeName) => {
 };
 exports.createAssertion = createAssertion;
 /**
- * Safe JSON parsing with validation
+ * Safely parse a JSON string, optionally validating the result.
+ * Returns a {@link ValidationResult} instead of throwing.
+ *
+ * @template T - Expected parsed type
+ * @param jsonString - JSON string to parse
+ * @param validator - Optional type guard to validate the parsed result
+ * @returns Validation result with parsed data or error
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const result = parseJson('{"name":"Alice"}');
+ * if (result.isValid) console.log(result.data);
+ * ```
  */
 const parseJson = (jsonString, validator) => {
     try {

package/dist/utils/validation/type-validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"type-validation.js","sourceRoot":"","sources":["../../../src/utils/validation/type-validation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"type-validation.js","sourceRoot":"","sources":["../../../src/utils/validation/type-validation.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sudobility/types",
-  "version": "1.9.52",
+  "version": "1.9.54",
   "description": "Comprehensive TypeScript types, interfaces, and utilities for Web3 email applications - optimized for AI-assisted development",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -20,6 +20,11 @@
       "import": "./dist/types/business/enums.js",
       "require": "./dist/types/business/enums.cjs",
       "types": "./dist/types/business/enums.d.ts"
+    },
+    "./blockchain": {
+      "import": "./dist/types/blockchain/index.js",
+      "require": "./dist/types/blockchain/index.cjs",
+      "types": "./dist/types/blockchain/index.d.ts"
     }
   },
   "scripts": {