@seam-rpc/client 1.1.1 → 2.0.0

package/README.md

@@ -142,3 +142,19 @@ export async function updateUser(userId: string, userData: UserData): Promise<vo
 - The generated client files contain all imports from the api implementation file in the backend that import from the current relative folder (`./`). This is the simplest way I have to include imports (at least for now). It may import functions and unused symbols but that shouldn't be too worrying.
 - Don't include backend/server functions inside the server api files.
 - Only exported functions will be included in the client generated files.
+
+## Supported types
+SeamRPC supports the following types (at least for now):
+- string
+- number
+- boolean
+- array
+- object
+- null
+- undefined
+
+Classes are technically supported, in that the data is serialized to JSON.
+
+Other JavaScript types are not supported, although SeamRPC doesn't prevent you from using them, in which case they might lead to unexpected beahviour or even errors.
+
+The Date object type is not supported (at least for now). However, you can use `number` and pass `Date.now()` or `string` and pass `new Date().toString()`. This is not different than a normal HTTP request using JSON. SeamRPC also uses JSON behind the scenes, that's why there's these limitations, which could be overcome but I've decided not to because it would probably add more overhead to the logic.

package/dist/index.js

@@ -0,0 +1,78 @@
+import { SeamFile, extractFiles, injectFiles } from "@seam-rpc/core";
+export { SeamFile };
+let apiUrl = null;
+export function setApiUrl(url) {
+    apiUrl = url;
+}
+export async function callApi(routerName, funcName, args) {
+    if (!apiUrl)
+        throw new Error("Missing API URL");
+    let req;
+    const { json, files, paths } = extractFiles(args);
+    if (files.length > 0) {
+        const formData = new FormData();
+        formData.append("json", JSON.stringify(json));
+        formData.append("paths", JSON.stringify(paths));
+        for (let i = 0; i < files.length; i++) {
+            const file = files[i];
+            const blob = new Blob([new Uint8Array(file.data)], {
+                type: file.mimeType || "application/octet-stream",
+            });
+            formData.append(`file-${i}`, blob, file.fileName || `file-${i}`);
+        }
+        req = {
+            method: "POST",
+            body: formData,
+        };
+    }
+    else {
+        req = {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(args),
+        };
+    }
+    const url = `${apiUrl}/${routerName}/${funcName}`;
+    let res;
+    try {
+        res = await fetch(url, req);
+    }
+    catch (err) {
+        console.log(url, req, err);
+        throw new Error("Failed to send request.\n" + err);
+    }
+    if (!res.ok) {
+        if (res.status == 400) {
+            const resError = await res.json();
+            throw new Error(resError.error);
+        }
+        throw new Error(`Request failed with status ${res.status} ${res.statusText}.`);
+    }
+    const contentType = res.headers.get("content-type") || "";
+    if (contentType.startsWith("application/json")) {
+        const data = await res.json();
+        return data.result;
+    }
+    else if (contentType.startsWith("multipart/form-data")) {
+        const formData = await res.formData();
+        const jsonPart = JSON.parse(formData.get("json")?.toString() || "[]");
+        const pathsPart = JSON.parse(formData.get("paths")?.toString() || "[]");
+        const responseFiles = [];
+        for (const [key, value] of formData.entries()) {
+            if (key.startsWith("file-")) {
+                const index = parseInt(key.replace("file-", ""));
+                const blob = value;
+                const arrayBuffer = await blob.arrayBuffer();
+                responseFiles.push({
+                    path: pathsPart[index],
+                    file: new SeamFile(new Uint8Array(arrayBuffer), blob.name, blob.type),
+                });
+            }
+        }
+        injectFiles(jsonPart, responseFiles);
+        return jsonPart.result;
+    }
+}
+// console.log(JSON.stringify(extractFiles(["John", new SeamFile(new Uint8Array([1, 2, 3, 4]))]), null, 4))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seam-rpc/client",
-  "version": "1.1.1",
+  "version": "2.0.0",
   "main": "./dist/index.js",
   "type": "module",
   "files": [