UUID Generator npm

מטרת הכלי והכוונה: הכלי מייצר UUID RFC 4122 עבור פרויקטי Node.js/NPM כדי להציע מזהים ייחודיים עבור Fixture, נתוני בדיקה, טוקני tracer מפוזרים, מזהי מושב ודוגמאות תצורה. משתמשי המפתח הם מפתחי תוכנה, QA, DevOps ו-Pipelines CI שדרושים IDs אמינים וחוזרים על עצמם ללא תלות חיצונית. הוא תומך ביצירת בלוק בפעולה אחת ומאפשר בחירת גרסת UUID וצורת הפלט. עבור תוצאות דטרמיניסטיות דרושות, v3 או v5 יכולים לייצר IDs יציבים מ-Namespace ושם.
לוגיקה מרכזית ותכונות: יכולות עיקריות כוללות: (1) בחירת גרסה מתוך {1,3,4,5}; (2) יצירה במקבץ עם מספר מוגדר; (3) שליטה על הצורה (hyphenated) מול compact; (4) Derivation determinist מאמץ על v3/v5 באמצעות Namespace+שם; (5) יצוא כמערך מחרוזות עם סריאליזציה אופציונלית; (6) אימות ודווח שגיאות מובנה. תכונות חיוניות: count > 0 וגרסה ב-{1,3,4,5}. תכונות מתקדמות: מספק Namespace+שם עבור v3/v5, בחירת פורמט ויצוא למבני נתונים נפוצים או לקבצים דרך כלים יורדים.
קלט ופלט: כניסה: count (int, דרוש, דוגמה 5, טווח 1-10000); version (enum 1,3,4,5; ברירת מחדל 4); hyphenated (boolean, ברירת מחדל true); namespace (מחרוזת, אפשרי); name (מחרוזת, אפשרי). פלט: uuids (מערך סטרינגים); format (מחרוזת: 'hyphenated' או 'compact'); דוגמת פלט בדוקה.
אלגוריתמים וחישובים: V4 משתמש RNG חזק קריפטוגרפית ל UUID אקראיים; V1 מבוסס על זמן; V3 משתמש MD5(Namespace, Name) ל-de rivation של UUID על בסיס Namespace; V5 משתמש SHA-1(Namespace, Name). הקלט מאומת וה-hyphenation מאורגן לאחר יצירה.
שגיאות ותרחישי קצה: count לא תקין (<=0 או >10000) יגרום לשגיאה; גרסה לא תקינה; עבור v3/v5 Namespace או Name חסרים, ייתכן שיהיה fallback ל-v4 אם אפשר; כמויות גדולות עשויות לבזבז זיכרון; התנגשותים הם בלתי סביריים אך לא מובטחות.