প্রকল্প সম্পর্কে

@vskstudio/takt-solid প্যাকেজটি একটি হালকা, সার্ভার-সাইড রেন্ডারিং-নিরাপদ স্তর যা Takt প্রাইভেসি-ফ্রেন্ডলি অ্যানালিটিক্স কর কে SolidJS অ্যাপ্লিকেশনের সাথে একীভূত করে। এটি ভিত্তিগত কোরের প্যেলোয়ড বা প্রাইভেসি নিশ্চয়তা পরিবর্তন করে না; এটি কেবল API-কে Solid-এর জন্য স্থানীয় মনে করতে সাহায্য করে। মূল উপাদান: - Takt কম্পোনেন্ট: অ্যাপ্লিকেশনের রুটের কাছে স্থাপন করা হয়, মাউন্ট হলে অ্যানালিটিক্স শুরু করে, একটি প্রাথমিক পৃষ্ঠাভিউ পাঠায়, SPA নেভিগেশন ট্র্যাক করে এবং অ্যানালিটিক্স ইনস্ট্যান্সটি কম্পোনেন্ট ট্রিতে সরবরাহ করে। - useTakt হুক: কল করার সময়ে লাইভ অ্যানালিটিক্স ইনস্ট্যান্স নির্ধারণ করে। Takt কম্পোনেন্ট মাউন্ট হওয়ার আগে বা সার্ভার রেন্ডারিংয়ের সময় এটি একটি নো-অপারেশন অবজেক্ট ফেরত দেয় যা কখনও ত্রুচালায় না, ফলে ইভেন্ট কলগুলো নিরাপদে হ্যান্ডলারে রাখা যায়। - createTaktEvent ফাংশন এবং TaktEvent কম্পোনেন্ট: নিরীহ হ্যান্ডলার লেখা ছাড়াই ক্লিক ইভেন্ট ট্র্যাক করার ঘোষণামূলক উপায়। উভয়ই ক্লিকের সময়ে সক্রিয় ইনস্ট্যান্স নির্ধারণ করে। - takt-analytics কাস্টম এলিমেন্ট: একটি ফ্রেমওয়ার্ক-স্বাধীন ওয়েব কম্পোনেন্ট যা অ-Solid পেজে ব্যবহার করা যেতে পারে। সাইড-ইফেক্ট এন্ট্রি আমদানি করলে Solid রানটাইম নিয়ে এসে কাস্টম এলিমেন্ট নিবন্ধিত হয়। - TaktBadge এবং TaktEmbed ওয়াইজ: সুরক্ষিত স্যান্ডবক্স এবং রেফারার নীতি সহ একটি ব্যাজ চিত্র বা iframe এমবেড রেন্ডার করে। - createStats ফাংশন: পাবলিক Takt API-এর জন্য একটি টাইপযুক্ত ক্লায়েন্ট সরবরাহ করে, যা সামগ্রিক ডেটার মতো পরিসংখ্যানগুলোর প্রোগ্রাম্যাটিক সংগ্রহ সম্ভব করে। ইনস্টলেশনের জন্য pnpm (বা npm/yarn) এবং পিয়ার ডিপেন্ডেন্সি হিসেবে solid-js ভার্সন 1.8+ ও @vskstudio/takt-core ভার্সন 0.8.1+ প্রয়োজন। কনফিগারেশন Takt কম্পোনেন্টের props বা কাস্টম এলিমেন্টের অ্যাট্রিবিউটের মাধ্যমে সরবরাহ করা হয়। বিকল্পের মধ্যে রয়েছে ডোমেইন, এন্ডপয়েন্ট, আউটবাউন্ড লিঙ্ক ট্র্যাকিং, ফাইল ডাউনলোড ট্র্যাকিং, SPA নেভিগেশন ট্র্যাকিং, 404 রিপোর্টিং, DNT সম্মান, localhost বর্জন, স্যাম্পলিং রেট, কোয়ালি স্ট্রিং হ্যান্ডলিং, URL স্ক্রাবিং এবং একটি প্রধান চালু/বন্ধ সুইচ। Props মাউন্টে একবার পড়ে; পরিবর্তনের জন্য পুনরায় মাউন্ট প্রয়োজন। বইটি সম্পূর্ণ SSR-সঙ্গত: Takt কম্পোনেন্ট শুধুমাত্র onMount-এ ক্লায়েন্টে চলে, useTakt সার্ভার রেন্ডারিংয়ের সময় একটি নিরাপদ no-op ফেরত দেয়। সার্ভারে কাস্টম এলিমেন্ট আমদানি customElements চেক দ্বারা guard করা হয়। সমস্ত প্রাইভেসি-সম্পর্কিত আচরণ—DNT সমর্থন, localhost বর্জন, সম্মতি পরিচালনা এবং প্যেলোয়ড ফ্রিজিং—কোর লাইব্রেরিতে বাস্তবায়িত এবং এই ওয়্যার দ্বারা পরিবর্তিত হয় না। লাইসেন্স: MIT।