@ttt-productions/upload-ui 0.2.0

package/dist/react/in-flight-uploads-provider.js

@@ -0,0 +1,286 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Generic in-flight uploads provider.
+ *
+ * Provides a global Map of in-flight upload state by `pendingMediaId`, derived
+ * from a Firestore listener over the consumer-supplied collection. On terminal
+ * status transitions observed THIS SESSION, fires consumer-supplied success /
+ * failure / rejection callbacks. Records monitoring breadcrumbs and parse
+ * errors through the injected monitoring callback.
+ *
+ * EVERY TTT-specific value is supplied by the consumer:
+ *  - userId resolution
+ *  - Firestore `db` reference
+ *  - collection path
+ *  - listener time window (ms)
+ *  - parser/schema for raw Firestore doc → typed PendingMedia
+ *  - success copy per origin
+ *  - notification callback (cache invalidation, etc.)
+ *  - toast callback
+ *  - rejection callback (for the media-rejection dialog or equivalent)
+ *  - monitoring callback (breadcrumbs + captured errors)
+ *
+ * Read APIs:
+ *  - `useInFlightUploadsState()` — full Map.
+ *  - `useInFlightUpload(id)` — single doc, narrowable on status.
+ *  - `useUploadActivityState()` — tray-visible items, sorted newest-first.
+ *
+ * The package owns the deduplication, initial-snapshot suppression, and
+ * non-terminal → terminal transition tracking. It does NOT own anything about
+ * what a file-origin is or what message text appears in toasts.
+ */
+import { createContext, useContext, useEffect, useMemo, useRef, useState, } from 'react';
+const InFlightUploadsContext = createContext(undefined);
+function fromParsed(parsed) {
+    const base = {
+        id: parsed.id,
+        fileOrigin: parsed.fileOrigin,
+        surface: parsed.surface,
+        createdAt: parsed.createdAt,
+        targetIds: parsed.targetIds,
+    };
+    if (parsed.status === 'pending' || parsed.status === 'processing') {
+        return { ...base, status: parsed.status };
+    }
+    if (parsed.status === 'completed') {
+        return {
+            ...base,
+            status: 'completed',
+            completedAt: parsed.completedAt ?? parsed.createdAt,
+            uploadTrayClearedAt: parsed.uploadTrayClearedAt,
+            uploadTrayClearedBy: parsed.uploadTrayClearedBy,
+        };
+    }
+    if (parsed.status === 'failed') {
+        return {
+            ...base,
+            status: 'failed',
+            failedAt: parsed.failedAt ?? parsed.createdAt,
+            errorCategory: parsed.errorCategory ?? 'system',
+            errorMessage: parsed.errorMessage ?? '',
+            uploadTrayClearedAt: parsed.uploadTrayClearedAt,
+            uploadTrayClearedBy: parsed.uploadTrayClearedBy,
+        };
+    }
+    // rejected
+    return {
+        ...base,
+        status: 'rejected',
+        rejectedAt: parsed.rejectedAt ?? parsed.createdAt,
+        rejectionType: parsed.rejectionType ?? 'media',
+        errorMessage: parsed.errorMessage ?? '',
+        violationId: parsed.violationId,
+        uploadTrayClearedAt: parsed.uploadTrayClearedAt,
+        uploadTrayClearedBy: parsed.uploadTrayClearedBy,
+    };
+}
+export function InFlightUploadsProvider(props) {
+    const { adapter, subscribe = defaultFirestoreSubscribe, children } = props;
+    const [uploads, setUploads] = useState(new Map());
+    const seenTerminalIdsRef = useRef(new Set());
+    const statusByIdRef = useRef(new Map());
+    const hasProcessedInitialSnapshotRef = useRef(false);
+    // Stable refs for adapter callbacks — read from latest adapter inside effect.
+    const adapterRef = useRef(adapter);
+    useEffect(() => {
+        adapterRef.current = adapter;
+    });
+    const userId = adapter.getCurrentUserId();
+    useEffect(() => {
+        if (!userId) {
+            // Sign-out: clear all state.
+            setUploads(new Map());
+            seenTerminalIdsRef.current = new Set();
+            statusByIdRef.current = new Map();
+            hasProcessedInitialSnapshotRef.current = false;
+            return;
+        }
+        const a = adapterRef.current;
+        const windowStartMs = Date.now() - a.listenerWindowMs;
+        const handleSnapshot = (snapshot) => {
+            const updates = [];
+            const newlyTerminal = [];
+            const isInitialSnapshot = !hasProcessedInitialSnapshotRef.current;
+            for (const change of snapshot.docChanges()) {
+                if (change.type === 'removed') {
+                    updates.push({ id: change.doc.id, upload: null });
+                    statusByIdRef.current.delete(change.doc.id);
+                    seenTerminalIdsRef.current.delete(change.doc.id);
+                    continue;
+                }
+                let parsed;
+                try {
+                    parsed = adapterRef.current.parsePendingMedia(change.doc.data());
+                }
+                catch (error) {
+                    adapterRef.current.onMonitoringEvent({
+                        type: 'parse-error',
+                        docId: change.doc.id,
+                        error,
+                        data: change.doc.data(),
+                    });
+                    continue;
+                }
+                const upload = fromParsed(parsed);
+                updates.push({ id: parsed.id, upload });
+                const previousStatus = statusByIdRef.current.get(parsed.id);
+                const currentStatus = parsed.status;
+                const currentIsTerminal = currentStatus === 'completed' ||
+                    currentStatus === 'failed' ||
+                    currentStatus === 'rejected';
+                const previousWasNonTerminal = previousStatus === 'pending' || previousStatus === 'processing';
+                if (isInitialSnapshot) {
+                    // First snapshot after mount: mark already-terminal docs as seen,
+                    // but DO NOT fire callbacks. Prevents duplicate toasts on refresh.
+                    if (currentIsTerminal) {
+                        seenTerminalIdsRef.current.add(parsed.id);
+                    }
+                }
+                else if (currentIsTerminal &&
+                    previousWasNonTerminal &&
+                    !seenTerminalIdsRef.current.has(parsed.id)) {
+                    seenTerminalIdsRef.current.add(parsed.id);
+                    newlyTerminal.push(parsed);
+                }
+                else if (currentIsTerminal) {
+                    // Terminal doc appeared without an observed non-terminal predecessor
+                    // (race in a non-initial snapshot). Mark as seen, no callback fire.
+                    seenTerminalIdsRef.current.add(parsed.id);
+                }
+                statusByIdRef.current.set(parsed.id, currentStatus);
+            }
+            hasProcessedInitialSnapshotRef.current = true;
+            if (updates.length > 0) {
+                setUploads((prev) => {
+                    const next = new Map(prev);
+                    for (const { id, upload } of updates) {
+                        if (upload === null)
+                            next.delete(id);
+                        else
+                            next.set(id, upload);
+                    }
+                    return next;
+                });
+            }
+            for (const parsed of newlyTerminal) {
+                handleTerminal(parsed);
+            }
+        };
+        function handleTerminal(parsed) {
+            adapterRef.current.onMonitoringEvent({
+                type: 'breadcrumb',
+                category: 'upload.terminal',
+                level: 'info',
+                message: `${parsed.fileOrigin}:${parsed.status}`,
+                data: {
+                    id: parsed.id,
+                    fileOrigin: parsed.fileOrigin,
+                    status: parsed.status,
+                    surface: parsed.surface,
+                },
+            });
+            if (parsed.status === 'completed') {
+                adapterRef.current.onUploadCompleted(parsed);
+            }
+            else if (parsed.status === 'failed') {
+                adapterRef.current.onUploadFailed(parsed);
+            }
+            else if (parsed.status === 'rejected') {
+                adapterRef.current.onUploadRejected(parsed);
+            }
+        }
+        const unsubscribe = subscribe({
+            db: a.db,
+            collectionPath: a.collectionPath,
+            userId,
+            windowStartMs,
+            onSnapshot: handleSnapshot,
+            onError: (error) => {
+                adapterRef.current.onMonitoringEvent({ type: 'listener-error', error });
+            },
+        });
+        return () => {
+            unsubscribe();
+        };
+        // adapter is intentionally NOT in the deps array — adapter is read via
+        // adapterRef on every snapshot, so identity changes don't re-subscribe.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [userId, subscribe]);
+    const value = useMemo(() => ({ uploads }), [uploads]);
+    return (_jsx(InFlightUploadsContext.Provider, { value: value, children: children }));
+}
+// =============================================================================
+// Read APIs
+// =============================================================================
+export function useInFlightUploadsState() {
+    const ctx = useContext(InFlightUploadsContext);
+    if (ctx === undefined) {
+        throw new Error('useInFlightUploadsState must be used within InFlightUploadsProvider');
+    }
+    return ctx.uploads;
+}
+export function useInFlightUpload(id) {
+    const ctx = useContext(InFlightUploadsContext);
+    if (ctx === undefined) {
+        throw new Error('useInFlightUpload must be used within InFlightUploadsProvider');
+    }
+    if (!id)
+        return undefined;
+    return ctx.uploads.get(id);
+}
+// =============================================================================
+// Tray helpers
+// =============================================================================
+/**
+ * `true` for `completed` / `failed` / `rejected`. Used by tray UI to decide
+ * whether a Clear action is available for an item.
+ */
+export function isTerminalUpload(item) {
+    return (item.status === 'completed' ||
+        item.status === 'failed' ||
+        item.status === 'rejected');
+}
+/**
+ * Tray-visible items. Includes every pending/processing upload, plus terminal
+ * uploads that have NOT been cleared from the tray. Sorted newest-first by
+ * createdAt.
+ *
+ * Renamed per F22: was `useUploadActivityTrayItems` in ttt-prod; the public
+ * selector name in upload-ui is `useUploadActivityState`. The mutation hook
+ * is `useClearUploadActivity` (in a separate file).
+ */
+export function useUploadActivityState() {
+    const uploads = useInFlightUploadsState();
+    return useMemo(() => {
+        return Array.from(uploads.values())
+            .filter((item) => {
+            if (!isTerminalUpload(item))
+                return true;
+            return item.uploadTrayClearedAt === undefined;
+        })
+            .sort((a, b) => b.createdAt - a.createdAt);
+    }, [uploads]);
+}
+// =============================================================================
+// Default Firestore subscription implementation
+// =============================================================================
+/**
+ * Default Firestore subscription. Imported lazily so tests can inject a fake
+ * `subscribe` and skip the firebase module load entirely.
+ *
+ * The dynamic import keeps the bundle clean: consumers who pass a custom
+ * `subscribe` (e.g. for tests or alternative backends) never pay for the
+ * firebase code path.
+ */
+const defaultFirestoreSubscribe = (args) => {
+    // Lazy require to keep firebase out of the synchronous module graph.
+    // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires
+    const firestore = require('firebase/firestore');
+    const { collection, onSnapshot, query, where } = firestore;
+    const q = query(
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    collection(args.db, args.collectionPath), where('userId', '==', args.userId), where('createdAt', '>=', args.windowStartMs));
+    return onSnapshot(q, args.onSnapshot, args.onError);
+};
+//# sourceMappingURL=in-flight-uploads-provider.js.map

package/dist/react/in-flight-uploads-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-flight-uploads-provider.js","sourceRoot":"","sources":["../../src/react/in-flight-uploads-provider.tsx"],"names":[],"mappings":"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"}

package/dist/react/index.d.ts

@@ -0,0 +1,11 @@
+export { LocalUploadGuardProvider, useLocalUploadGuard, useLocalUploadGuardContext, } from './local-upload-guard-provider.js';
+export { useGuardedUpload, type GuardedUploadArgs } from './use-guarded-upload.js';
+export { DeferredUploadFormShell, type DeferredUploadFormShellHandle, type DeferredUploadFormShellProps, } from './deferred-upload-form-shell.js';
+export { InFlightUploadsProvider, useInFlightUploadsState, useInFlightUpload, useUploadActivityState, isTerminalUpload, type InFlightUpload, type InFlightUploadActive, type InFlightUploadCompleted, type InFlightUploadFailed, type InFlightUploadRejected, type InFlightUploadBase, type InFlightUploadStatus, type InFlightUploadsAdapter, type InFlightUploadsMonitoringEvent, type InFlightUploadsProviderProps, type ParsedPendingMedia, type FirestoreSubscribeFn, type FirestoreLikeSnapshot, type FirestoreLikeDocChange, } from './in-flight-uploads-provider.js';
+export { useUploadProcessing, type UploadProcessingState, type UseUploadProcessingOptions, } from './use-upload-processing.js';
+export { useClearUploadActivity, type ClearUploadActivityOptions, } from './use-clear-upload-activity.js';
+export { useGuardedNavigation, } from './use-guarded-navigation.js';
+export { GuardedLink, type GuardedLinkProps, type GuardedLinkRenderArgs, } from './guarded-link.js';
+export { type LocalUploadGuardProviderProps, } from './local-upload-guard-provider.js';
+export { UploadActivityTray, type UploadActivityTrayProps, type ViewAllLinkRenderArgs, } from './upload-activity-tray.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACnF,OAAO,EACL,uBAAuB,EACvB,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,GAClC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,8BAA8B,EACnC,KAAK,4BAA4B,EACjC,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,GAC5B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,mBAAmB,EACnB,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,GAChC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,sBAAsB,EACtB,KAAK,0BAA0B,GAChC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,WAAW,EACX,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,KAAK,6BAA6B,GACnC,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,kBAAkB,EAClB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,GAC3B,MAAM,2BAA2B,CAAC"}

package/dist/react/index.js

@@ -0,0 +1,10 @@
+export { LocalUploadGuardProvider, useLocalUploadGuard, useLocalUploadGuardContext, } from './local-upload-guard-provider.js';
+export { useGuardedUpload } from './use-guarded-upload.js';
+export { DeferredUploadFormShell, } from './deferred-upload-form-shell.js';
+export { InFlightUploadsProvider, useInFlightUploadsState, useInFlightUpload, useUploadActivityState, isTerminalUpload, } from './in-flight-uploads-provider.js';
+export { useUploadProcessing, } from './use-upload-processing.js';
+export { useClearUploadActivity, } from './use-clear-upload-activity.js';
+export { useGuardedNavigation, } from './use-guarded-navigation.js';
+export { GuardedLink, } from './guarded-link.js';
+export { UploadActivityTray, } from './upload-activity-tray.js';
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAA0B,MAAM,yBAAyB,CAAC;AACnF,OAAO,EACL,uBAAuB,GAGxB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,GAejB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,mBAAmB,GAGpB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,sBAAsB,GAEvB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,WAAW,GAGZ,MAAM,mBAAmB,CAAC;AAI3B,OAAO,EACL,kBAAkB,GAGnB,MAAM,2BAA2B,CAAC"}

package/dist/react/local-upload-guard-provider.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Local upload navigation guard provider.
+ *
+ * Tracks the count of in-progress LOCAL byte uploads (file → Firebase
+ * Storage). While the count is > 0, installs a `beforeunload` listener
+ * to warn the user before they close the tab or reload mid-upload.
+ *
+ * Scope:
+ *  - Covers phases `preparing` and `uploading` only.
+ *  - Does NOT cover `finalizing` — at that point bytes are already in
+ *    Storage and the only remaining work is the `startUpload` callable.
+ *  - Does NOT cover backend `pendingMedia` status (`pending` /
+ *    `processing`). Those run server-side and are safe to leave.
+ *
+ * Consumers register with a stable id (typically the local upload
+ * session id or `pendingMedia` doc id once known) on entering
+ * `preparing`/`uploading`, and unregister on transition to
+ * `finalizing`/success/error/cancel/unmount.
+ *
+ * Public hook: `useLocalUploadGuard()` returns
+ * `{ activeUploadCount, registerUpload, unregisterUpload }`. Throws if
+ * used outside a `LocalUploadGuardProvider`.
+ */
+import { type ReactNode } from 'react';
+interface LocalUploadGuardContextValue {
+    activeUploadCount: number;
+    registerUpload: (id: string) => void;
+    unregisterUpload: (id: string) => void;
+    /** Returns true iff at least one upload is currently registered. Pure read. */
+    shouldConfirmNavigation: () => boolean;
+    /**
+     * Shows a confirm() dialog with the configured message and returns the user's
+     * choice. Safe to call when no upload is active — returns true without prompting.
+     */
+    confirmNavigation: () => boolean;
+}
+export interface LocalUploadGuardProviderProps {
+    /**
+     * Message shown by the browser when the user attempts to close the tab or
+     * reload during an active upload. Modern browsers may ignore the custom
+     * string and show a generic dialog.
+     */
+    beforeUnloadMessage?: string;
+    /**
+     * Message shown by `confirmNavigation()` when an upload is in progress and
+     * the user attempts to navigate away within the app. Defaults to a
+     * reasonable English string.
+     */
+    navigationConfirmMessage?: string;
+    children: ReactNode;
+}
+export declare function LocalUploadGuardProvider(props: LocalUploadGuardProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Low-level accessor for the local-upload guard context. Throws if used
+ * outside a `LocalUploadGuardProvider`. Most consumers should use
+ * `useLocalUploadGuard` (the public re-export below) instead.
+ */
+export declare function useLocalUploadGuardContext(): LocalUploadGuardContextValue;
+/**
+ * Public hook for the local upload navigation guard.
+ *
+ * Returns `{ activeUploadCount, registerUpload, unregisterUpload }`.
+ *
+ * Typical usage in an upload flow:
+ *
+ *     const { registerUpload, unregisterUpload } = useLocalUploadGuard();
+ *     useEffect(() => {
+ *       if (phase === 'preparing' || phase === 'uploading') {
+ *         registerUpload(uploadId);
+ *         return () => unregisterUpload(uploadId);
+ *       }
+ *     }, [phase, uploadId, registerUpload, unregisterUpload]);
+ */
+export declare function useLocalUploadGuard(): LocalUploadGuardContextValue;
+export {};
+//# sourceMappingURL=local-upload-guard-provider.d.ts.map

package/dist/react/local-upload-guard-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-upload-guard-provider.d.ts","sourceRoot":"","sources":["../../src/react/local-upload-guard-provider.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAQL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,UAAU,4BAA4B;IACpC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,gBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,+EAA+E;IAC/E,uBAAuB,EAAE,MAAM,OAAO,CAAC;IACvC;;;OAGG;IACH,iBAAiB,EAAE,MAAM,OAAO,CAAC;CAClC;AAID,MAAM,WAAW,6BAA6B;IAC5C;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,EAAE,SAAS,CAAC;CACrB;AAOD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,6BAA6B,2CAmE5E;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,IAAI,4BAA4B,CAQzE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,IAAI,4BAA4B,CAElE"}

package/dist/react/local-upload-guard-provider.js

@@ -0,0 +1,110 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Local upload navigation guard provider.
+ *
+ * Tracks the count of in-progress LOCAL byte uploads (file → Firebase
+ * Storage). While the count is > 0, installs a `beforeunload` listener
+ * to warn the user before they close the tab or reload mid-upload.
+ *
+ * Scope:
+ *  - Covers phases `preparing` and `uploading` only.
+ *  - Does NOT cover `finalizing` — at that point bytes are already in
+ *    Storage and the only remaining work is the `startUpload` callable.
+ *  - Does NOT cover backend `pendingMedia` status (`pending` /
+ *    `processing`). Those run server-side and are safe to leave.
+ *
+ * Consumers register with a stable id (typically the local upload
+ * session id or `pendingMedia` doc id once known) on entering
+ * `preparing`/`uploading`, and unregister on transition to
+ * `finalizing`/success/error/cancel/unmount.
+ *
+ * Public hook: `useLocalUploadGuard()` returns
+ * `{ activeUploadCount, registerUpload, unregisterUpload }`. Throws if
+ * used outside a `LocalUploadGuardProvider`.
+ */
+import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, } from 'react';
+const LocalUploadGuardContext = createContext(undefined);
+const DEFAULT_BEFORE_UNLOAD_MESSAGE = 'File upload in progress. Are you sure you want to leave and end the file upload?';
+const DEFAULT_NAVIGATION_CONFIRM_MESSAGE = 'An upload is currently in progress. If you leave this page, the upload will be canceled. Continue?';
+export function LocalUploadGuardProvider(props) {
+    const { children, beforeUnloadMessage = DEFAULT_BEFORE_UNLOAD_MESSAGE, navigationConfirmMessage = DEFAULT_NAVIGATION_CONFIRM_MESSAGE, } = props;
+    const activeIdsRef = useRef(new Set());
+    const [activeUploadCount, setActiveUploadCount] = useState(0);
+    const registerUpload = useCallback((id) => {
+        if (activeIdsRef.current.has(id))
+            return;
+        activeIdsRef.current.add(id);
+        setActiveUploadCount(activeIdsRef.current.size);
+    }, []);
+    const unregisterUpload = useCallback((id) => {
+        if (!activeIdsRef.current.has(id))
+            return;
+        activeIdsRef.current.delete(id);
+        setActiveUploadCount(activeIdsRef.current.size);
+    }, []);
+    useEffect(() => {
+        if (activeUploadCount <= 0)
+            return;
+        const handleBeforeUnload = (event) => {
+            event.preventDefault();
+            // Modern browsers may ignore the custom string and show their own
+            // generic confirmation. The key behavior is that navigation is
+            // blocked/warned, not the exact text.
+            event.returnValue = beforeUnloadMessage;
+            return event.returnValue;
+        };
+        window.addEventListener('beforeunload', handleBeforeUnload);
+        return () => {
+            window.removeEventListener('beforeunload', handleBeforeUnload);
+        };
+    }, [activeUploadCount, beforeUnloadMessage]);
+    const shouldConfirmNavigation = useCallback(() => activeIdsRef.current.size > 0, []);
+    const confirmNavigation = useCallback(() => {
+        if (activeIdsRef.current.size === 0)
+            return true;
+        // SSR / non-browser safety: if `window` isn't available, default to allow.
+        if (typeof window === 'undefined')
+            return true;
+        return window.confirm(navigationConfirmMessage);
+    }, [navigationConfirmMessage]);
+    const value = useMemo(() => ({
+        activeUploadCount,
+        registerUpload,
+        unregisterUpload,
+        shouldConfirmNavigation,
+        confirmNavigation,
+    }), [activeUploadCount, registerUpload, unregisterUpload, shouldConfirmNavigation, confirmNavigation]);
+    return (_jsx(LocalUploadGuardContext.Provider, { value: value, children: children }));
+}
+/**
+ * Low-level accessor for the local-upload guard context. Throws if used
+ * outside a `LocalUploadGuardProvider`. Most consumers should use
+ * `useLocalUploadGuard` (the public re-export below) instead.
+ */
+export function useLocalUploadGuardContext() {
+    const ctx = useContext(LocalUploadGuardContext);
+    if (ctx === undefined) {
+        throw new Error('useLocalUploadGuard must be used within LocalUploadGuardProvider');
+    }
+    return ctx;
+}
+/**
+ * Public hook for the local upload navigation guard.
+ *
+ * Returns `{ activeUploadCount, registerUpload, unregisterUpload }`.
+ *
+ * Typical usage in an upload flow:
+ *
+ *     const { registerUpload, unregisterUpload } = useLocalUploadGuard();
+ *     useEffect(() => {
+ *       if (phase === 'preparing' || phase === 'uploading') {
+ *         registerUpload(uploadId);
+ *         return () => unregisterUpload(uploadId);
+ *       }
+ *     }, [phase, uploadId, registerUpload, unregisterUpload]);
+ */
+export function useLocalUploadGuard() {
+    return useLocalUploadGuardContext();
+}
+//# sourceMappingURL=local-upload-guard-provider.js.map

package/dist/react/local-upload-guard-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-upload-guard-provider.js","sourceRoot":"","sources":["../../src/react/local-upload-guard-provider.tsx"],"names":[],"mappings":"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"}

package/dist/react/upload-activity-tray.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Global upload activity tray.
+ *
+ * Renders a fixed bottom-left floating action button when there is any
+ * active or non-cleared terminal upload. Opens a popover listing each
+ * item with backend status. Terminal items (completed / failed / rejected)
+ * get a Clear (×) button that calls the consumer-supplied clear mutation.
+ *
+ * Framework-agnostic via render props:
+ *  - `renderViewAllLink` lets the consumer plug in their app's Link
+ *    component (Next.js Link, React Router Link, anchor, etc.) routed at
+ *    their canonical "view all uploads" destination.
+ *  - `renderFooter` lets the consumer fully replace the footer slot.
+ *  - Both omitted — footer is not rendered.
+ */
+import { type ReactNode } from 'react';
+export interface ViewAllLinkRenderArgs {
+    /** The href the consumer's link should navigate to (passed through verbatim). */
+    href: string;
+    /** Children for the link element (i.e. the label text + arrow). */
+    children: ReactNode;
+}
+export interface UploadActivityTrayProps {
+    /**
+     * Mutation hook result from `useClearUploadActivity({ clearFn })`. The tray
+     * uses `.mutate(item.id)`, `.isPending`, and `.variables`. The consumer
+     * owns the underlying network call.
+     */
+    clearMutation: {
+        mutate: (pendingMediaId: string) => void;
+        isPending: boolean;
+        variables: string | undefined;
+    };
+    /**
+     * Optional view-all destination href. When omitted, no footer is rendered
+     * unless `renderFooter` is also supplied.
+     */
+    viewAllHref?: string;
+    /**
+     * Render-prop for the view-all link. Receives the href and label children
+     * the consumer should attach. Omit to drop the link.
+     */
+    renderViewAllLink?: (args: ViewAllLinkRenderArgs) => ReactNode;
+    /**
+     * Fully custom footer slot. Replaces the default footer entirely. If both
+     * `renderFooter` and `viewAllHref + renderViewAllLink` are supplied,
+     * `renderFooter` wins.
+     */
+    renderFooter?: () => ReactNode;
+    /** Visible label for the view-all link. Default: "View all uploads →". */
+    viewAllLabel?: ReactNode;
+}
+export declare function UploadActivityTray<TFileOrigin extends string = string>(props: UploadActivityTrayProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=upload-activity-tray.d.ts.map

package/dist/react/upload-activity-tray.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-activity-tray.d.ts","sourceRoot":"","sources":["../../src/react/upload-activity-tray.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAW,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAmGhD,MAAM,WAAW,qBAAqB;IACpC,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,aAAa,EAAE;QACb,MAAM,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;QACzC,SAAS,EAAE,OAAO,CAAC;QACnB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;KAC/B,CAAC;IACF;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,SAAS,CAAC;IAC/D;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,SAAS,CAAC;IAC/B,0EAA0E;IAC1E,YAAY,CAAC,EAAE,SAAS,CAAC;CAC1B;AAED,wBAAgB,kBAAkB,CAAC,WAAW,SAAS,MAAM,GAAG,MAAM,EACpE,KAAK,EAAE,uBAAuB,kDAoG/B"}