bytex-sdk 1.9.5 → 5.0.0

package/README.md

@@ -1,56 +1,45 @@
-# ByteX SDK ⚡
-> The official SDK for the ByteX Cloud Ecosystem.
+# ByteX Cloud SDK 🚀
 
-ByteX SDK provides a powerful, easy-to-use interface for interacting with ByteX Cloud storage and infrastructure. It supports both Supabase and Firebase backends, enabling a true "Bring Your Own Cloud" (BYOC) experience.
+The official SDK for the ByteX ecosystem, enabling developers to build professional "Super SaaS" products with 100% cloud sovereignty (BYOC).
 
-## ✨ Features
-- **Multi-Provider**: Seamlessly switch between Supabase and Firebase.
-- **Advanced Encryption**: Built-in AES-CTR encryption for secure file storage.
-- **Streaming Support**: Direct streaming for media files (video/audio).
-- **CDN Integration**: Purge and manage global CDN cache.
-- **Middleware System**: Intercept and optimize uploads (e.g., auto-convert to WebP).
-- **Bulk Operations**: Download or export entire projects as ZIP.
+## Features
+- 🔐 **Secure Authentication**: Integrated with Supabase.
+- 📦 **Data Persistence**: Upload and download streams directly to your own Cloud (HuggingFace).
+- 🕵️‍♂️ **X-Ray Diagnostics**: Built-in network and infrastructure health checks.
+- ⚡ **Lightweight**: Zero-config needed for most use cases.
 
-## 📦 Installation
+## Installation
 ```bash
-npm install bytex-sdk
+npm install @bytex/cloud-sdk
 ```
 
-## 🚀 Quick Start
+## Quick Start
+
+### Initialize
 ```javascript
-import { BytexCloud } from 'bytex-sdk';
+import { BytexCloud } from '@bytex/cloud-sdk';
+import AsyncStorage from '@react-native-async-storage/async-storage';
 
-// Initialize with your API Key
-const bytex = new BytexCloud({ 
-  apiKey: 'BTX-USER-XXXXXXXX',
-  dbProvider: 'supabase' // or 'firebase'
+const bytex = new BytexCloud({
+  apiKey: 'YOUR_API_KEY',
+  workerUrl: 'https://api.bytex.work/',
+  storage: AsyncStorage // for React Native
 });
-
-// Upload a file
-await bytex.upload('hello.txt', 'Hello World');
-
-// Get a streaming URL
-const streamUrl = bytex.stream('video.mp4');
-
-// List files
-const files = await bytex.listFiles();
-console.log(files);
 ```
 
-## 🛠 Advanced Usage: Middleware
+### Upload Data
 ```javascript
-import { BytexCloud, BytexMiddlewares } from 'bytex-sdk';
-
-const bytex = new BytexCloud({ apiKey: '...' });
-
-// Automatically optimize images to WebP before upload
-bytex.use(BytexMiddlewares.imageOptimizer(0.8));
-
-await bytex.upload('photo.jpg', fileData); // Uploads as photo.webp
+await bytex.uploadData('my_project', { 
+  status: 'active', 
+  users: 1000 
+});
 ```
 
-## 🛡 Security
-All storage operations are authenticated via API keys. Data can be encrypted locally using standard or custom encryption keys, ensuring that your storage provider never sees raw data.
+### Infrastructure Health Check (X-Ray)
+```javascript
+const report = await bytex.xray();
+console.log(report.checks);
+```
 
-## 📄 License
-ISC © ByteX Ecosystem
+## License
+MIT © ByteX Guru

package/package.json

@@ -1,18 +1,23 @@
 {
   "name": "bytex-sdk",
-  "version": "1.9.5",
-  "description": "",
-  "main": "index.js",
+  "version": "5.0.0",
+  "description": "The official ByteX Cloud SDK for BYOC (Bring Your Own Cloud) infrastructure management.",
+  "main": "src/index.js",
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1",
-    "postinstall": "node postinstall.js"
+    "test": "echo \"Error: no test specified\" && exit 1"
   },
+  "keywords": [
+    "bytex",
+    "cloud",
+    "saas",
+    "byoc",
+    "supabase",
+    "huggingface"
+  ],
+  "author": "ByteX Guru",
+  "license": "MIT",
   "dependencies": {
-    "@supabase/supabase-js": "^2.105.4",
-    "chalk": "^5.3.0"
-  },
-  "keywords": [],
-  "author": "",
-  "license": "ISC",
-  "type": "module"
+    "@supabase/supabase-js": "^2.39.0",
+    "react-native-url-polyfill": "^2.0.0"
+  }
 }

package/src/index.js

@@ -0,0 +1,104 @@
+import { createClient } from '@supabase/supabase-js';
+
+const SUPABASE_URL = 'https://vkiddclfbwmslaiyyftl.supabase.co';
+const SUPABASE_ANON_KEY = 'sb_publishable_hXMlH9OmJG1_n1s-3lbXKg_6V-88Lj9';
+const WORKER_URL = 'https://api.bytex.work/';
+
+export class BytexCloud {
+  constructor(config = {}) {
+    this.config = config;
+    this.apiKey = config.apiKey || null;
+    this.workerUrl = config.workerUrl || WORKER_URL;
+    
+    const supabaseConfig = {
+      auth: {
+        persistSession: true,
+        autoRefreshToken: true,
+        detectSessionInUrl: false
+      }
+    };
+    if (config.storage) {
+      supabaseConfig.auth.storage = config.storage;
+    }
+    
+    this.supabase = createClient(SUPABASE_URL, SUPABASE_ANON_KEY, supabaseConfig);
+    this._listeners = {};
+  }
+
+  async _execute(fn, action) {
+    try {
+      return await fn();
+    } catch (e) {
+      const diag = await this.xray();
+      const advice = diag.advice.length > 0 ? `\n[X-RAY Advice]: ${diag.advice.join(' ')}` : '';
+      throw new Error(`${action} failed: ${e.message}${advice}`);
+    }
+  }
+
+  async login(email, password) {
+    return this._execute(async () => {
+      const { data, error } = await this.supabase.auth.signInWithPassword({ email, password });
+      if (error) throw error;
+      return data.user;
+    }, 'Login');
+  }
+
+  async uploadData(name, data) {
+    return this._execute(async () => {
+      this._requireKey();
+      const streamName = name.endsWith('.btx') ? name : `${name}.stream.btx`;
+      const url = `${this.workerUrl}?action=upload&key=${this.apiKey}&file=${encodeURIComponent(streamName)}`;
+      const { data: { session } } = await this.supabase.auth.getSession();
+      
+      const payload = typeof data === 'string' ? data : JSON.stringify(data);
+      
+      const res = await fetch(url, {
+        method: 'POST',
+        headers: { 
+          'Authorization': `Bearer ${session?.access_token || ''}`,
+          'Content-Type': 'application/json'
+        },
+        body: payload
+      });
+      
+      if (!res.ok) throw new Error(`Upload failed with status ${res.status}`);
+      return await res.json();
+    }, 'Upload');
+  }
+
+  async downloadData(name) {
+    return this._execute(async () => {
+      this._requireKey();
+      const streamName = name.endsWith('.btx') ? name : `${name}.stream.btx`;
+      const url = `${this.workerUrl}?action=view&key=${this.apiKey}&file=${encodeURIComponent(streamName)}&_cb=${Date.now()}`;
+      const { data: { session } } = await this.supabase.auth.getSession();
+      const res = await fetch(url, {
+        headers: { 'Authorization': `Bearer ${session?.access_token || ''}` }
+      });
+      if (!res.ok) throw new Error(`Status ${res.status}`);
+      const text = await res.text();
+      try { return JSON.parse(text); } catch (e) { return text.split('\n').filter(Boolean).map(line => JSON.parse(line)); }
+    }, 'Download');
+  }
+
+  async xray() {
+    const report = { timestamp: new Date().toISOString(), checks: {}, advice: [] };
+    const { data: { session } } = await this.supabase.auth.getSession();
+    
+    try {
+      const res = await fetch(`${this.workerUrl}?action=list&key=${this.apiKey}`);
+      report.checks.connectivity = res.ok ? 'OK' : 'ERROR';
+    } catch (e) {
+      report.checks.connectivity = 'OFFLINE';
+      report.advice.push('ByteX Cloud unreachable. Check internet connection.');
+    }
+
+    if (!this.apiKey) report.advice.push('API Key is missing.');
+    if (!session) report.advice.push('User is not logged in.');
+    if (!this.config.storage) report.advice.push('AsyncStorage engine is missing.');
+
+    return report;
+  }
+
+  _requireKey() { if (!this.apiKey) throw new Error('API Key required!'); }
+}

package/index.js

@@ -1,138 +0,0 @@
-import { createClient } from '@supabase/supabase-js';
-
-const SUPABASE_URL = 'https://vkiddclfbwmslaiyyftl.supabase.co';
-const SUPABASE_ANON_KEY = 'sb_publishable_hXMlH9OmJG1_n1s-3lbXKg_6V-88Lj9';
-const WORKER_URL = 'https://api.bytex.work/';
-
-export class BytexCloud {
-  constructor(config = {}) {
-    this.config = config;
-    this.apiKey = config.apiKey || null;
-    this.workerUrl = config.workerUrl || WORKER_URL;
-    
-    const supabaseConfig = {
-      auth: {
-        persistSession: true,
-        autoRefreshToken: true,
-        detectSessionInUrl: false
-      }
-    };
-    if (config.storage) {
-      supabaseConfig.auth.storage = config.storage;
-    }
-    
-    this.supabase = createClient(config.supabaseUrl || SUPABASE_URL, config.supabaseKey || SUPABASE_ANON_KEY, supabaseConfig);
-    this._listeners = {};
-  }
-
-  // --- CORE METHODS ---
-  async login(email, password) {
-    const { data, error } = await this.supabase.auth.signInWithPassword({ email, password });
-    if (error) throw new Error(error.message);
-    return data.user;
-  }
-
-  async upload(name, data) {
-    this._requireKey();
-    const fd = new FormData();
-    fd.append('file', data instanceof Blob ? data : new Blob([data]), name);
-    const res = await fetch(`${this.workerUrl}?action=upload&key=${this.apiKey}`, { method: 'POST', body: fd });
-    if (!res.ok) throw new Error(`Upload Failed: ${res.statusText}`);
-    return await res.json();
-  }
-
-  async downloadData(name) {
-    this._requireKey();
-    const streamName = name.endsWith('.stream.btx') ? name : `${name}.stream.btx`;
-    const url = `${this.workerUrl}?action=view&key=${this.apiKey}&file=${encodeURIComponent(streamName)}&_cb=${Date.now()}`;
-    const { data: { session } } = await this.supabase.auth.getSession();
-    const res = await fetch(url, { headers: { 'Authorization': `Bearer ${session?.access_token || ''}` } });
-    if (!res.ok) throw new Error(`Download Failed: ${res.status}`);
-    const text = await res.text();
-    try { return JSON.parse(text); } catch (e) { return text.split('\n').filter(Boolean).map(line => JSON.parse(line)); }
-  }
-
-  async delete(name) {
-    this._requireKey();
-    const streamName = name.endsWith('.stream.btx') ? name : `${name}.stream.btx`;
-    const { data: { session } } = await this.supabase.auth.getSession();
-    const res = await fetch(`${this.workerUrl}?action=delete&key=${this.apiKey}&file=${encodeURIComponent(streamName)}`, {
-      method: 'DELETE',
-      headers: { 'Authorization': `Bearer ${session?.access_token || ''}` }
-    });
-    if (!res.ok) throw new Error(`Delete Failed: ${res.status}`);
-    return true;
-  }
-
-  /**
-   * ByteX X-RAY v2.1 (The Professional)
-   * Detailed diagnostic for Upload, Delete, and Streaming capabilities.
-   */
-  async xray() {
-    console.log('[ByteX X-RAY] 🔍 Running professional system diagnostics...');
-    const report = {
-      timestamp: new Date().toISOString(),
-      sdk_version: '1.9.5',
-      health_score: 100,
-      checks: {},
-      advice: []
-    };
-
-    // 1. Auth & Session Integrity
-    const { data: { session } } = await this.supabase.auth.getSession();
-    report.checks.auth = { status: session ? 'OK' : 'GUEST', user: session?.user?.email || 'unauthenticated' };
-    if (!session) report.advice.push('User is not logged in. Most management operations (delete, protected view) will fail.');
-
-    // 2. Upload/Write Permission Check
-    try {
-      this._requireKey();
-      const testFd = new FormData();
-      testFd.append('file', new Blob(['test']), 'xray_probe.txt');
-      const upRes = await fetch(`${this.workerUrl}?action=upload&key=${this.apiKey}&probe=true`, { method: 'POST', body: testFd });
-      report.checks.upload_capability = upRes.ok ? 'OK' : 'RESTRICTED';
-      if (!upRes.ok) report.advice.push('Upload restricted. Your API Key might be READ-ONLY or the server rejected the probe.');
-    } catch (e) {
-      report.checks.upload_capability = 'ERROR';
-      report.advice.push(`Upload Check Failed: ${e.message}`);
-    }
-
-    // 3. Delete/Management Permission Check
-    try {
-      const delRes = await fetch(`${this.workerUrl}?action=delete&key=${this.apiKey}&file=non_existent_probe`, { 
-        method: 'DELETE', 
-        headers: { 'Authorization': `Bearer ${session?.access_token || ''}` }
-      });
-      // 404 is actually GOOD here because it means the DELETE method was accepted by the worker
-      report.checks.delete_capability = (delRes.status === 404 || delRes.ok) ? 'OK' : 'FORBIDDEN';
-      if (delRes.status === 403 || delRes.status === 401) {
-        report.advice.push('Delete forbidden. Ensure your session is valid and you have owner permissions.');
-      }
-    } catch (e) {
-      report.checks.delete_capability = 'UNSUPPORTED';
-    }
-
-    // 4. Streaming & Range Support
-    try {
-      const streamRes = await fetch(`${this.workerUrl}?action=view&key=${this.apiKey}&file=probe`, {
-        headers: { 'Range': 'bytes=0-1' }
-      });
-      report.checks.streaming = streamRes.headers.get('Accept-Ranges') ? 'OPTIMIZED' : 'STANDARD';
-      if (report.checks.streaming === 'STANDARD') {
-        report.advice.push('Server does not support partial content (Ranges). Large video seeking might be slow.');
-      }
-    } catch (e) { report.checks.streaming = 'UNKNOWN'; }
-
-    // 5. Code Implementation Audit
-    if (!this.config.storage && typeof navigator !== 'undefined') {
-      report.checks.implementation = 'INCOMPLETE';
-      report.advice.push('React Native detected but "storage" engine is missing in constructor. Sessions will NOT persist across app restarts.');
-    }
-
-    const issues = report.advice.length;
-    report.final_status = issues === 0 ? 'HEALTHY' : (issues < 3 ? 'WARNING' : 'CRITICAL');
-    
-    return report;
-  }
-
-  _requireKey() { if (!this.apiKey) throw new Error('API Key required! Use setApiKey().'); }
-}

package/postinstall.js

@@ -1,26 +0,0 @@
-import chalk from 'chalk';
-
-console.log('');
-console.log(chalk.blue.bold('========================================='));
-console.log(chalk.cyan.bold('  🚀 Successfully installed ByteX SDK!'));
-console.log(chalk.blue.bold('========================================='));
-console.log('');
-console.log(chalk.white('Get started by importing the SDK into your project:'));
-console.log('');
-console.log(chalk.gray('  // 1. Initialize ByteX'));
-console.log(chalk.green("  import { BytexCloud } from 'bytex-sdk';"));
-console.log(chalk.green("  const bytex = new BytexCloud();"));
-console.log('');
-console.log(chalk.gray('  // 2. Login & Generate/Select API Key directly in code'));
-console.log(chalk.green("  await bytex.login('your@email.com', 'password');"));
-console.log(chalk.green("  const myKey = await bytex.createKey('My Web App');"));
-console.log(chalk.gray('  // (The active API Key is now set automatically!)'));
-console.log('');
-console.log(chalk.gray('  // 3. Upload a file'));
-console.log(chalk.green("  await bytex.upload('document.pdf', fileData);"));
-console.log('');
-console.log(chalk.white('Want to do this via terminal instead? Try the CLI:'));
-console.log(chalk.cyan('  npx bytex-cli init'));
-console.log('');
-console.log(chalk.gray('For full SDK documentation, visit: https://bytex.work/docs'));
-console.log('');