superso-js-sdk 1.0.1

package/dist/storage/storage.js

@@ -0,0 +1,260 @@
+// ======================================
+// REQUEST
+// ======================================
+async function request(client, endpoint, method = "GET", body, token, isFormData = false) {
+    const headers = {
+        "X-Superso-Project-Key": client.apiKey,
+    };
+    if (!isFormData) {
+        headers["Content-Type"] =
+            "application/json";
+    }
+    if (token) {
+        headers["Authorization"] =
+            `Bearer ${token}`;
+    }
+    const response = await fetch(`${client.baseUrl}/api/project/${client.projectId}${endpoint}`, {
+        method,
+        headers,
+        body,
+    });
+    let data = {};
+    try {
+        data =
+            await response.json();
+    }
+    catch (_a) {
+        data = {};
+    }
+    if (!response.ok) {
+        throw new Error((data === null || data === void 0 ? void 0 : data.message) ||
+            `Storage request failed (${response.status})`);
+    }
+    return data;
+}
+// ======================================
+// UPLOAD FILE
+// ======================================
+export async function uploadFile(client, file, options) {
+    validateFile(file);
+    return new Promise((resolve, reject) => {
+        const xhr = new XMLHttpRequest();
+        const formData = new FormData();
+        formData.append("file", file);
+        if (options === null || options === void 0 ? void 0 : options.path) {
+            formData.append("path", options.path);
+        }
+        if (options === null || options === void 0 ? void 0 : options.alt_text) {
+            formData.append("alt_text", options.alt_text);
+        }
+        if (options === null || options === void 0 ? void 0 : options.caption) {
+            formData.append("caption", options.caption);
+        }
+        xhr.open("POST", `${client.baseUrl}/api/project/${client.projectId}/storage/upload`);
+        xhr.setRequestHeader("X-Superso-Project-Key", client.apiKey);
+        if (options === null || options === void 0 ? void 0 : options.token) {
+            xhr.setRequestHeader("Authorization", `Bearer ${options.token}`);
+        }
+        // progress
+        xhr.upload.onprogress =
+            (event) => {
+                if (event.lengthComputable &&
+                    (options === null || options === void 0 ? void 0 : options.onProgress)) {
+                    const percent = Math.round((event.loaded /
+                        event.total) * 100);
+                    options.onProgress(percent);
+                }
+            };
+        xhr.onload =
+            () => {
+                try {
+                    const data = JSON.parse(xhr.responseText);
+                    if (xhr.status >= 200 &&
+                        xhr.status < 300) {
+                        resolve(data);
+                    }
+                    else {
+                        reject(new Error((data === null || data === void 0 ? void 0 : data.message) ||
+                            "Upload failed"));
+                    }
+                }
+                catch (error) {
+                    reject(error);
+                }
+            };
+        xhr.onerror =
+            () => {
+                reject(new Error("Network error"));
+            };
+        xhr.send(formData);
+    });
+}
+// ======================================
+// BATCH UPLOAD
+// ======================================
+export async function uploadFiles(client, files, options) {
+    return Promise.all(files.map((file) => uploadFile(client, file, options)));
+}
+// ======================================
+// LIST ASSETS
+// ======================================
+export async function listAssets(client, token) {
+    return request(client, "/storage/assets", "GET", undefined, token);
+}
+// ======================================
+// LIST FILES ALIAS
+// ======================================
+export async function listFiles(client, token) {
+    return request(client, "/storage/files", "GET", undefined, token);
+}
+// ======================================
+// GET ASSET
+// ======================================
+export async function getAsset(client, assetId, token) {
+    return request(client, `/storage/assets/${assetId}`, "GET", undefined, token);
+}
+// ======================================
+// DELETE ASSET
+// ======================================
+export async function deleteAsset(client, assetId, token) {
+    return request(client, `/storage/assets/${assetId}`, "DELETE", undefined, token);
+}
+// ======================================
+// DELETE FILE ALIAS
+// ======================================
+export async function deleteFile(client, assetId, token) {
+    return request(client, `/storage/files/${assetId}`, "DELETE", undefined, token);
+}
+// ======================================
+// REMOVE FILE ROOT ALIAS
+// ======================================
+export async function removeFile(client, assetId, token) {
+    return request(client, `/storage/${assetId}`, "DELETE", undefined, token);
+}
+// ======================================
+// STORAGE USAGE
+// ======================================
+export async function getStorageUsage(client, token) {
+    return request(client, "/storage/usage", "GET", undefined, token);
+}
+// ======================================
+// FILE HELPERS
+// ======================================
+export function getFileExtension(fileName) {
+    var _a;
+    return (_a = fileName
+        .split(".")
+        .pop()) === null || _a === void 0 ? void 0 : _a.toLowerCase();
+}
+export function formatBytes(bytes, decimals = 2) {
+    if (bytes === 0) {
+        return "0 Bytes";
+    }
+    const k = 1024;
+    const dm = decimals < 0
+        ? 0
+        : decimals;
+    const sizes = [
+        "Bytes",
+        "KB",
+        "MB",
+        "GB",
+        "TB",
+    ];
+    const i = Math.floor(Math.log(bytes) /
+        Math.log(k));
+    return (parseFloat((bytes /
+        Math.pow(k, i)).toFixed(dm)) +
+        " " +
+        sizes[i]);
+}
+// ======================================
+// MIME HELPERS
+// ======================================
+export function isImage(mimeType) {
+    return mimeType.startsWith("image/");
+}
+export function isVideo(mimeType) {
+    return mimeType.startsWith("video/");
+}
+export function isAudio(mimeType) {
+    return mimeType.startsWith("audio/");
+}
+export function isPDF(mimeType) {
+    return mimeType ===
+        "application/pdf";
+}
+export function isDocument(mimeType) {
+    return (mimeType.includes("document") ||
+        mimeType.includes("word") ||
+        mimeType.includes("sheet") ||
+        mimeType.includes("excel") ||
+        mimeType.includes("presentation") ||
+        mimeType.includes("powerpoint"));
+}
+// ======================================
+// FILE VALIDATION
+// ======================================
+export function validateFile(file) {
+    if (!file) {
+        throw new Error("File is required");
+    }
+    if (file.size <= 0) {
+        throw new Error("Invalid file");
+    }
+    return true;
+}
+// ======================================
+// CLOUDINARY HELPERS
+// ======================================
+export function optimizeImage(url) {
+    return url.replace("/upload/", "/upload/q_auto/");
+}
+export function convertToWebP(url) {
+    return url.replace("/upload/", "/upload/f_webp/");
+}
+export function resizeImage(url, width, height) {
+    const transform = height
+        ? `w_${width},h_${height},c_fill`
+        : `w_${width}`;
+    return url.replace("/upload/", `/upload/${transform}/`);
+}
+export function thumbnail(url, size = 150) {
+    return url.replace("/upload/", `/upload/w_${size},h_${size},c_thumb/`);
+}
+export function cropImage(url, width, height) {
+    return url.replace("/upload/", `/upload/w_${width},h_${height},c_crop/`);
+}
+export function blurImage(url) {
+    return url.replace("/upload/", "/upload/e_blur:300/");
+}
+export function grayscaleImage(url) {
+    return url.replace("/upload/", "/upload/e_grayscale/");
+}
+export function autoQuality(url) {
+    return url.replace("/upload/", "/upload/q_auto/");
+}
+export function autoFormat(url) {
+    return url.replace("/upload/", "/upload/f_auto/");
+}
+// ======================================
+// URL HELPERS
+// ======================================
+export function getSecureUrl(asset) {
+    return (asset.secure_url ||
+        asset.url);
+}
+export function getPublicUrl(asset) {
+    return asset.url;
+}
+// ======================================
+// PRIVATE FILE READY HELPERS
+// ======================================
+export function buildAuthenticatedUrl(cloudName, publicId) {
+    return;
+    `https://res.cloudinary.com/${cloudName}/image/authenticated/${publicId}`;
+}
+export function buildPrivateUrl(cloudName, publicId) {
+    return;
+    `https://res.cloudinary.com/${cloudName}/image/private/${publicId}`;
+}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "superso-js-sdk",
+  "version": "1.0.1",
+  "description": "Official Superso JavaScript SDK",
+
+  "type": "module",
+
+  "main": "dist/index.js",
+
+  "types": "dist/index.d.ts",
+
+  "module": "dist/index.js",
+
+  "files": [
+    "dist"
+  ],
+
+  "scripts": {
+    "build": "tsc"
+  },
+
+  "keywords": [
+    "superso",
+    "sdk",
+    "backend",
+    "database",
+    "auth",
+    "realtime",
+    "storage",
+    "notifications",
+    "ai"
+  ],
+
+  "author": "Abdullahi",
+
+  "license": "MIT",
+
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/superso/sdk"
+  },
+
+  "homepage": "https://superso.com",
+
+  "bugs": {
+    "url": "https://github.com/superso/sdk/issues"
+  },
+
+  "publishConfig": {
+    "access": "public"
+  },
+
+  "devDependencies": {
+    "typescript": "^6.0.3"
+  }
+}