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

# 🟡 کمیونٹی براؤزر CDN بلڈ – JavaScript SDK کلائنٹ پیکیج یہ ریپوزٹری npm ماڈیول `@aws-sdk/lib-storage` کی **کمیونٹی کے زیرِ انتظام، براؤزر کے لیے تیار تقسیم** فراہم کرتی ہے۔ یہ ایک بڑے مجموعے (`cloud-sdk-builds`) کا حصہ ہے جو AWS SDK برائے JavaScript v3 کے مختلف پیکیجز کے پہلے سے بنے ورژن پیش کرتا ہے۔ ## اہم خصوصیات - **صفر بلڈ مراحل**: پیکیجز خودکار طور پر بنائے اور CDN پر شائع کیے جاتے ہیں۔ ڈویلپرز Webpack، Vite یا دیگر bundlers کی ضرورت کے بغیر SDK کلائنٹ کو براہِ راست براؤزرز میں استعمال کر سکتے ہیں۔ - **CDN ہوسٹنگ**: jsDelivr پر میزبانی، جس سے HTML `<script type="importmap">` کے ذریعے آسان انضمام ممکن ہے۔ - **ورژن پننگ**: پروڈکشن ماحول میں استحکام کو یقینی بنانے کے لیے مخصوص ورژن URLs کی حمایت کرتا ہے۔ - **SRI انٹیگریٹی**: محفوظ لوڈنگ کے لیے Subresource Integrity (SRI) ہیشز فراہم کرتا ہے۔ ## استعمال ### Import Map سیٹ اپ پیکیج استعمال کرنے کے لیے اپنے HTML میں import map کی تعریف کریں: ```html <script type="importmap"> { "imports": { "@aws-sdk/lib-storage": "https://cdn.jsdelivr.net/gh/cloud-sdk-builds/lib-storage@3.1131.0/index.min.mjs" }, "integrity": { "https://cdn.jsdelivr.net/gh/cloud-sdk-builds/lib-storage@3.1131.0/index.min.mjs": "sha384-nNlqFhRJ+qNESYQLM/aNxDE11EPiRpG+tqDNwmLQJ5AZuG6ZdxFUCm5mEXj/9F5a" } } </script> ``` ### براہِ راست امپورٹ ترتیب دینے کے بعد، آپ اپنے JavaScript میں ماڈیول امپورٹ کر سکتے ہیں: ```javascript import { ... } from "@aws-sdk/lib-storage"; ``` ## دستیاب پیکیجز npm پر شائع ہونے والا کوئی بھی سرکاری `@aws-sdk/*` ماڈیول براؤزر CDN استعمال کے لیے بنایا جا سکتا ہے۔ URLs کا نمونہ یہ ہے: - **تازہ ترین ورژن**: `https://cdn.jsdelivr.net/gh/cloud-sdk-builds/{aws_service_name}/index.min.mjs` - **مخصوص ورژن**: `https://cdn.jsdelivr.net/gh/cloud-sdk-builds/{aws_service_name}@{aws_version}/index.min.mjs` `{aws_service_name}` کی جگہ سروس کا نام (مثلاً `client-s3`، `lib-storage`) اور `{aws_version}` کی جگہ مطلوبہ ورژن ٹیگ لکھیں۔ ## سیکیورٹی اور بہترین طریقے - **ورژنز پن کریں**: پروڈکشن میں ہمیشہ مخصوص ورژن (مثلاً `@3.1131.0`) پن کریں تاکہ اپڈیٹس سے غیر متوقع تبدیلیاں نہ ہوں۔ - **latest سے گریز کریں**: پروڈکشن ماحول میں `latest` URL استعمال نہ کریں۔ - **SRI کی تصدیق کریں**: مواد میں چھیڑچھاڑ نہ ہونے کو یقینی بنانے کے لیے فراہم کردہ SHA انٹیگریٹی ہیش استعمال کریں۔ ## دستبرداری یہ پروجیکٹ ایک **کمیونٹی کے زیرِ انتظام تقسیم** ہے اور Amazon Web Services یا سرکاری SDK مینٹینرز سے **وابستہ، توثیق شدہ یا سپانسر شدہ نہیں** ہے۔ تمام اصل SDK سورس کوڈ اپنے متعلقہ اپ اسٹریم لائسنس کے تحت لائسنس یافتہ رہتا ہے۔ ## شراکت اگر آپ کو اضافی براؤزر کے لیے تیار SDK پیکیجز کی حمایت درکار ہو، تو براہِ کرم مرکزی تنظیم کے ایشو ٹریکر پر ایشو کھولیں: `https://github.com/cloud-sdk-builds/.github/issues`۔