@qmuse/cloud-client 0.0.1-dev.0

package/dist/web.js

@@ -0,0 +1,146 @@
+import { QmuseCloudHttpError } from './errors.js';
+const DEFAULT_CHUNK_SIZE = 5 * 1024 * 1024;
+function requireBlob(file) {
+    if (!file || !Number.isInteger(file.size) || file.size < 0 || typeof file.slice !== 'function') {
+        throw new TypeError('file must be a File or Blob');
+    }
+    return file;
+}
+function fileName(file, override) {
+    if (override?.trim())
+        return override.trim();
+    if ('name' in file && typeof file.name === 'string' && file.name.trim())
+        return file.name.trim();
+    return 'upload';
+}
+function withoutContentType(headers) {
+    return Object.fromEntries(Object.entries(headers).filter(([name]) => name.toLowerCase() !== 'content-type'));
+}
+function chunkProgress(target, size, chunkSize, uploaded) {
+    const chunksTotal = Math.max(1, Math.ceil(size / chunkSize));
+    return {
+        fileId: target.fileId,
+        progress: size === 0 ? 100 : Math.min(100, Math.round((uploaded / size) * 100)),
+        sizeUploaded: uploaded,
+        chunksTotal,
+        chunksUploaded: uploaded >= size ? chunksTotal : Math.min(chunksTotal, Math.floor(uploaded / chunkSize)),
+    };
+}
+async function readJson(response) {
+    const text = await response.text();
+    if (!text)
+        return {};
+    try {
+        const value = JSON.parse(text);
+        return value && typeof value === 'object' && !Array.isArray(value)
+            ? value
+            : { value };
+    }
+    catch {
+        return { message: text };
+    }
+}
+export function createWebFileTransport(capabilities) {
+    if (!capabilities || typeof capabilities.fetch !== 'function' || typeof capabilities.FormData !== 'function') {
+        throw new TypeError('Web file capabilities require fetch and FormData');
+    }
+    return {
+        describe(file, overrides = {}) {
+            const source = requireBlob(file);
+            const mimeType = overrides.mimeType ?? (source.type || undefined);
+            return {
+                name: fileName(source, overrides.name),
+                size: source.size,
+                ...(mimeType ? { mimeType } : {}),
+            };
+        },
+        async upload({ target, file, onProgress }) {
+            const source = requireBlob(file);
+            const chunkSize = target.chunkSize ?? DEFAULT_CHUNK_SIZE;
+            if (!Number.isInteger(chunkSize) || chunkSize < 1)
+                throw new TypeError('upload chunkSize must be a positive integer');
+            const chunksTotal = Math.max(1, Math.ceil(source.size / chunkSize));
+            let storageId;
+            let metadata = {};
+            let lastUploaded = -1;
+            const emit = (uploaded) => {
+                if (!onProgress || uploaded === lastUploaded)
+                    return;
+                lastUploaded = uploaded;
+                onProgress(chunkProgress(target, source.size, chunkSize, uploaded));
+            };
+            for (let start = 0; start < Math.max(source.size, 1); start += chunkSize) {
+                const end = source.size === 0 ? 0 : Math.min(source.size, start + chunkSize);
+                const body = chunksTotal > 1 ? source.slice(start, end) : source;
+                const form = new capabilities.FormData();
+                for (const [key, value] of Object.entries(target.formData ?? {}))
+                    form.append(key, value);
+                if (!form.has('fileId'))
+                    form.append('fileId', target.fileId);
+                form.append(target.fieldName ?? 'file', body, fileName(source));
+                const headers = withoutContentType({
+                    ...(capabilities.getSessionHeaders?.() ?? {}),
+                    ...(target.headers ?? {}),
+                    ...(storageId ? { 'X-Appwrite-ID': storageId } : {}),
+                    ...(chunksTotal > 1 ? { 'Content-Range': `bytes ${start}-${end - 1}/${source.size}` } : {}),
+                });
+                const response = await capabilities.fetch(target.url, {
+                    method: 'POST',
+                    credentials: 'include',
+                    headers,
+                    body: form,
+                });
+                capabilities.observeResponseHeaders?.(response.headers);
+                metadata = await readJson(response);
+                if (!response.ok) {
+                    throw new QmuseCloudHttpError({
+                        status: response.status,
+                        code: 'STORAGE_UPLOAD_FAILED',
+                        message: typeof metadata.message === 'string'
+                            ? metadata.message
+                            : `Storage upload failed with status ${response.status}`,
+                        details: metadata,
+                    });
+                }
+                const responseId = metadata.$id ?? metadata.id;
+                if (typeof responseId === 'string' && responseId)
+                    storageId = responseId;
+                storageId ??= target.fileId;
+                emit(end);
+                if (source.size === 0)
+                    break;
+            }
+            return { fileId: storageId ?? target.fileId, metadata };
+        },
+        async createReadableUrl({ url, headers }) {
+            const response = await capabilities.fetch(url, {
+                method: 'GET',
+                credentials: 'include',
+                headers: { ...(capabilities.getSessionHeaders?.() ?? {}), ...(headers ?? {}) },
+            });
+            capabilities.observeResponseHeaders?.(response.headers);
+            if (!response.ok) {
+                throw new QmuseCloudHttpError({
+                    status: response.status,
+                    code: 'STORAGE_READ_FAILED',
+                    message: `Storage read failed with status ${response.status}`,
+                });
+            }
+            const blob = await response.blob();
+            const createObjectURL = capabilities.createObjectURL ?? URL.createObjectURL.bind(URL);
+            const revokeObjectURL = capabilities.revokeObjectURL ?? URL.revokeObjectURL.bind(URL);
+            const objectUrl = createObjectURL(blob);
+            let active = true;
+            return {
+                url: objectUrl,
+                dispose() {
+                    if (!active)
+                        return;
+                    active = false;
+                    revokeObjectURL(objectUrl);
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=web.js.map

package/dist/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../src/web.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@qmuse/cloud-client",
+  "version": "0.0.1-dev.0",
+  "description": "Narrow HTTP-style client for the single QMuse Cloud API Function",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./web": {
+      "types": "./dist/web.d.ts",
+      "import": "./dist/web.js"
+    },
+    "./miniapp": {
+      "types": "./dist/miniapp.d.ts",
+      "import": "./dist/miniapp.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LEGAL.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc -p tsconfig.json --noEmit",
+    "ci": "npm run check && npm test",
+    "publish:public": "bash scripts/publish-public.sh",
+    "test": "npm run build && node --test test/*.test.mjs",
+    "prepublishOnly": "npm test"
+  },
+  "devDependencies": {
+    "typescript": "~5.9.3"
+  },
+  "engines": {
+    "node": ">=18.19.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "ci": {
+    "type": "aci"
+  },
+  "libType": "UTIL",
+  "tnpm": {
+    "mode": "npm"
+  }
+}