@umituz/react-native-uuid 1.2.7 → 1.2.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-uuid",
-  "version": "1.2.7",
+  "version": "1.2.8",
   "description": "Cross-platform UUID generation utility for React Native apps using expo-crypto",
   "main": "./src/index.ts",
   "types": "./src/index.ts",

package/src/index.ts

@@ -8,5 +8,8 @@ export {
   generateUUID,
   generateUUID as uuidv4,
   generateUUID as generateCreationId,
+  isValidUUID,
+  getUUIDVersion,
 } from "./infrastructure/utils/UUIDUtils";
 export type { UUID } from "./types/UUID";
+export { UUIDVersion, UUID_CONSTANTS } from "./types/UUID";

package/src/infrastructure/utils/UUIDUtils.ts

@@ -7,6 +7,7 @@
 
 import * as Crypto from 'expo-crypto';
 import type { UUID } from '../../types/UUID';
+import { UUID_CONSTANTS } from '../../types/UUID';
 
 /**
  * Generate a v4 UUID
@@ -23,6 +24,52 @@ import type { UUID } from '../../types/UUID';
  * ```
  */
 export const generateUUID = (): UUID => {
-  return Crypto.randomUUID();
+  return Crypto.randomUUID() as UUID;
+};
+
+/**
+ * Validate UUID format
+ * Checks if a string is a valid v4 UUID
+ *
+ * @param value - The value to validate
+ * @returns True if the value is a valid v4 UUID
+ *
+ * @example
+ * ```typescript
+ * import { isValidUUID } from '@umituz/react-native-uuid';
+ *
+ * isValidUUID('550e8400-e29b-41d4-a716-446655440000'); // true
+ * isValidUUID('invalid-uuid'); // false
+ * ```
+ */
+export const isValidUUID = (value: string): value is UUID => {
+  return UUID_CONSTANTS.PATTERN.test(value);
+};
+
+/**
+ * Get version from UUID string
+ * Returns the UUID version number (1-5) or null for NIL/invalid
+ *
+ * @param value - The UUID string
+ * @returns UUID version number or null
+ *
+ * @example
+ * ```typescript
+ * import { getUUIDVersion } from '@umituz/react-native-uuid';
+ *
+ * getUUIDVersion('550e8400-e29b-41d4-a716-446655440000'); // 4
+ * getUUIDVersion('00000000-0000-0000-0000-000000000000'); // 0 (NIL)
+ * getUUIDVersion('invalid'); // null
+ * ```
+ */
+export const getUUIDVersion = (value: string): number | null => {
+  if (value === UUID_CONSTANTS.NIL) {
+    return 0;
+  }
+
+  const versionChar = value.charAt(14);
+  const version = parseInt(versionChar, 10);
+
+  return (version >= 1 && version <= 5) ? version : null;
 };
 

package/src/types/UUID.ts

@@ -3,7 +3,34 @@
  */
 
 /**
- * UUID v4 string type
+ * UUID brand type for type safety
  * Format: xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx
  */
-export type UUID = string;
+export type UUID = string & { readonly __brand: unique symbol };
+
+/**
+ * UUID Version enum
+ */
+export enum UUIDVersion {
+  NIL = 'nil',
+  V1 = 'v1',
+  V2 = 'v2',
+  V3 = 'v3',
+  V4 = 'v4',
+  V5 = 'v5',
+}
+
+/**
+ * UUID constants
+ */
+export const UUID_CONSTANTS = {
+  /**
+   * NIL UUID (00000000-0000-0000-0000-000000000000)
+   */
+  NIL: '00000000-0000-0000-0000-000000000000' as UUID,
+
+  /**
+   * UUID v4 regex pattern
+   */
+  PATTERN: /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i,
+} as const;