منصوبے کے بارے میں

sightings ٹائپ اسکرپٹ میں لکھی گئی ایک ہلکی پھلکی، کوکی لیس پیج ویو اینالیٹکس لائبریری ہے۔ یہ صارف کے ڈیوائس پر کچھ بھی لکھے بغیر—کوئی کوکیز، localStorage، یا فنگر پرنٹنگ نہیں—وزٹس کو ٹریک کرتی ہے اور تمام ریکارڈز براہ راست آپ کی اپنی ڈیٹابیس میں محفوظ کرتی ہے۔ ڈیزائن ہر وزٹ کو ایک «سائٹنگ» سمجھتا ہے: یہ مشاہدہ ہے کہ کوئی وزٹ ہوا، نہ کہ کوئی شناخت سے جُڑا ریکارڈ۔ وزیٹر کی شناخت کے لیے آئی پی، یوزر ایجنٹ، سیکرٹ کی، اور یوٹی سی دن سے حاصل شدہ سالٹ شدہ SHA-256 ہیش کا استعمال کیا جاتا ہے، جسے 128 بٹس تک مختصر کیا جاتا ہے اور روزانہ تبدیل کیا جاتا ہے۔ لائبریری سخت ڈیٹا سرحدوں کو لازمی بناتی ہے: الاؤ لسٹ کے باہر موجود کوئری پیرامیٹرز کو مسترد کر دیا جاتا ہے، ریفرر میں صرف ہوسٹ نیمز ذخیرے ہوتے ہیں، اور کوئی کسٹم ایونٹ پی لوڈ نہیں ہوتا—بی کن بڈی میں کوئی بھی فیلڈ شامل کرنے پر نئے میٹرک کو ریکارڈ کرنے کے بجائے 400 ارر واپس کیا جاتا ہے۔ یہ اس ٹریفک کے دو حصوں کے درمیان تمیز کرتی ہے جنہیں زیادہ تر ٹولز ملواتے ہیں۔ انسانی وزیٹرز ہر نیویگیشن کے دوران ایک واحد `sendBeacon` ریکویسٹ بھیجتے ہیں، جس کا حساب سرفرسائیڈ لگایا جاتا ہے۔ کرافلز اور AI ایجنٹس (جیسے gptbot, claudebot, perplexitybot, telegram-preview) کلائنٹ سائیڈ جے وی اے اسکرپٹ کبھی نہیں چلاتے، اس لیے وہ فیملی نیم درجہ بندی کا استعمال کرتے ہوئے درمیانۂ طائرہ میں تشخیص اور گنتی کے ذریعے شمار کیے جاتے ہیں، نہ کہ خام یوزر ایجنٹ اسٹرنگز سے۔ یہ عملی طور پر یہ ناپنا ممکن بناتا ہے کہ کیا AI ماڈلز نے واقعی آپ کے مواد کو کراول کیا ہے۔ کور پیکیج وہاں کہیں بھی چلتی ہے جہاں معیاری Request/Response جوڑا اور Web Crypto موجود ہو—Node, Deno, Bun, Vercel Edge, Cloudflare Workers۔ سرکاری انٹیگریشنز میں `@sightings/next` (Next.js App Router ہینڈلر اور درمیانۂ طائرہ) اور `@sightings/prisma` (اسکیما ماڈل کے ساتھ Prisma ایڈاپٹر) شامل ہیں۔ حسب ضرورت اسٹوریج ایڈاپٹرز کو صرف ایک `record()` طریقہ فراہم کر کے اور اختیاری طور پر `summary()` طریقہ کر کے نفاذ کیا جا سکتا ہے۔ اہم ترتیبی اختیارات بیس API راستے، راستے کی سطح پر ریڈیکشن (مثلاً `/admin` اور `/invite` ذیلی شاخوں کو چھوڑنا)، کوئری پیرامیٹر الاؤ لسٹ (پہلے سے طے شدہ: `utm_*` اور `ref`)، کرافر فیملی تشخیص، وزیٹر ہیش ونڈو (پہلے سے طے شدہ: روزانہ، یا گھنٹہ وار)، آئی پی اور ملک ہیڈر ترجیح، اور ارر ہینڈلنگ کو کنٹرول کرتے ہیں۔ بلٹ ان `api.summary()` کوئری انٹرفیس بوٹ/انسان فلٹرنگ کے ساتھ تاریخ کی رینجز پر جامع نظارے فراہم کرتا ہے۔ براہ راست ریکارڈنگ طریقے SSR سیاق و سباق، غیر HTTP فریم ورکس، یا پس از تعمیر کے لیے بھی سامنے آتے ہیں۔ ریپوزٹری تینوں پیکیجز میں یکساں ورژننگ کے لیے changesets استعمال کرتی ہے اور CI کے ذریعے provenance سے منسلک tarballs شائع کرتی ہے۔ زمرہ: data | ذیلی زمرہ: analytics-bi