@ttt-productions/upload-ui 0.7.17 → 0.7.19

package/dist/react/tray/in-flight-uploads-provider.d.ts

@@ -1,45 +1,6 @@
-/**
- * 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 app-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 { type ReactNode } from 'react';
 import { PendingMediaStatusSchema, type PendingMediaNonTerminalStatus, type PendingMediaStatus } from '@ttt-productions/media-schemas';
-/** Generic pending-media status — media-schemas' one declaration. */
 export type InFlightUploadStatus = PendingMediaStatus;
-/**
- * Generic in-flight upload record. The provider keeps a Map<id, InFlightUpload>
- * built from each parsed PendingMedia. Consumers parameterize the `fileOrigin`
- * type via the parser's return type (the provider treats it as opaque).
- *
- * `TFileOrigin` defaults to `string` so unannotated consumers get a permissive
- * shape; consuming apps bind it to their own `FileOrigin` union at the call site.
- */
 export type InFlightUploadBase<TFileOrigin extends string = string> = {
     id: string;
     fileOrigin: TFileOrigin;
@@ -82,14 +43,6 @@ export type InFlightUploadRejected<TFileOrigin extends string = string> = InFlig
     uploadTraySeenBy?: string;
 };
 export type InFlightUpload<TFileOrigin extends string = string> = InFlightUploadActive<TFileOrigin> | InFlightUploadCompleted<TFileOrigin> | InFlightUploadFailed<TFileOrigin> | InFlightUploadRejected<TFileOrigin>;
-/**
- * Result of the consumer-supplied parser. The provider keeps the raw parsed
- * record for callbacks (so consumers can read domain events, target IDs, etc.)
- * AND derives the generic InFlightUpload from it for the public Map.
- *
- * The parser MUST throw if validation fails; the provider catches and routes
- * the error to the monitoring callback.
- */
 export type ParsedPendingMedia<TFileOrigin extends string = string> = {
     id: string;
     userId: string;
@@ -111,43 +64,17 @@ export type ParsedPendingMedia<TFileOrigin extends string = string> = {
     uploadTrayClearedBy?: string;
     uploadTraySeenAt?: number;
     uploadTraySeenBy?: string;
-    /**
-     * Opaque consumer-controlled domain-event payload, surfaced to the
-     * `onUploadCompleted` and `onUploadRejected` callbacks for cache
-     * invalidation. The provider does not interpret it.
-     */
     domainEvents?: unknown;
 };
 export type InFlightUploadsAdapter<TFileOrigin extends string = string> = {
-    /** Returns the current user's uid, or null if not signed in. */
     getCurrentUserId: () => string | null;
-    /** Firestore database adapter (loose typing — `unknown` keeps zero firebase coupling at the type level). */
     db: unknown;
-    /** Collection path holding pending-media docs (e.g. "pendingMedia"). */
     collectionPath: string;
-    /** Listener window in milliseconds — only docs with `createdAt >= now - window` are tracked. */
     listenerWindowMs: number;
-    /**
-     * Parse a raw Firestore doc snapshot's `.data()` into the generic shape the
-     * provider tracks. Throws on validation failure; the provider routes thrown
-     * errors to `onMonitoringEvent`.
-     */
     parsePendingMedia: (raw: unknown) => ParsedPendingMedia<TFileOrigin>;
-    /** Called once per observed non-terminal → terminal completed transition. */
     onUploadCompleted: (parsed: ParsedPendingMedia<TFileOrigin>) => void;
-    /** Called once per observed non-terminal → terminal failed transition. */
     onUploadFailed: (parsed: ParsedPendingMedia<TFileOrigin>) => void;
-    /** Called once per observed non-terminal → terminal rejected transition. */
     onUploadRejected: (parsed: ParsedPendingMedia<TFileOrigin>) => void;
-    /**
-     * Monitoring callback. Receives:
-     *  - `breadcrumb`: informational, fired on every observed terminal transition.
-     *  - `parse-error`: when `parsePendingMedia` throws.
-     *  - `listener-error`: when the Firestore listener's error callback fires.
-     *
-     * Consumers wire this to Sentry, OpenTelemetry, or any other observability
-     * provider. The provider does NOT import any monitoring SDK directly.
-     */
     onMonitoringEvent: (event: InFlightUploadsMonitoringEvent<TFileOrigin>) => void;
 };
 export type InFlightUploadsMonitoringEvent<TFileOrigin extends string = string> = {
@@ -170,13 +97,6 @@ export type InFlightUploadsMonitoringEvent<TFileOrigin extends string = string>
     type: 'listener-error';
     error: unknown;
 };
-/**
- * Minimal subscription contract used by the provider. The default
- * implementation lives in `firestore-subscribe.ts` and uses the standard
- * `firebase/firestore` `onSnapshot` + `query` + `where` builders.
- *
- * Tests inject a fake to drive the listener without spinning up Firestore.
- */
 export type FirestoreSubscribeFn = (args: {
     db: unknown;
     collectionPath: string;
@@ -187,26 +107,11 @@ export type FirestoreSubscribeFn = (args: {
 }) => () => void;
 export type FirestoreLikeSnapshot = {
     docChanges: () => FirestoreLikeDocChange[];
-    /**
-     * Snapshot metadata. Present when the subscription is opened with
-     * `{ includeMetadataChanges: true }` (the default firebase implementation does).
-     * `fromCache === false` means a server-confirmed snapshot. Optional so injected
-     * test fakes need not supply it (absent ⇒ treated as server-confirmed).
-     */
     metadata?: {
         fromCache: boolean;
     };
 };
-/**
- * Metadata-derived liveness of the uploads listener, mirroring query-core's
- * `FirestoreSourceState`. Firestore serves cached snapshots offline WITHOUT
- * firing the error callback, so the Files tray source needs this to show a
- * degraded indicator instead of a false "all caught up":
- * - `connecting` — no server-confirmed snapshot yet.
- * - `live` — at least one server-confirmed snapshot (`fromCache === false`).
- * - `offline` — only cached data after having been live.
- * - `error` — the listener error callback fired.
- */
+/** Firestore serves cached snapshots offline without firing the error callback, so liveness comes from metadata. */
 export type UploadsSourceState = 'connecting' | 'live' | 'offline' | 'error';
 export type FirestoreLikeDocChange = {
     type: 'added' | 'modified' | 'removed';
@@ -215,52 +120,22 @@ export type FirestoreLikeDocChange = {
         data: () => unknown;
     };
 };
-/** Restarting the uploads listener after it failed, and whether that restart is running. */
 export interface UploadsSourceRetry {
-    /**
-     * Tear the listener down and subscribe again on a fresh retry ladder. While the restart runs the
-     * source state stays as it was (an `error` stays `error`), so a failure shown on it stays on
-     * screen with its control pending.
-     */
     retry: () => void;
-    /** A `retry` is running: true until the restarted listener answers or its ladder fails again. */
     retrying: boolean;
 }
 export interface InFlightUploadsProviderProps<TFileOrigin extends string = string> {
     adapter: InFlightUploadsAdapter<TFileOrigin>;
-    /** Firestore subscription function. Defaults to the firebase/firestore implementation. */
     subscribe?: FirestoreSubscribeFn;
     children: ReactNode;
 }
 export declare function InFlightUploadsProvider<TFileOrigin extends string = string>(props: InFlightUploadsProviderProps<TFileOrigin>): import("react").JSX.Element;
 export declare function useInFlightUploadsState<TFileOrigin extends string = string>(): Map<string, InFlightUpload<TFileOrigin>>;
 export declare function useInFlightUpload<TFileOrigin extends string = string>(id: string | null | undefined): InFlightUpload<TFileOrigin> | undefined;
-/**
- * Metadata-derived source state of the uploads listener
- * (`connecting | live | offline | error`). The Files tray uses this to show a
- * degraded indicator and never display "all caught up" while the source is
- * `offline`/`error`/`connecting`.
- */
 export declare function useUploadsSourceState(): UploadsSourceState;
-/**
- * The uploads listener's restart — the Try again of a failure shown on `useUploadsSourceState` —
- * and whether it is running.
- */
 export declare function useUploadsSourceRetry(): UploadsSourceRetry;
-/**
- * `true` for `completed` / `failed` / `rejected`. Used by tray UI to decide
- * whether a Clear action is available for an item.
- */
 export declare function isTerminalUpload<TFileOrigin extends string = string>(item: InFlightUpload<TFileOrigin>): item is Exclude<InFlightUpload<TFileOrigin>, {
     status: PendingMediaNonTerminalStatus;
 }>;
-/**
- * Tray-visible items. Includes every pending/processing upload, plus terminal
- * uploads that have NOT been cleared from the tray. Sorted newest-first by
- * createdAt.
- *
- * The public selector name in upload-ui is `useUploadActivityState`. The
- * mutation hook is `useClearUploadActivity` (in a separate file).
- */
 export declare function useUploadActivityState<TFileOrigin extends string = string>(): InFlightUpload<TFileOrigin>[];
 //# sourceMappingURL=in-flight-uploads-provider.d.ts.map

package/dist/react/tray/in-flight-uploads-provider.d.ts.map

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

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

@@ -1,7 +1,6 @@
 'use client';
 import { jsx as _jsx } from "react/jsx-runtime";
-// ─────────────────────────────────────────────────────────────────────────────
-// SANCTIONED EXCEPTION to ARCH-206 (packages read and write Firestore only
+// SANCTIONED EXCEPTION to RULE-STD-ARCH-206 (packages read and write Firestore only
 // through @ttt-productions/query-core).
 //
 // WHY this provider reads Firestore directly instead of via a query-core hook:
@@ -17,41 +16,9 @@ import { jsx as _jsx } from "react/jsx-runtime";
 //      Turbopack module identity (see defaultFirestoreSubscribe's comment).
 //
 // Do NOT "migrate" this onto query-core without preserving docChanges() semantics.
-// ─────────────────────────────────────────────────────────────────────────────
 import { collection, onSnapshot, query, where } from 'firebase/firestore';
-/**
- * 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 app-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, useCallback, useContext, useEffect, useMemo, useRef, useState, } from 'react';
 import { isPendingMediaNonTerminalStatus, isPendingMediaTerminalStatus, PendingMediaStatusSchema, } from '@ttt-productions/media-schemas';
-// Status values derive from media-schemas' one declaration.
 const STATUS = PendingMediaStatusSchema.enum;
 const InFlightUploadsContext = createContext(undefined);
 function fromParsed(parsed) {
@@ -91,7 +58,6 @@ function fromParsed(parsed) {
             uploadTraySeenBy: parsed.uploadTraySeenBy,
         };
     }
-    // rejected
     return {
         ...base,
         status: STATUS.rejected,
@@ -101,10 +67,7 @@ function fromParsed(parsed) {
         violationId: parsed.violationId,
         uploadTrayClearedAt: parsed.uploadTrayClearedAt,
         uploadTrayClearedBy: parsed.uploadTrayClearedBy,
-        // Carry the seen fields through on the `rejected` branch as `completed` /
-        // `failed` do: without them a seen rejected upload relights the Files dot
-        // forever, because the tray's unseen-terminal check never sees
-        // `uploadTraySeenAt`.
+        // Without the seen fields a seen rejected upload relights the Files dot forever.
         uploadTraySeenAt: parsed.uploadTraySeenAt,
         uploadTraySeenBy: parsed.uploadTraySeenBy,
     };
@@ -115,36 +78,19 @@ export function InFlightUploadsProvider(props) {
     const [sourceState, setSourceState] = useState('connecting');
     const [restarts, setRestarts] = useState(0);
     const [retrying, setRetrying] = useState(false);
-    /** Set by `retry` for the subscription the restart opens; that run keeps the source state. */
     const restartRequestedRef = useRef(false);
     const seenTerminalIdsRef = useRef(new Set());
     const statusByIdRef = useRef(new Map());
     const hasProcessedInitialSnapshotRef = useRef(false);
-    /** The identity the dedup/tracking refs belong to — they outlive resubscribes
-     *  for the SAME user (auth-settling flaps) and reset only on a real identity
-     *  change. See the reset block in the subscription effect. */
     const trackedUserIdRef = useRef(null);
-    // Stable refs for adapter callbacks — read from latest adapter inside effect.
     const adapterRef = useRef(adapter);
     useEffect(() => {
         adapterRef.current = adapter;
     });
     const userId = adapter.getCurrentUserId();
     useEffect(() => {
-        // The uploads map and source state rebuild from every subscription's initial
-        // snapshot, so they reset on every effect run. The terminal-dedup and
-        // status-tracking refs are IDENTITY-scoped, not subscription-scoped: an
-        // auth-settling flap (uid → null → same uid re-subscribes) must neither
-        // re-fire terminals the previous subscription already fired (seen set
-        // persists) nor lose the observed non-terminal statuses that let the new
-        // subscription's initial listing detect a transition that completed during
-        // the gap. A real identity change — including UID-A → UID-B with no
-        // intermediate null user — starts clean; never rely on an intermediate
-        // sign-out to clear refs between two authenticated UIDs.
-        // A restart the person asked for keeps the source state it had (a failure stays a failure
-        // until the restarted listener answers); every other run starts over as `connecting`.
-        // A restart belongs to the identity it was asked for: one that lands with a sign-out or a switch
-        // of account is an ordinary new subscription, which starts over.
+        // The dedup and tracking refs are identity-scoped: they survive a same-user resubscribe and reset
+        // on any identity change, UID-A to UID-B with no sign-out between included.
         let restarting = restartRequestedRef.current && userId !== null && userId === trackedUserIdRef.current;
         restartRequestedRef.current = false;
         setUploads(new Map());
@@ -194,12 +140,8 @@ export function InFlightUploadsProvider(props) {
                 const currentIsTerminal = isPendingMediaTerminalStatus(currentStatus);
                 const previousWasNonTerminal = isPendingMediaNonTerminalStatus(previousStatus);
                 if (isInitialSnapshot) {
-                    // A subscription's first snapshot is a (re-)listing of current state,
-                    // not a live event: already-terminal docs stay suppressed so a page
-                    // refresh never re-toasts. ONE exception — this provider instance
-                    // tracked the doc as non-terminal before (same-identity resubscribe
-                    // gap; the tracking refs survive those), so the terminal listing IS
-                    // the transition, observed across the gap, and must fire.
+                    // A first snapshot re-lists current state: its terminal docs fire only when this instance tracked
+                    // them as non-terminal before.
                     if (currentIsTerminal) {
                         if (previousWasNonTerminal && !seenTerminalIdsRef.current.has(parsed.id)) {
                             newlyTerminal.push(parsed);
@@ -208,23 +150,14 @@ export function InFlightUploadsProvider(props) {
                     }
                 }
                 else if (currentIsTerminal && !seenTerminalIdsRef.current.has(parsed.id)) {
-                    // Any unseen terminal in a LIVE snapshot fires — including a doc whose
-                    // FIRST client-visible state is already terminal. A fast backend
-                    // outcome (moderation rejection in ~2s) can coalesce created→terminal
-                    // into one delivery, and the uploader is actively waiting on exactly
-                    // this callback; swallowing it silently loses a rejection dialog.
+                    // A fast outcome can coalesce created and terminal into one delivery, so any unseen terminal fires.
                     seenTerminalIdsRef.current.add(parsed.id);
                     newlyTerminal.push(parsed);
                 }
                 statusByIdRef.current.set(parsed.id, currentStatus);
             }
             hasProcessedInitialSnapshotRef.current = true;
-            // Metadata-derived source state: stay `connecting` until a server-confirmed
-            // snapshot, `offline` if only cached data arrives after being live.
             const fromCache = snapshot.metadata?.fromCache ?? false;
-            // A restart ends on the server's answer: a cached snapshot during it keeps the failure on screen
-            // (the server may refuse again). Otherwise a snapshot after a failed listener comes from a new
-            // subscription: not yet live, never offline.
             if (!(restarting && fromCache)) {
                 setSourceState((prev) => fromCache
                     ? prev === 'connecting' || prev === 'error'
@@ -273,13 +206,6 @@ export function InFlightUploadsProvider(props) {
                 adapterRef.current.onUploadRejected(parsed);
             }
         }
-        // Bounded RESUBSCRIBE on listener error: a cold-session race (e.g. Firestore
-        // App Check enforcement rejecting the first attach before the token is
-        // minted) must not kill the listener for the whole session — observed live:
-        // one permission-denied at first login → sourceState 'error' forever, every
-        // tray file status dead until reload. Retry on a short ladder; a snapshot
-        // resets the ladder (healthy again); exhausting it goes terminal 'error'
-        // (a real rules denial stays denied — retries are cheap and bounded).
         const RESUBSCRIBE_DELAYS_MS = [1_000, 3_000, 10_000, 30_000];
         let attempt = 0;
         let disposed = false;
@@ -292,7 +218,7 @@ export function InFlightUploadsProvider(props) {
                 userId,
                 windowStartMs,
                 onSnapshot: (snapshot) => {
-                    attempt = 0; // healthy — future errors get a fresh ladder
+                    attempt = 0;
                     handleSnapshot(snapshot);
                 },
                 onError: (error) => {
@@ -322,8 +248,6 @@ export function InFlightUploadsProvider(props) {
                 clearTimeout(retryTimer);
             unsubscribe?.();
         };
-        // adapter is intentionally NOT in the deps array — adapter is read via
-        // adapterRef on every snapshot, so identity changes don't re-subscribe.
     }, [userId, subscribe, restarts]);
     const retry = useCallback(() => {
         restartRequestedRef.current = true;
@@ -333,9 +257,6 @@ export function InFlightUploadsProvider(props) {
     const value = useMemo(() => ({ uploads, sourceState, retry, retrying }), [uploads, sourceState, retry, retrying]);
     return (_jsx(InFlightUploadsContext.Provider, { value: value, children: children }));
 }
-// =============================================================================
-// Read APIs
-// =============================================================================
 export function useInFlightUploadsState() {
     const ctx = useContext(InFlightUploadsContext);
     if (ctx === undefined) {
@@ -352,12 +273,6 @@ export function useInFlightUpload(id) {
         return undefined;
     return ctx.uploads.get(id);
 }
-/**
- * Metadata-derived source state of the uploads listener
- * (`connecting | live | offline | error`). The Files tray uses this to show a
- * degraded indicator and never display "all caught up" while the source is
- * `offline`/`error`/`connecting`.
- */
 export function useUploadsSourceState() {
     const ctx = useContext(InFlightUploadsContext);
     if (ctx === undefined) {
@@ -365,10 +280,6 @@ export function useUploadsSourceState() {
     }
     return ctx.sourceState;
 }
-/**
- * The uploads listener's restart — the Try again of a failure shown on `useUploadsSourceState` —
- * and whether it is running.
- */
 export function useUploadsSourceRetry() {
     const ctx = useContext(InFlightUploadsContext);
     if (ctx === undefined) {
@@ -376,24 +287,9 @@ export function useUploadsSourceRetry() {
     }
     return { retry: ctx.retry, retrying: ctx.retrying };
 }
-// =============================================================================
-// 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 isPendingMediaTerminalStatus(item.status);
 }
-/**
- * Tray-visible items. Includes every pending/processing upload, plus terminal
- * uploads that have NOT been cleared from the tray. Sorted newest-first by
- * createdAt.
- *
- * 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(() => {
@@ -406,29 +302,10 @@ export function useUploadActivityState() {
             .sort((a, b) => b.createdAt - a.createdAt);
     }, [uploads]);
 }
-// =============================================================================
-// Default Firestore subscription implementation
-// =============================================================================
-/**
- * Default Firestore subscription using the consumer's `firebase/firestore`
- * module instance (via static ESM import at the top of this file).
- *
- * Using static ESM import — NOT `require()` — is load-bearing. CommonJS
- * `require('firebase/firestore')` and ESM `import 'firebase/firestore'` resolve
- * to different module instances under Next.js + Turbopack. If the consumer
- * constructs `db` via ESM and we receive it here, but we then call
- * `collection()` from a CJS-loaded copy of firebase, the firebase runtime
- * does not recognize the db as a Firestore instance and throws
- * "Expected first argument to collection() to be a CollectionReference,
- *  a DocumentReference or FirebaseFirestore".
- *
- * Consumers who want to skip the firebase code path entirely (tests, alt
- * backends) supply their own `subscribe` prop to `InFlightUploadsProvider`.
- */
+// A static ESM import, never require(): under Next.js + Turbopack a CJS-loaded firebase/firestore
+// is another module instance and rejects a db built through ESM.
 const defaultFirestoreSubscribe = (args) => {
     const q = query(collection(args.db, args.collectionPath), where('userId', '==', args.userId), where('createdAt', '>=', args.windowStartMs));
-    // includeMetadataChanges so the provider can derive a `connecting|live|offline|error`
-    // source state from `snapshot.metadata.fromCache` (the Files tray degraded indicator).
     return onSnapshot(q, { includeMetadataChanges: true }, args.onSnapshot, args.onError);
 };
 //# sourceMappingURL=in-flight-uploads-provider.js.map