ඔබ කේෂ් යතුරු හෝ Idempotency key සදහා සංකීර්ණ API ප්රතිචාරයක් භාවිතා කරන්නේ නම්, JSON.stringify() සමඟ hash function එකක් යොදා ගැනීමේදී key order, circular reference, BigInt වැනි ගැටළු ඔබට මුහුණ දීමට සිදුවේ.
ඉතින්, TypeScript සංවර්ධකයින් සඳහා නවතම “kokuin” නමැති පුස්තකාලය එම ගැටළු සියල්ල විසඳයි. කිසිදු සැකසුමක්, විකල්පයක් නැතිව, ඔබට JSON‑compatible ඕනෑම වටිනාකමක් ලබා දී, SHA‑256 හෑෂ් එකක් ලබා ගත හැකිය. මෙය 200 කට අඩු ලයින් කේතයක්, zero‑dependency, Node, Bun, Deno, Browser යන සියලු runtime වලින් එකම ප්රතිඵලය ලබා දෙයි.
කොකුයින් කුමක්ද?
- ඇතුළත් කරන වටිනාකමකට hash(value) එකම function එක.
- object key ordering එක නොගැලපේ – {a:1,b:2} හා {b:2,a:1} එකම හෑෂ්.
- array ordering තවදුරටත් වැදගත් – [1,2,3] සහ [3,2,1] වෙන වෙනම.
- circular reference ගැලපෙන පරිදි resolve කරයි, exception නොදෙන.
- BigInt, undefined, -0 වැනි විශේෂ වර්ගද නිවැරදිව හසුරවයි.
- toJSON() method එකක් තිබේ නම් එහි return value එක hash කරයි.
- Date, Map, Set, RegExp, Symbol වැනි unreliable වර්ගවලට error දක්වයි.
ඇයි මෙය වැදගත්?
සාමාන්යයෙන් JSON.stringify(value) + crypto.sha256() භාවිතා කිරීම key order, circular reference, runtime crypto API වෙනස් වීම වැනි බාධක වලට ලක් වේ. kokuin එම සියලු ගැටලු “canonical binary representation” එකක් සාදා, pure‑JS SHA‑256 algorithm එකක් මගින් hash කරයි. එම නිසා ඔබේ cache key, deduplication, idempotency key එක සෑම තැනකම එකසේ, නිවැරදිව, ආරක්ෂිතව පවත්වා ගත හැක.
ශ්රී ලංකාවට ඇති වැදගත්කම
- ඉගෙනුම් කාලය කඩිනම් කිරීම: සිසුන්ට JSON hashing සංකල්පය ඉගෙන ගැනීමට කේතයක් එක්කම පරික්ෂා කළ හැක.
- දියුණු වෙළඳපල: ස්ථානීය startups සහ සමාගම් API caching, data deduplication වැනි අවශ්යතා සඳහා බර නොවූ, එකලස් library එකක් භාවිතා කර ගත හැක.
- ආරක්ෂණය සහ විශ්වාසය: deterministic hash එක නිසා පද්ධති අතර data consistency රැක ගැනීමට පහසුකම් ලැබේ, එය fintech, e‑commerce වැනි ක්ෂේත්රවල විශේෂයෙන් ප්රයෝජනවත්.
- වැඩි පරාසයේ අනුකූලතාව: Node, Deno, Bun, browsers යන සියලු platform වල එකම codebase එකෙන් ක්රියාත්මක වීම, ශ්රී ලංකාවේ විවිධ development environment වලට ගැලපේ.
කෙටි සාරාංශයක් ලෙස, kokuin ඔබේ TypeScript ව්යාපෘතියේ JSON hashing අවශ්යතාවය සරල, වේගවත්, සහ ආරක්ෂිත කරයි. දැන්ත් එය npm හරහා install කර, ඔබේ කේෂ්, Idempotency, deduplication වැඩි දියුණු කර බලන්න.
