@cellarnode/ui 0.199.0 → 0.200.0

package/dist/upload-link/use-upload-link.js

@@ -0,0 +1,155 @@
+import * as React from "react";
+import { DEFAULT_CONSTRAINTS, formatBytes } from "./copy.js";
+import { fmt, TYPE_NAMES } from "./copy.js";
+import { initialPhase, isTerminal, reduce } from "./flow.js";
+import { UploadLinkApiError, } from "./types.js";
+const asApiError = (e) => e instanceof UploadLinkApiError
+    ? e
+    : new UploadLinkApiError(0, "NETWORK", "The connection failed.");
+/** Network and flow wiring for the upload page. Returns the current phase and the actions the person can take. */
+export function useUploadLink({ linkId, client, auth, copy, pollIntervalMs = 2000, constraints, }) {
+    const [phase, dispatch] = React.useReducer(reduce, initialPhase);
+    const abortRef = React.useRef(null);
+    // Two fast selections (a double drop, a second pick before the first renders) must not redeem twice.
+    const busyRef = React.useRef(false);
+    // Leaving the page stops an upload in flight.
+    React.useEffect(() => () => abortRef.current?.abort(), []);
+    const [attempt, setAttempt] = React.useState(0);
+    React.useEffect(() => {
+        dispatch({ type: "auth", auth });
+    }, [auth]);
+    // Read the link once the host says the person is signed in (and again on "try again").
+    React.useEffect(() => {
+        if (auth !== "signed-in")
+            return;
+        const controller = new AbortController();
+        client
+            .getStatus(linkId, controller.signal)
+            .then((link) => dispatch({ type: "status", link }))
+            .catch((e) => {
+            if (controller.signal.aborted)
+                return;
+            dispatch({ type: "status-error", error: asApiError(e) });
+        });
+        return () => controller.abort();
+    }, [auth, client, linkId, attempt]);
+    // Follow the processing view until the backend says it is over.
+    const processing = phase.kind === "processing";
+    React.useEffect(() => {
+        if (!processing)
+            return;
+        let failures = 0;
+        const polling = new AbortController();
+        const id = setInterval(() => {
+            client
+                .getStatus(linkId, polling.signal)
+                .then((link) => {
+                if (polling.signal.aborted)
+                    return;
+                failures = 0;
+                dispatch({ type: "status", link });
+            })
+                .catch((e) => {
+                if (polling.signal.aborted)
+                    return;
+                failures += 1;
+                // A few dropped polls are normal on a phone; keep going, then say so.
+                if (failures >= 5)
+                    dispatch({ type: "status-error", error: asApiError(e) });
+            });
+        }, pollIntervalMs);
+        return () => {
+            clearInterval(id);
+            polling.abort();
+        };
+    }, [processing, client, linkId, pollIntervalMs]);
+    const limitsFor = React.useCallback((purpose) => ({
+        ...DEFAULT_CONSTRAINTS[purpose],
+        ...constraints?.[purpose],
+    }), [constraints]);
+    const run = React.useCallback(async (file) => {
+        dispatch({ type: "upload-start", fileName: file.name });
+        const controller = new AbortController();
+        abortRef.current = controller;
+        let handle;
+        try {
+            handle = await client.redeem(linkId, {
+                fileName: file.name,
+                mimeType: file.type,
+                sizeBytes: file.size,
+            }, controller.signal);
+        }
+        catch (e) {
+            // Cancelled while the declaration was in flight: the server may have claimed the link, so it ends as cancelled.
+            if (controller.signal.aborted)
+                return dispatch({ type: "upload-error", code: "CANCELLED" });
+            const error = asApiError(e);
+            // Never the server's own sentence: a stable, translated line per code.
+            const message = error.status === 429
+                ? copy.errorTooMany
+                : error.code === "UPLOAD_LINK_TARGET_INVALID"
+                    ? copy.errorTargetInvalid
+                    : error.code === "UPLOAD_LINK_FILE_NOT_ALLOWED"
+                        ? copy.errorFileNotAllowed
+                        : copy.errorGeneric;
+            return dispatch({ type: "redeem-error", error, message });
+        }
+        if (controller.signal.aborted)
+            return dispatch({ type: "upload-error", code: "CANCELLED" });
+        try {
+            await client.upload(handle, file, (progress) => dispatch({ type: "upload-progress", progress }), controller.signal);
+        }
+        catch (e) {
+            if (e instanceof DOMException && e.name === "AbortError")
+                return dispatch({ type: "upload-error", code: "CANCELLED" });
+            return dispatch({ type: "upload-error", code: asApiError(e).code });
+        }
+        dispatch({ type: "uploaded" });
+        try {
+            const link = await client.start(linkId);
+            dispatch({ type: "status", link });
+        }
+        catch (e) {
+            // The bytes are in; the poll below (or the next read) reports what happened. Only a hard refusal ends it here.
+            const error = asApiError(e);
+            if (error.status === 409 || error.status === 503)
+                dispatch({ type: "upload-error", code: error.code });
+        }
+    }, [client, copy, linkId]);
+    const chooseFile = React.useCallback(async (file) => {
+        const current = phase;
+        if (current.kind !== "ready" || busyRef.current)
+            return;
+        const limits = limitsFor(current.link.purpose);
+        if (file.size <= 0)
+            return dispatch({ type: "file-invalid", message: copy.errorEmpty });
+        if (file.size > limits.maxBytes)
+            return dispatch({
+                type: "file-invalid",
+                message: fmt(copy.errorTooBig, { size: formatBytes(limits.maxBytes) }),
+            });
+        if (!limits.allowedTypes.includes(file.type)) {
+            const types = limits.allowedTypes.map((t) => TYPE_NAMES[t] ?? t).join(", ");
+            return dispatch({ type: "file-invalid", message: fmt(copy.errorWrongType, { types }) });
+        }
+        busyRef.current = true;
+        try {
+            await run(file);
+        }
+        finally {
+            busyRef.current = false;
+        }
+    }, [copy, limitsFor, phase, run]);
+    return {
+        phase,
+        terminal: isTerminal(phase),
+        chooseFile,
+        cancel: () => abortRef.current?.abort(),
+        retry: () => {
+            dispatch({ type: "reset" });
+            setAttempt((n) => n + 1);
+        },
+        limitsFor,
+    };
+}
+//# sourceMappingURL=use-upload-link.js.map

package/dist/upload-link/use-upload-link.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cellarnode/ui",
-  "version": "0.199.0",
+  "version": "0.200.0",
   "type": "module",
   "private": false,
   "packageManager": "pnpm@10.28.2+sha512.41872f037ad22f7348e3b1debbaf7e867cfd448f2726d9cf74c08f19507c31d2c8e7a11525b983febc2df640b5438dee6023ebb1f84ed43cc2d654d2bc326264",
@@ -33,6 +33,10 @@
       "types": "./dist/agentic-orb/index.d.ts",
       "default": "./dist/agentic-orb/index.js"
     },
+    "./upload-link": {
+      "types": "./dist/upload-link/index.d.ts",
+      "default": "./dist/upload-link/index.js"
+    },
     "./agent": {
       "types": "./dist/agent/index.d.ts",
       "default": "./dist/agent/index.js"