drivekit 1.1.0 → 1.1.2
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 +31 -13
- package/README.md +10 -4
- package/dist/cli.cjs +661 -163
- package/dist/cli.cjs.map +1 -1
- package/dist/cli.js +651 -156
- package/dist/cli.js.map +1 -1
- package/dist/index.cjs +683 -186
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +112 -12
- package/dist/index.d.ts +112 -12
- package/dist/index.js +679 -185
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/README.ar.md
CHANGED
|
@@ -39,28 +39,46 @@
|
|
|
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. ⚡ **مزامنة المجلدات بالتوازي (Parallel Sync Engine)**:
|
|
72
|
+
- رفع وتنزيل مجلدات كاملة بجميع تفرعاتها بالتوازي مع التحكم في عدد المسارات المتزامنة.
|
|
55
73
|
|
|
56
|
-
|
|
57
|
-
|
|
74
|
+
11. 📄 **تصدير مستندات Google تلقائياً**:
|
|
75
|
+
- تحويل Google Docs إلى PDF أو Docx، و Sheets إلى Excel أو CSV، و Slides إلى PDF بلمسة واحدة.
|
|
58
76
|
|
|
59
|
-
|
|
60
|
-
|
|
77
|
+
12. 🔗 **مشاركة فورية للملفات**:
|
|
78
|
+
- تحويل أي ملف إلى عام بلمسة واحدة والحصول على رابط العرض والرابط المباشر للتحميل.
|
|
61
79
|
|
|
62
|
-
|
|
63
|
-
|
|
80
|
+
13. 💻 **أداة سطر أوامر مدمجة (CLI)**:
|
|
81
|
+
- تشغيل مباشر من الطرفية عبر `drivekit ls` أو `drivekit upload` أو `drivekit sync`.
|
|
64
82
|
|
|
65
83
|
---
|
|
66
84
|
|
package/README.md
CHANGED
|
@@ -36,10 +36,16 @@ 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.
|