@peers-app/peers-ui 0.29.1 → 0.29.2

package/dist/hooks/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./use-file-url";
 export * from "./use-observable";
 export * from "./use-observable-state";
 export * from "./use-on-screen";

package/dist/hooks/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 // `use-host-contract` stays internal: its screens import it by path.
+__exportStar(require("./use-file-url"), exports);
 __exportStar(require("./use-observable"), exports);
 __exportStar(require("./use-observable-state"), exports);
 __exportStar(require("./use-on-screen"), exports);

package/dist/hooks/use-file-url.d.ts

@@ -0,0 +1,23 @@
+/** What {@link useFileUrl} returns. */
+export interface IUseFileUrlResult {
+    /** An object URL for the file, such as an `<img src>`. Undefined until it's read. */
+    url: string | undefined;
+    /** True while the file is being read. */
+    loading: boolean;
+    /** Why the file couldn't be read: not found, or not on any connected device. */
+    error: Error | undefined;
+}
+/**
+ * Read a file saved with System Files and give a URL for it, for an image or a download link.
+ *
+ * ```tsx
+ * const avatar = useFileUrl(member.imageFileId);
+ * {avatar.url ? <img src={avatar.url} alt="" /> : <Initials />}
+ * ```
+ *
+ * Reads through `hostContract(SystemFiles)` in the screen's data context, the active group.
+ * The URL is revoked when the file id changes or the component unmounts, so don't keep it.
+ *
+ * @param fileId - The file's id; nothing is read while it's undefined.
+ */
+export declare function useFileUrl(fileId: string | undefined): IUseFileUrlResult;

package/dist/hooks/use-file-url.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useFileUrl = useFileUrl;
+const peers_sdk_1 = require("@peers-app/peers-sdk");
+const react_1 = require("react");
+/**
+ * Read a file saved with System Files and give a URL for it, for an image or a download link.
+ *
+ * ```tsx
+ * const avatar = useFileUrl(member.imageFileId);
+ * {avatar.url ? <img src={avatar.url} alt="" /> : <Initials />}
+ * ```
+ *
+ * Reads through `hostContract(SystemFiles)` in the screen's data context, the active group.
+ * The URL is revoked when the file id changes or the component unmounts, so don't keep it.
+ *
+ * @param fileId - The file's id; nothing is read while it's undefined.
+ */
+function useFileUrl(fileId) {
+    const [state, setState] = (0, react_1.useState)({
+        url: undefined,
+        loading: !!fileId,
+        error: undefined,
+    });
+    (0, react_1.useEffect)(() => {
+        if (!fileId) {
+            setState({ url: undefined, loading: false, error: undefined });
+            return;
+        }
+        let ended = false;
+        let url;
+        setState({ url: undefined, loading: true, error: undefined });
+        const files = (0, peers_sdk_1.hostContract)(peers_sdk_1.SystemFiles);
+        (0, peers_sdk_1.readWholeFile)((input) => files.tools.read(input), fileId).then(({ bytes, mimeType }) => {
+            if (ended)
+                return;
+            url = URL.createObjectURL(new Blob([bytes], mimeType ? { type: mimeType } : undefined));
+            setState({ url, loading: false, error: undefined });
+        }, (error) => {
+            if (ended)
+                return;
+            const reason = error instanceof Error ? error : new Error(String(error));
+            setState({ url: undefined, loading: false, error: reason });
+        });
+        return () => {
+            ended = true;
+            if (url)
+                URL.revokeObjectURL(url);
+        };
+    }, [fileId]);
+    return state;
+}

package/dist/ui-router/bundle-files.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Read a package's UI or routes bundle as text, through System Files in the context its
+ * version is installed in.
+ *
+ * @param dataContextId - Context of the selected package version.
+ * @param fileId - The bundle's file id.
+ */
+export declare function readBundleText(dataContextId: string, fileId: string): Promise<string>;

package/dist/ui-router/bundle-files.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readBundleText = readBundleText;
+const peers_sdk_1 = require("@peers-app/peers-sdk");
+const clients = new Map();
+/** System Files on the local host, scoped to one data context; one client per context. */
+function filesIn(dataContextId) {
+    let client = clients.get(dataContextId);
+    if (!client) {
+        client = (0, peers_sdk_1.hostContract)(peers_sdk_1.SystemFiles, { dataContextId: async () => dataContextId });
+        clients.set(dataContextId, client);
+    }
+    return client;
+}
+// Keep a leading BOM, as Buffer's UTF-8 decoding did, so bundle integrity hashes still match.
+const decoder = new TextDecoder("utf-8", { ignoreBOM: true });
+/**
+ * Read a package's UI or routes bundle as text, through System Files in the context its
+ * version is installed in.
+ *
+ * @param dataContextId - Context of the selected package version.
+ * @param fileId - The bundle's file id.
+ */
+async function readBundleText(dataContextId, fileId) {
+    const files = filesIn(dataContextId);
+    const { bytes } = await (0, peers_sdk_1.readWholeFile)((input) => files.tools.read(input), fileId);
+    return decoder.decode(bytes);
+}

package/dist/ui-router/routes-loader.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadAllRoutes = exports.allPackages = void 0;
 const peers_sdk_1 = require("@peers-app/peers-sdk");
 require("../ui-defaults");
+const bundle_files_1 = require("./bundle-files");
 const runnable_version_1 = require("./runnable-version");
 /** Packages with authorized navigation metadata available in the current context. */
 exports.allPackages = (0, peers_sdk_1.observable)([]);
@@ -102,8 +103,8 @@ function loadRoutesBundle(pkg, forceRefresh) {
                 const selected = await (0, runnable_version_1.resolveRunnableVersion)(pkg);
                 const routesBundleFileId = selected?.pv.routesBundleFileId;
                 let bundleCode = "";
-                if (routesBundleFileId) {
-                    bundleCode = await peers_sdk_1.rpcServerCalls.getFileContents(routesBundleFileId);
+                if (selected && routesBundleFileId) {
+                    bundleCode = await (0, bundle_files_1.readBundleText)(selected.dataContext.dataContextId, routesBundleFileId);
                 }
                 if (bundleCode) {
                     if (selected?.dataContext.groupId)

package/dist/ui-router/ui-loader.js

@@ -43,6 +43,7 @@ const loading_indicator_1 = require("../components/loading-indicator");
 const globals_1 = require("../globals");
 const hooks_1 = require("../hooks");
 require("../ui-defaults");
+const bundle_files_1 = require("./bundle-files");
 const routes_loader_1 = require("./routes-loader");
 const runnable_version_1 = require("./runnable-version");
 const peersUIs = {};
@@ -194,7 +195,7 @@ function loadUIBundle(pkg, forceRefresh) {
             if (!selected || !uiBundleFileId) {
                 return;
             }
-            const bundleCode = await peers_sdk_1.rpcServerCalls.getFileContents(uiBundleFileId);
+            const bundleCode = await (0, bundle_files_1.readBundleText)(selected.dataContext.dataContextId, uiBundleFileId);
             if (bundleCode) {
                 if (selected.dataContext.groupId)
                     (0, peers_sdk_1.assertPackageBundleIntegrity)(selected.pv, "ui", bundleCode);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peers-app/peers-ui",
-  "version": "0.29.1",
+  "version": "0.29.2",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/peers-app/peers-ui.git"
@@ -36,7 +36,7 @@
     "lint:fix": "biome check --write ."
   },
   "peerDependencies": {
-    "@peers-app/peers-sdk": "^0.29.1",
+    "@peers-app/peers-sdk": "^0.29.2",
     "bootstrap": "^5.3.3",
     "react": "^18.0.0",
     "react-dom": "^18.0.0"
@@ -47,7 +47,7 @@
     "@babel/preset-react": "^7.24.1",
     "@babel/preset-typescript": "^7.27.1",
     "@biomejs/biome": "2.3.11",
-    "@peers-app/peers-sdk": "0.29.1",
+    "@peers-app/peers-sdk": "0.29.2",
     "@testing-library/dom": "^10.4.0",
     "@testing-library/jest-dom": "^6.6.3",
     "@testing-library/react": "^16.3.0",