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

# AT پروٹوکول حوالہ جاتی نفاذ (TypeScript) اس ریپوزٹری میں بلیو اسکائی کا AT پروٹوکول (atproto) کا حوالہ جاتی نفاذ شامل ہے، جو ایک وکندریقرت سوشل میڈیا پروٹوکول ہے، اور `app.bsky` مائیکرو بلاگنگ ایپلیکیشن سروس کا بیک اینڈ ہے۔ اسے اس لیے ڈیزائن کیا گیا ہے تاکہ تیسرے فریق کا سافٹ ویئر پہلے فریق کی طرح ہموار ہو: کسٹم فیڈز، فیڈریٹڈ خدمات، اور متبادل کلائنٹ سب ایک جیسی APIs کے خلاف بنتے ہیں۔ ## اندر کیا ہے ### لیکسیکن `com.atproto.*` اور `app.bsky.*` دونوں ناموں کے لیے کینونیکل اسکیما تعریفیں، JSON فائلوں کے طور پر لیکسیکن اسکیما تعریفی زبان میں محفوظ ہیں (JSON اسکیما یا OpenAPI کی طرح)۔ ### TypeScript پیکجز npm پر `@atproto/*` اسکوپ کے تحت شائع ہوئے (اندرونی افادیت `@atproto-labs/*` کے تحت)۔ اہم پیکجز میں شامل ہیں: - **`@atproto/lex`** – Type-safe SDK جو لیکسیکن اسکیما سے TypeScript تیار کرتا ہے اور ایک HTTP (XRPC) کلائنٹ فراہم کرتا ہے۔ ایپس یا بوٹس بنانے کے لیے تجویز کردہ۔ پرانا `@atproto/api` کلائنٹ اب بھی موجود ہے لیکن نئے کوڈ کو `@atproto/lex` کو ترجیح دینی چاہیے۔ - **OAuth پیکجز** (`./packages/oauth/`) – "بلیو اسکائی کے ساتھ سائن ان" کے لیے کلائنٹ اور سرور کے نفاذ، براؤزر، Node، اور Expo رن ٹائمز کے لیے مختلف شکلوں کے ساتھ۔ - **پروٹوکول پرائمیٹو** – شناخت کنندہ تجزیہ (`syntax`)، DID/ہینڈل حل (`identity`, `did`)، دستخط (`crypto`)، ریپوزٹری اور مرکل سرچ ٹری (`repo`)، اور فائر ہوز استعمال (`sync`) کے لیے مرکوز پیکجز۔ - **مشترکہ افادیت** – `common`, `common-web`, اور `./packages/internal/` میں اندرونی گلو کوڈ۔ ### TypeScript خدمات ہر سروس کا نفاذ `packages/<name>` میں اور ایک پتلی رن ٹائم ریپر `services/<name>` میں ہے: - **`pds`** – پرسنل ڈیٹا سرور، atproto اکاؤنٹس کے لیے ریپوزٹری مواد کی میزبانی کرتا ہے۔ خود میزبانی کی ہدایات [bluesky-social/pds](https://github.com/bluesky-social/pds) پر دستیاب ہیں۔ - **`bsky`** – `app.bsky.*` API اینڈ پوائنٹس کا AppView نفاذ، مرکزی نیٹ ورک پر `api.bsky.app` پر چل رہا ہے۔ - **`bsync`** – اندرونی ہم آہنگی کی خدمت جو AppView کراس سروس ریاست جیسے خاموشی اور اطلاعات کے لیے استعمال کرتا ہے۔ - **`ozone`** – اعتدال کی خدمت جو `tools.ozone.*` API کو نافذ کرتی ہے۔ ## یہاں کیا نہیں ہے بلیو اسکائی سوشل کلائنٹ ایپ (ویب اور موبائل) کا سورس کوڈ [bluesky-social/social-app](https://github.com/bluesky-social/social-app) پر ہے۔ Go زبان کا سورس کوڈ، بشمول BGS نفاذ، [bluesky-social/indigo](https://github.com/bluesky-social/indigo) پر ہے۔ ## شروع کرنا - **جائزہ اور رہنما**: [atproto.com/guides/overview](https://atproto.com/guides/overview) - **سوالات**: [GitHub مباحثے](https://github.com/bluesky-social/atproto/discussions) - **پروٹوکول تفصیلات**: [atproto.com/specs/atp](https://atproto.com/specs/atp) ## شراکتیں شراکتیں خوش آئند ہیں، لیکن اعلیٰ معیار کے مسائل اور پل ریکویسٹ کو ترجیح دی جاتی ہے۔ ڈویلپر کوئیک اسٹارٹ، قواعد، اور رہنما خطوط کے لیے [CONTRIBUTING.md](./CONTRIBUTING.md) دیکھیں، بشمول LLM کی مدد سے شراکت کی پالیسی۔ کوڈ کنونشن [STYLE_GUIDE.md](./STYLE_GUIDE.md) میں ہیں۔ ## سیکیورٹی سیکیورٹی کے مسائل کی اطلاع security@bsky.app پر دیں (خودکار طور پر ٹیم کو CC کیا جاتا ہے)۔ مزید معلومات کے لیے [SECURITY.md](https://github.com/bluesky-social/atproto/blob/main/SECURITY.md) دیکھیں۔ ## لائسنس MIT اور Apache 2.0 کے تحت دوہری لائسنس۔ ڈاؤن اسٹریم پروجیکٹس دونوں میں سے کوئی ایک لائسنس یا دونوں ایک ساتھ منتخب کر سکتے ہیں۔ بلیو اسکائی سوشل PBC نے سافٹ ویئر پیٹنٹ عدم جارحیت کے عہد کا ارتکاب کیا ہے (اعلان دیکھیں [یہاں](https://bsky.social/about/blog/10-01-2025-patent-pledge))۔