drivekit 1.1.1 → 1.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.ar.md +52 -13
- package/README.md +19 -5
- package/dist/cli.cjs +2059 -282
- package/dist/cli.cjs.map +1 -1
- package/dist/cli.js +2048 -271
- package/dist/cli.js.map +1 -1
- package/dist/index.cjs +1931 -237
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +401 -4
- package/dist/index.d.ts +401 -4
- package/dist/index.js +1900 -229
- package/dist/index.js.map +1 -1
- package/package.json +3 -1
package/README.ar.md
CHANGED
|
@@ -39,28 +39,67 @@
|
|
|
39
39
|
- تعامل مع Google Drive كنظام ملفات حقيقي: `drive.mkdirp('/Backups/2026')` أو الرفع المباشر إلى مسار: `parent: '/Projects/App'`.
|
|
40
40
|
- تخزين مؤقت تلقائي لمسارات المجلدات لتسريع العمليات وتوفير استعلامات الـ API.
|
|
41
41
|
|
|
42
|
-
2.
|
|
43
|
-
-
|
|
44
|
-
-
|
|
42
|
+
2. ⚡ **محرك السرعة القصوى (DriveKit Turbo Engine)**:
|
|
43
|
+
- **تجميع وإعادة استخدام الاتصالات (Keep-Alive)**: الحفاظ على حتى 64 قناة اتصال مفتوحة لتجاوز بطء مصافحة أمان TLS في كل طلب.
|
|
44
|
+
- **دمج الطلبات المتزامنة (In-Flight Request Coalescing)**: توحيد استعلامات المسارات المتزامنة في طلب شبكي واحد وحماية من تكرار المجلدات.
|
|
45
|
+
- **تخزين مؤقت استباقي للشجرة (Opportunistic Tree Caching)**: استعلام `drive.ls()` يفهرس فوراً أبناء المجلد ومساراتهم في SQLite، ليكون الاستعلام اللاحق في **0.03 مللي ثانية (0ms Hit)**.
|
|
46
|
+
- **مسار الرفع السريع للملفات الصغيرة (≤ 5MB)**: رفع مباشر في طلب واحد مع الحفاظ على تنبيهات التقدم اللحظية.
|
|
47
|
+
- **حجم قطع متكيف (Adaptive Chunk Sizing)**: ترقية حجم القطع تلقائياً إلى 16MB و 32MB للملفات الكبيرة والعملاقة.
|
|
48
|
+
|
|
49
|
+
3. 💾 **كاش دائم محلي في 0ms عبر SQLite**:
|
|
50
|
+
- فهرسة محلية للملفات والمجلدات عبر `node:sqlite` المدمج في Node 22 (مع بديل In-Memory تلقائي في البيئات السابقة).
|
|
51
|
+
|
|
52
|
+
4. 🖥️ **خادم WebDAV مدمج (RFC 4918)**:
|
|
53
|
+
- ربط Google Drive كمساحة ملفات شبكية مباشرة في macOS Finder و Windows Explorer مع مصادقة HTTP Basic Auth.
|
|
54
|
+
|
|
55
|
+
5. 🌊 **دعم كامل لتدفقات Node.js وطلبات النطاق الجزئي (HTTP 206)**:
|
|
56
|
+
- قراءة وكتابة التدفقات عبر `createReadStream` و `createWriteStream` بذاكرة وسيطة سعتها 1MB لأقصى استغلال لسرعة الشبكة.
|
|
57
|
+
|
|
58
|
+
6. 🧩 **نظام إضافات معياري (Plugins Architecture)**:
|
|
59
|
+
- خطافات دورة حياة العمليات (`beforeUpload`, `afterUpload`, `beforeDownload`, `afterDownload`) مع إضافات جاهزة مثل التسمية التلقائية بالوقت و Webhooks.
|
|
60
|
+
|
|
61
|
+
7. 🚀 **محرك رفع متقطع فائق السرعة (Resumable Chunked Uploader)**:
|
|
62
|
+
- رفع آمن للملفات الضخمة باستئناف تلقائي عند انقطاع الشبكة.
|
|
45
63
|
- تتبع حي ودقيق: **نسبة الإنجاز %**، **سرعة الرفع الحالية (MB/s)**، **الوقت المتبقي المقدر (ETA)**.
|
|
46
64
|
|
|
47
|
-
|
|
65
|
+
8. 🔍 **باني استعلامات سلس (Fluent Query Builder)**:
|
|
48
66
|
- كتابة استعلامات نظيفة وسلسة وسهلة القراءة بأسلوب السلسلة (Chaining).
|
|
49
67
|
|
|
50
|
-
|
|
68
|
+
9. 🛡️ **مقاومة أخطاء الشبكة والكوتا (Exponential Backoff with Full Jitter)**:
|
|
51
69
|
- إعادة محاولة ذكية وتلقائية عند مواجهة `429 Too Many Requests` أو `5xx Backend Errors`.
|
|
52
70
|
|
|
53
|
-
|
|
54
|
-
|
|
71
|
+
10. 🔄 **مزامنة ذكية ثنائية الاتجاه (Two-Way Sync Engine)**:
|
|
72
|
+
- مزامنة كاملة وتطابق لحظي بين مجلد محلي وسحابي مع معالجة متقدمة للتعارضات ونقل الحذف.
|
|
73
|
+
|
|
74
|
+
11. 🔒 **تشفير شامل من طرف لطرف (Zero-Knowledge AES-256-GCM)**:
|
|
75
|
+
- تشفير محلي عسكري لكامل الملفات وأسمائها قبل مغادرتها جهاز المطور واشتقاق مفاتيح بـ 100,000 دورة PBKDF2.
|
|
76
|
+
|
|
77
|
+
12. 📦 **بوابة S3 المتوافقة (S3 REST API Gateway)**:
|
|
78
|
+
- ربط Google Drive كمساحة تخزين S3 لأدوات AWS CLI و MinIO Client وسكريبتات النسخ الاحتياطي.
|
|
79
|
+
|
|
80
|
+
13. 📜 **إدارة النسخ والمراجعات التاريخية (Revisions & Versions)**:
|
|
81
|
+
- استعراض تاريخ التعديلات، تثبيت النسخ الهامة دائماً (`keepForever`)، واستعادة الملفات لنسخ سابقة.
|
|
82
|
+
|
|
83
|
+
14. 🛡️ **فاحص الأمان والصلاحيات (Security & Permissions Auditor)**:
|
|
84
|
+
- اكتشاف الروابط العامة المكشوفة ومشاركات النطاق الواسعة والمتعاونين الخارجيين مع إلغاء الصلاحيات بنقرة واحدة.
|
|
85
|
+
|
|
86
|
+
15. 🗜️ **ضغط لحظي أثناء النقل (On-The-Fly Compression)**:
|
|
87
|
+
- ضغط وفك ضغط التدفقات لحظياً بـ `gzip` أو `brotli` لتوفير حتى 80% من مساحة التخزين وحجم النقل.
|
|
88
|
+
|
|
89
|
+
16. 🌐 **حزم وسائط لإطارات الويب (Express & Next.js Middleware)**:
|
|
90
|
+
- رفع مباشر من متصفح المستخدم إلى Google Drive عبر الذاكرة دون كتابة ملفات مؤقتة على قرص السيرفر.
|
|
91
|
+
|
|
92
|
+
17. 🔍 **بحث ذكي ودلالي (Smart Fuzzy & Semantic Search)**:
|
|
93
|
+
- بحث ذكي يتحمل الأخطاء الإملائية والكلمات المتعددة مع حساب التطابق الدلالي لمتجهات الذكاء الاصطناعي.
|
|
55
94
|
|
|
56
|
-
|
|
57
|
-
|
|
95
|
+
18. 📄 **تصدير مستندات Google تلقائياً**:
|
|
96
|
+
- تحويل Google Docs إلى PDF أو Docx، و Sheets إلى Excel أو CSV، و Slides إلى PDF بلمسة واحدة.
|
|
58
97
|
|
|
59
|
-
|
|
60
|
-
|
|
98
|
+
19. 🔗 **مشاركة فورية للملفات**:
|
|
99
|
+
- تحويل أي ملف إلى عام بلمسة واحدة والحصول على رابط العرض والرابط المباشر للتحميل.
|
|
61
100
|
|
|
62
|
-
|
|
63
|
-
|
|
101
|
+
20. 💻 **أداة سطر أوامر مدمجة وشاملة (CLI)**:
|
|
102
|
+
- تشغيل مباشر من الطرفية عبر `drivekit ls`, `drivekit sync-2way`, `drivekit serve-s3`, `drivekit audit`, `drivekit revisions`, `drivekit search --smart`.
|
|
64
103
|
|
|
65
104
|
---
|
|
66
105
|
|
package/README.md
CHANGED
|
@@ -36,16 +36,30 @@ Working with the raw Google Drive API is often tedious:
|
|
|
36
36
|
## 🌟 Key Features
|
|
37
37
|
|
|
38
38
|
- 📂 **Virtual Filesystem Paths**: Treat Drive like a filesystem (`/Backups/2026/DB.dump`). Auto-creates missing parents (`mkdirp`).
|
|
39
|
-
- ⚡ **
|
|
40
|
-
-
|
|
41
|
-
-
|
|
42
|
-
-
|
|
39
|
+
- ⚡ **DriveKit Turbo Engine (Native Speed)**:
|
|
40
|
+
- **HTTP Keep-Alive Connection Pooling**: Persistent socket management across up to 64 sockets, eliminating cold TLS handshakes.
|
|
41
|
+
- **In-Flight Request Coalescing**: Parallel requests to identical paths coalesce into a single execution, eliminating duplicate queries.
|
|
42
|
+
- **Opportunistic Tree Caching**: Calling `drive.ls('/path')` immediately indexes children into local SQLite for instant **0.03ms (0ms)** lookups.
|
|
43
|
+
- **Direct Multipart Fast Path**: Files ≤ 5MB upload in a single roundtrip while retaining real-time progress events.
|
|
44
|
+
- **Adaptive Chunk Sizing**: Automatically tunes chunk size (8MB, 16MB, 32MB) based on file size for maximum wire saturation.
|
|
45
|
+
- 💾 **0ms Persistent SQLite Cache**: Local SQLite metadata index powered by Node 22 native `node:sqlite` (with transparent in-memory fallback).
|
|
46
|
+
- 🖥️ **RFC 4918 WebDAV Server**: Mount Google Drive directly into macOS Finder or Windows Explorer with HTTP Basic Auth.
|
|
47
|
+
- 🌊 **Node.js Streams & Range**: Memory-efficient streaming with `createReadStream`, `createWriteStream`, and HTTP 206 Partial Content (1MB highWaterMark).
|
|
48
|
+
- 🧩 **Extensible Plugin System**: Lifecycle middleware (`beforeUpload`, `afterUpload`, `beforeDownload`, `afterDownload`) with built-in auto-naming and webhook plugins.
|
|
43
49
|
- 🔍 **Fluent Query Builder**: Chainable methods (`.nameContains()`, `.mimeType()`, `.notTrashed()`, `.orderBy()`, `.pageSize()`).
|
|
44
50
|
- 🛡️ **Adaptive Rate Limiting & Backoff**: Exponential backoff with full jitter automatically catches and retries `429` and `5xx` errors.
|
|
45
51
|
- 🔄 **Parallel Directory Sync**: Concurrently sync entire local folder trees with configurable concurrency limit.
|
|
46
52
|
- 📑 **Auto-Export Google Docs**: Seamlessly exports Google Docs (PDF/Docx), Sheets (Excel/CSV), and Slides (PDF).
|
|
47
53
|
- 🔗 **Instant Sharing**: One-liner to make files publicly accessible and obtain direct download and preview URLs.
|
|
48
|
-
-
|
|
54
|
+
- 🔄 **Two-Way Bidirectional Sync**: Intelligent two-way sync with ledger tracking and conflict resolution (`rename-conflict`, `keep-newer`, `prefer-cloud`, `prefer-local`).
|
|
55
|
+
- 🔒 **Zero-Knowledge E2E Encryption**: Client-side AES-256-GCM authenticated encryption with PBKDF2 (100k rounds) for confidential files and filenames.
|
|
56
|
+
- 📦 **S3-Compatible Gateway Server**: Mount Google Drive as an AWS S3 REST API endpoint for AWS CLI, MinIO client, and backup agents.
|
|
57
|
+
- 📜 **Revisions & Version Control**: Inspect edit history, pin milestones indefinitely (`keepForever`), and rollback to past revisions.
|
|
58
|
+
- 🛡️ **Security & Permissions Auditor**: Detect public link leaks, broad domain shares, and external collaborators with 1-click auto-revocation.
|
|
59
|
+
- 🗜️ **On-the-Fly Compression**: Stream compression (`gzip`, `brotli`) saving up to 80% bandwidth and storage.
|
|
60
|
+
- 🌐 **Web Framework Middleware**: Express & Next.js streaming multipart handlers without writing temporary files to server disk.
|
|
61
|
+
- 🔍 **Smart Fuzzy Search**: Multi-word typo-tolerant relevance scoring and semantic vector cosine similarity search.
|
|
62
|
+
- 💻 **Modern CLI Included**: Perform operations right from your terminal with `drivekit ls`, `drivekit upload`, `drivekit sync-2way`, `drivekit serve-s3`, `drivekit audit`, etc.
|
|
49
63
|
|
|
50
64
|
---
|
|
51
65
|
|