@ttt-productions/upload-ui 0.7.15 → 0.7.16

package/dist/index.d.ts

@@ -1,2 +1,3 @@
-export {};
+export { formatFileSize, createUploadDisplayFormatters } from "./upload-display.js";
+export type { UploadDisplayCopy, UploadDisplayConfig, UploadDisplayFormatters } from "./upload-display.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAG,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AACpF,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -1,2 +1,4 @@
-export {};
+// Server-safe entry: no React. React code lives at `@ttt-productions/upload-ui/react/guard`,
+// `/react/upload`, and `/react/tray`.
+export { formatFileSize, createUploadDisplayFormatters } from "./upload-display.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"","sourcesContent":["// Server-safe entry. React code lives at `@ttt-productions/upload-ui/react/guard`, `/react/upload`, and `/react/tray`.\n// This file is intentionally empty; the package's public surface is exposed via\n// the `./react/guard`, `./react/upload`, and `./react/tray` subpaths. Keeping main\n// empty preserves the server-safe contract (no React imports leak through\n// `import x from '@ttt-productions/upload-ui'`).\nexport { };"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,sCAAsC;AACtC,OAAO,EAAE,cAAc,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC","sourcesContent":["// Server-safe entry: no React. React code lives at `@ttt-productions/upload-ui/react/guard`,\n// `/react/upload`, and `/react/tray`.\nexport { formatFileSize, createUploadDisplayFormatters } from \"./upload-display.js\";\nexport type { UploadDisplayCopy, UploadDisplayConfig, UploadDisplayFormatters } from \"./upload-display.js\";\n"]}

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

@@ -1,5 +1,5 @@
 export { InFlightUploadsProvider, useInFlightUploadsState, useInFlightUpload, useUploadActivityState, useUploadsSourceState, useUploadsSourceRetry, isTerminalUpload, type UploadsSourceState, type UploadsSourceRetry, 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 { useClearUploadActivity, type ClearUploadActivityOptions, } from '../use-clear-upload-activity.js';
-export { useMarkUploadActivitySeen, type MarkUploadActivitySeenOptions, } from '../use-mark-upload-activity-seen.js';
+export { useMarkUploadActivitySeen, MarkUploadActivitySeenError, type MarkUploadActivitySeenOptions, } from '../use-mark-upload-activity-seen.js';
 export { useUploadProcessing, type UploadProcessingState, type UseUploadProcessingOptions, } from '../use-upload-processing.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/react/tray/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,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,kCAAkC,CAAC;AAC1C,OAAO,EACL,sBAAsB,EACtB,KAAK,0BAA0B,GAChC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,yBAAyB,EACzB,KAAK,6BAA6B,GACnC,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,mBAAmB,EACnB,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,GAChC,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/react/tray/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,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,kCAAkC,CAAC;AAC1C,OAAO,EACL,sBAAsB,EACtB,KAAK,0BAA0B,GAChC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,KAAK,6BAA6B,GACnC,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,mBAAmB,EACnB,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,GAChC,MAAM,6BAA6B,CAAC"}

package/dist/react/tray/index.js

@@ -1,5 +1,5 @@
 export { InFlightUploadsProvider, useInFlightUploadsState, useInFlightUpload, useUploadActivityState, useUploadsSourceState, useUploadsSourceRetry, isTerminalUpload, } from '../in-flight-uploads-provider.js';
 export { useClearUploadActivity, } from '../use-clear-upload-activity.js';
-export { useMarkUploadActivitySeen, } from '../use-mark-upload-activity-seen.js';
+export { useMarkUploadActivitySeen, MarkUploadActivitySeenError, } from '../use-mark-upload-activity-seen.js';
 export { useUploadProcessing, } from '../use-upload-processing.js';
 //# sourceMappingURL=index.js.map

package/dist/react/tray/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/react/tray/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,GAiBjB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,sBAAsB,GAEvB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,yBAAyB,GAE1B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,mBAAmB,GAGpB,MAAM,6BAA6B,CAAC","sourcesContent":["export {\n  InFlightUploadsProvider,\n  useInFlightUploadsState,\n  useInFlightUpload,\n  useUploadActivityState,\n  useUploadsSourceState,\n  useUploadsSourceRetry,\n  isTerminalUpload,\n  type UploadsSourceState,\n  type UploadsSourceRetry,\n  type InFlightUpload,\n  type InFlightUploadActive,\n  type InFlightUploadCompleted,\n  type InFlightUploadFailed,\n  type InFlightUploadRejected,\n  type InFlightUploadBase,\n  type InFlightUploadStatus,\n  type InFlightUploadsAdapter,\n  type InFlightUploadsMonitoringEvent,\n  type InFlightUploadsProviderProps,\n  type ParsedPendingMedia,\n  type FirestoreSubscribeFn,\n  type FirestoreLikeSnapshot,\n  type FirestoreLikeDocChange,\n} from '../in-flight-uploads-provider.js';\nexport {\n  useClearUploadActivity,\n  type ClearUploadActivityOptions,\n} from '../use-clear-upload-activity.js';\nexport {\n  useMarkUploadActivitySeen,\n  type MarkUploadActivitySeenOptions,\n} from '../use-mark-upload-activity-seen.js';\nexport {\n  useUploadProcessing,\n  type UploadProcessingState,\n  type UseUploadProcessingOptions,\n} from '../use-upload-processing.js';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/react/tray/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,GAiBjB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,sBAAsB,GAEvB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,yBAAyB,EACzB,2BAA2B,GAE5B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,mBAAmB,GAGpB,MAAM,6BAA6B,CAAC","sourcesContent":["export {\n  InFlightUploadsProvider,\n  useInFlightUploadsState,\n  useInFlightUpload,\n  useUploadActivityState,\n  useUploadsSourceState,\n  useUploadsSourceRetry,\n  isTerminalUpload,\n  type UploadsSourceState,\n  type UploadsSourceRetry,\n  type InFlightUpload,\n  type InFlightUploadActive,\n  type InFlightUploadCompleted,\n  type InFlightUploadFailed,\n  type InFlightUploadRejected,\n  type InFlightUploadBase,\n  type InFlightUploadStatus,\n  type InFlightUploadsAdapter,\n  type InFlightUploadsMonitoringEvent,\n  type InFlightUploadsProviderProps,\n  type ParsedPendingMedia,\n  type FirestoreSubscribeFn,\n  type FirestoreLikeSnapshot,\n  type FirestoreLikeDocChange,\n} from '../in-flight-uploads-provider.js';\nexport {\n  useClearUploadActivity,\n  type ClearUploadActivityOptions,\n} from '../use-clear-upload-activity.js';\nexport {\n  useMarkUploadActivitySeen,\n  MarkUploadActivitySeenError,\n  type MarkUploadActivitySeenOptions,\n} from '../use-mark-upload-activity-seen.js';\nexport {\n  useUploadProcessing,\n  type UploadProcessingState,\n  type UseUploadProcessingOptions,\n} from '../use-upload-processing.js';\n"]}

package/dist/react/use-mark-upload-activity-seen.d.ts

@@ -1,8 +1,16 @@
 export interface MarkUploadActivitySeenOptions {
-    /** Network call performing the mark-seen. Receives the pendingMediaIds. */
+    /** Network call performing the mark-seen for at most `maxIdsPerCall` pendingMediaIds. */
     markFn: (pendingMediaIds: string[]) => Promise<void>;
-    /** Optional error callback. Receives the error and the ids that failed. */
+    /** The most ids one `markFn` call accepts — the app's own per-call cap. */
+    maxIdsPerCall: number;
+    /** Optional error callback. Receives the first failure and every id that was not marked. */
     onError?: (error: Error, pendingMediaIds: string[]) => void;
 }
+/** The mutation's failure when one or more calls failed: the first failure, and the ids left unmarked. */
+export declare class MarkUploadActivitySeenError extends Error {
+    readonly failure: Error;
+    readonly unmarkedIds: string[];
+    constructor(failure: Error, unmarkedIds: string[]);
+}
 export declare function useMarkUploadActivitySeen(options: MarkUploadActivitySeenOptions): import("@tanstack/react-query").UseMutationResult<void, Error, string[], unknown>;
 //# sourceMappingURL=use-mark-upload-activity-seen.d.ts.map

package/dist/react/use-mark-upload-activity-seen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-mark-upload-activity-seen.d.ts","sourceRoot":"","sources":["../../src/react/use-mark-upload-activity-seen.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,6BAA6B;IAC5C,2EAA2E;IAC3E,MAAM,EAAE,CAAC,eAAe,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,2EAA2E;IAC3E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CAC7D;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,6BAA6B,qFAQ/E"}
+{"version":3,"file":"use-mark-upload-activity-seen.d.ts","sourceRoot":"","sources":["../../src/react/use-mark-upload-activity-seen.ts"],"names":[],"mappings":"AAyBA,MAAM,WAAW,6BAA6B;IAC5C,yFAAyF;IACzF,MAAM,EAAE,CAAC,eAAe,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,2EAA2E;IAC3E,aAAa,EAAE,MAAM,CAAC;IACtB,4FAA4F;IAC5F,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CAC7D;AAED,0GAA0G;AAC1G,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;gBAEnB,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE;CAMlD;AAwBD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,6BAA6B,qFAS/E"}

package/dist/react/use-mark-upload-activity-seen.js

@@ -12,17 +12,53 @@
  * needed in this hook. Marking seen is tray UX state, not a sensitive action,
  * so it mirrors `useClearUploadActivity` exactly (no audit event).
  *
- * `markFn` receives the full batch of pendingMediaIds to mark seen at once
- * (typically every currently-unseen terminal item when the File-status tab
- * opens). An empty array is a no-op the consumer's callable can short-circuit.
+ * The mutation takes every id to mark (typically every currently-unseen terminal
+ * item when the File-status tab opens) and sends them to `markFn` in sequential
+ * calls of at most `maxIdsPerCall` — the app's own per-call cap, so no call is
+ * refused for its size. A failed call does not stop the rest: its ids simply stay
+ * unseen. When any call failed, the mutation fails, and `onError` receives the first
+ * failure and every id left unmarked. An empty array makes no call.
  */
 import { useMutation } from '@tanstack/react-query';
+/** The mutation's failure when one or more calls failed: the first failure, and the ids left unmarked. */
+export class MarkUploadActivitySeenError extends Error {
+    failure;
+    unmarkedIds;
+    constructor(failure, unmarkedIds) {
+        super(failure.message);
+        this.name = 'MarkUploadActivitySeenError';
+        this.failure = failure;
+        this.unmarkedIds = unmarkedIds;
+    }
+}
+async function markInBatches(markFn, maxIdsPerCall, pendingMediaIds) {
+    if (!Number.isInteger(maxIdsPerCall) || maxIdsPerCall < 1) {
+        throw new Error(`maxIdsPerCall must be a positive whole number, got ${maxIdsPerCall}.`);
+    }
+    let firstFailure = null;
+    const unmarkedIds = [];
+    for (let start = 0; start < pendingMediaIds.length; start += maxIdsPerCall) {
+        const batch = pendingMediaIds.slice(start, start + maxIdsPerCall);
+        try {
+            await markFn(batch);
+        }
+        catch (err) {
+            firstFailure ??= err instanceof Error ? err : new Error(String(err));
+            unmarkedIds.push(...batch);
+        }
+    }
+    if (firstFailure)
+        throw new MarkUploadActivitySeenError(firstFailure, unmarkedIds);
+}
 export function useMarkUploadActivitySeen(options) {
-    const { markFn, onError } = options;
+    const { markFn, maxIdsPerCall, onError } = options;
     return useMutation({
-        mutationFn: markFn,
+        mutationFn: (pendingMediaIds) => markInBatches(markFn, maxIdsPerCall, pendingMediaIds),
         onError: (error, pendingMediaIds) => {
-            onError?.(error, pendingMediaIds);
+            if (error instanceof MarkUploadActivitySeenError)
+                onError?.(error.failure, error.unmarkedIds);
+            else
+                onError?.(error, pendingMediaIds);
         },
     });
 }

package/dist/react/use-mark-upload-activity-seen.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-mark-upload-activity-seen.js","sourceRoot":"","sources":["../../src/react/use-mark-upload-activity-seen.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AASpD,MAAM,UAAU,yBAAyB,CAAC,OAAsC;IAC9E,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IACpC,OAAO,WAAW,CAAwB;QACxC,UAAU,EAAE,MAAM;QAClB,OAAO,EAAE,CAAC,KAAK,EAAE,eAAe,EAAE,EAAE;YAClC,OAAO,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;QACpC,CAAC;KACF,CAAC,CAAC;AACL,CAAC","sourcesContent":["'use client';\n\n/**\n * Generic mutation hook to mark terminal pendingMedia items as seen in the tray.\n *\n * Pure adapter: the consumer supplies `markFn` (typically a wrapped Firebase\n * callable in the consuming app that writes `uploadTraySeenAt`/`uploadTraySeenBy` on the\n * caller's own terminal pendingMedia docs). The package owns the useMutation\n * wiring and the optional `onError` hook; the consumer owns the network call.\n *\n * The provider's Firestore listener observes the `uploadTraySeenAt` write and\n * updates the in-flight upload records automatically — no optimistic update is\n * needed in this hook. Marking seen is tray UX state, not a sensitive action,\n * so it mirrors `useClearUploadActivity` exactly (no audit event).\n *\n * `markFn` receives the full batch of pendingMediaIds to mark seen at once\n * (typically every currently-unseen terminal item when the File-status tab\n * opens). An empty array is a no-op the consumer's callable can short-circuit.\n */\n\nimport { useMutation } from '@tanstack/react-query';\n\nexport interface MarkUploadActivitySeenOptions {\n  /** Network call performing the mark-seen. Receives the pendingMediaIds. */\n  markFn: (pendingMediaIds: string[]) => Promise<void>;\n  /** Optional error callback. Receives the error and the ids that failed. */\n  onError?: (error: Error, pendingMediaIds: string[]) => void;\n}\n\nexport function useMarkUploadActivitySeen(options: MarkUploadActivitySeenOptions) {\n  const { markFn, onError } = options;\n  return useMutation<void, Error, string[]>({\n    mutationFn: markFn,\n    onError: (error, pendingMediaIds) => {\n      onError?.(error, pendingMediaIds);\n    },\n  });\n}\n"]}
+{"version":3,"file":"use-mark-upload-activity-seen.js","sourceRoot":"","sources":["../../src/react/use-mark-upload-activity-seen.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAWpD,0GAA0G;AAC1G,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IAC3C,OAAO,CAAQ;IACf,WAAW,CAAW;IAE/B,YAAY,OAAc,EAAE,WAAqB;QAC/C,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;QAC1C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;CACF;AAED,KAAK,UAAU,aAAa,CAC1B,MAAoD,EACpD,aAAqB,EACrB,eAAyB;IAEzB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,sDAAsD,aAAa,GAAG,CAAC,CAAC;IAC1F,CAAC;IACD,IAAI,YAAY,GAAiB,IAAI,CAAC;IACtC,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,eAAe,CAAC,MAAM,EAAE,KAAK,IAAI,aAAa,EAAE,CAAC;QAC3E,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,aAAa,CAAC,CAAC;QAClE,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,YAAY,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YACrE,WAAW,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IACD,IAAI,YAAY;QAAE,MAAM,IAAI,2BAA2B,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,OAAsC;IAC9E,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IACnD,OAAO,WAAW,CAAwB;QACxC,UAAU,EAAE,CAAC,eAAe,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,eAAe,CAAC;QACtF,OAAO,EAAE,CAAC,KAAK,EAAE,eAAe,EAAE,EAAE;YAClC,IAAI,KAAK,YAAY,2BAA2B;gBAAE,OAAO,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;;gBACzF,OAAO,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;QACzC,CAAC;KACF,CAAC,CAAC;AACL,CAAC","sourcesContent":["'use client';\n\n/**\n * Generic mutation hook to mark terminal pendingMedia items as seen in the tray.\n *\n * Pure adapter: the consumer supplies `markFn` (typically a wrapped Firebase\n * callable in the consuming app that writes `uploadTraySeenAt`/`uploadTraySeenBy` on the\n * caller's own terminal pendingMedia docs). The package owns the useMutation\n * wiring and the optional `onError` hook; the consumer owns the network call.\n *\n * The provider's Firestore listener observes the `uploadTraySeenAt` write and\n * updates the in-flight upload records automatically — no optimistic update is\n * needed in this hook. Marking seen is tray UX state, not a sensitive action,\n * so it mirrors `useClearUploadActivity` exactly (no audit event).\n *\n * The mutation takes every id to mark (typically every currently-unseen terminal\n * item when the File-status tab opens) and sends them to `markFn` in sequential\n * calls of at most `maxIdsPerCall` — the app's own per-call cap, so no call is\n * refused for its size. A failed call does not stop the rest: its ids simply stay\n * unseen. When any call failed, the mutation fails, and `onError` receives the first\n * failure and every id left unmarked. An empty array makes no call.\n */\n\nimport { useMutation } from '@tanstack/react-query';\n\nexport interface MarkUploadActivitySeenOptions {\n  /** Network call performing the mark-seen for at most `maxIdsPerCall` pendingMediaIds. */\n  markFn: (pendingMediaIds: string[]) => Promise<void>;\n  /** The most ids one `markFn` call accepts — the app's own per-call cap. */\n  maxIdsPerCall: number;\n  /** Optional error callback. Receives the first failure and every id that was not marked. */\n  onError?: (error: Error, pendingMediaIds: string[]) => void;\n}\n\n/** The mutation's failure when one or more calls failed: the first failure, and the ids left unmarked. */\nexport class MarkUploadActivitySeenError extends Error {\n  readonly failure: Error;\n  readonly unmarkedIds: string[];\n\n  constructor(failure: Error, unmarkedIds: string[]) {\n    super(failure.message);\n    this.name = 'MarkUploadActivitySeenError';\n    this.failure = failure;\n    this.unmarkedIds = unmarkedIds;\n  }\n}\n\nasync function markInBatches(\n  markFn: (pendingMediaIds: string[]) => Promise<void>,\n  maxIdsPerCall: number,\n  pendingMediaIds: string[],\n): Promise<void> {\n  if (!Number.isInteger(maxIdsPerCall) || maxIdsPerCall < 1) {\n    throw new Error(`maxIdsPerCall must be a positive whole number, got ${maxIdsPerCall}.`);\n  }\n  let firstFailure: Error | null = null;\n  const unmarkedIds: string[] = [];\n  for (let start = 0; start < pendingMediaIds.length; start += maxIdsPerCall) {\n    const batch = pendingMediaIds.slice(start, start + maxIdsPerCall);\n    try {\n      await markFn(batch);\n    } catch (err) {\n      firstFailure ??= err instanceof Error ? err : new Error(String(err));\n      unmarkedIds.push(...batch);\n    }\n  }\n  if (firstFailure) throw new MarkUploadActivitySeenError(firstFailure, unmarkedIds);\n}\n\nexport function useMarkUploadActivitySeen(options: MarkUploadActivitySeenOptions) {\n  const { markFn, maxIdsPerCall, onError } = options;\n  return useMutation<void, Error, string[]>({\n    mutationFn: (pendingMediaIds) => markInBatches(markFn, maxIdsPerCall, pendingMediaIds),\n    onError: (error, pendingMediaIds) => {\n      if (error instanceof MarkUploadActivitySeenError) onError?.(error.failure, error.unmarkedIds);\n      else onError?.(error, pendingMediaIds);\n    },\n  });\n}\n"]}

package/dist/upload-display.d.ts

@@ -0,0 +1,39 @@
+/** A byte count as a short size: `850 B`, `24 KB`, `1.2 MB`, `3 GB`. `null` for no usable count. */
+export declare function formatFileSize(bytes: number | undefined): string | null;
+/** The app's words for an upload row's time and file kind. */
+export interface UploadDisplayCopy {
+    /** Under a minute old. */
+    justNow: string;
+    minutesAgo: (minutes: number) => string;
+    hoursAgo: (hours: number) => string;
+    /** Accepted on the previous calendar day, given the local clock time. */
+    yesterdayAt: (time: string) => string;
+    /** Accepted before yesterday, given the short local date and clock time. */
+    dateAt: (date: string, time: string) => string;
+    /** The file's kind, by its simplified media type; `other` for anything else. */
+    fileType: {
+        image: string;
+        video: string;
+        audio: string;
+        other: string;
+    };
+}
+export interface UploadDisplayConfig {
+    copy: UploadDisplayCopy;
+    /** How long a row's time reads as relative before it reads as a clock time. */
+    relativeTimeCutoffMs: number;
+    /** Locale for the clock time and date; the runtime's own when omitted. */
+    locale?: Intl.LocalesArgument;
+}
+export interface UploadDisplayFormatters {
+    /**
+     * An upload's accept time. Within the cutoff of now: just now, minutes ago, or hours ago. Older:
+     * the clock time for today, yesterday and the clock time, or the short date and the clock time —
+     * by local calendar day.
+     */
+    formatUploadTimestamp: (createdAtMs: number, nowMs: number) => string;
+    /** The file's kind from its stored content type; `null` when it has none. */
+    getFileTypeLabel: (contentType: string | undefined) => string | null;
+}
+export declare function createUploadDisplayFormatters(config: UploadDisplayConfig): UploadDisplayFormatters;
+//# sourceMappingURL=upload-display.d.ts.map

package/dist/upload-display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-display.d.ts","sourceRoot":"","sources":["../src/upload-display.ts"],"names":[],"mappings":"AAKA,oGAAoG;AACpG,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAUvE;AAED,8DAA8D;AAC9D,MAAM,WAAW,iBAAiB;IAChC,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IACxC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,yEAAyE;IACzE,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACtC,4EAA4E;IAC5E,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/C,gFAAgF;IAChF,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1E;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,iBAAiB,CAAC;IACxB,+EAA+E;IAC/E,oBAAoB,EAAE,MAAM,CAAC;IAC7B,0EAA0E;IAC1E,MAAM,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,qBAAqB,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACtE,6EAA6E;IAC7E,gBAAgB,EAAE,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,GAAG,IAAI,CAAC;CACtE;AAMD,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,mBAAmB,GAAG,uBAAuB,CAwClG"}

package/dist/upload-display.js

@@ -0,0 +1,62 @@
+// What an upload row shows besides its title: the file's size, its kind, and when it was accepted.
+// The mechanics are shared; every word, the relative-time cutoff and the locale are the app's.
+import { getSimplifiedMediaType } from "@ttt-productions/media-schemas";
+/** A byte count as a short size: `850 B`, `24 KB`, `1.2 MB`, `3 GB`. `null` for no usable count. */
+export function formatFileSize(bytes) {
+    if (bytes === undefined || !Number.isFinite(bytes) || bytes < 0)
+        return null;
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${Math.round(bytes / 1024)} KB`;
+    if (bytes < 1024 * 1024 * 1024) {
+        const mb = bytes / (1024 * 1024);
+        return `${mb < 10 ? mb.toFixed(1) : Math.round(mb)} MB`;
+    }
+    const gb = bytes / (1024 * 1024 * 1024);
+    return `${gb < 10 ? gb.toFixed(1) : Math.round(gb)} GB`;
+}
+function sameCalendarDay(a, b) {
+    return a.getFullYear() === b.getFullYear() && a.getMonth() === b.getMonth() && a.getDate() === b.getDate();
+}
+export function createUploadDisplayFormatters(config) {
+    const { copy, relativeTimeCutoffMs, locale } = config;
+    const formatUploadTimestamp = (createdAtMs, nowMs) => {
+        const diffMs = Math.max(0, nowMs - createdAtMs);
+        if (diffMs < relativeTimeCutoffMs) {
+            if (diffMs < 60_000)
+                return copy.justNow;
+            const minutes = Math.floor(diffMs / 60_000);
+            if (minutes < 60)
+                return copy.minutesAgo(minutes);
+            return copy.hoursAgo(Math.floor(diffMs / 3_600_000));
+        }
+        const created = new Date(createdAtMs);
+        const now = new Date(nowMs);
+        const time = created.toLocaleTimeString(locale, { hour: "numeric", minute: "2-digit" });
+        if (sameCalendarDay(created, now))
+            return time;
+        // The previous calendar day, found by stepping the date rather than subtracting 24 hours: a
+        // day that crosses a daylight-saving change is 23 or 25 hours long.
+        const yesterday = new Date(now.getFullYear(), now.getMonth(), now.getDate() - 1);
+        if (sameCalendarDay(created, yesterday))
+            return copy.yesterdayAt(time);
+        return copy.dateAt(created.toLocaleDateString(locale, { month: "short", day: "numeric" }), time);
+    };
+    const getFileTypeLabel = (contentType) => {
+        if (!contentType)
+            return null;
+        switch (getSimplifiedMediaType(contentType)) {
+            case "image":
+                return copy.fileType.image;
+            case "video":
+                return copy.fileType.video;
+            case "audio":
+                return copy.fileType.audio;
+            default:
+                return copy.fileType.other;
+        }
+    };
+    return { formatUploadTimestamp, getFileTypeLabel };
+}
+//# sourceMappingURL=upload-display.js.map

package/dist/upload-display.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-display.js","sourceRoot":"","sources":["../src/upload-display.ts"],"names":[],"mappings":"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","sourcesContent":["// What an upload row shows besides its title: the file's size, its kind, and when it was accepted.\n// The mechanics are shared; every word, the relative-time cutoff and the locale are the app's.\n\nimport { getSimplifiedMediaType } from \"@ttt-productions/media-schemas\";\n\n/** A byte count as a short size: `850 B`, `24 KB`, `1.2 MB`, `3 GB`. `null` for no usable count. */\nexport function formatFileSize(bytes: number | undefined): string | null {\n  if (bytes === undefined || !Number.isFinite(bytes) || bytes < 0) return null;\n  if (bytes < 1024) return `${bytes} B`;\n  if (bytes < 1024 * 1024) return `${Math.round(bytes / 1024)} KB`;\n  if (bytes < 1024 * 1024 * 1024) {\n    const mb = bytes / (1024 * 1024);\n    return `${mb < 10 ? mb.toFixed(1) : Math.round(mb)} MB`;\n  }\n  const gb = bytes / (1024 * 1024 * 1024);\n  return `${gb < 10 ? gb.toFixed(1) : Math.round(gb)} GB`;\n}\n\n/** The app's words for an upload row's time and file kind. */\nexport interface UploadDisplayCopy {\n  /** Under a minute old. */\n  justNow: string;\n  minutesAgo: (minutes: number) => string;\n  hoursAgo: (hours: number) => string;\n  /** Accepted on the previous calendar day, given the local clock time. */\n  yesterdayAt: (time: string) => string;\n  /** Accepted before yesterday, given the short local date and clock time. */\n  dateAt: (date: string, time: string) => string;\n  /** The file's kind, by its simplified media type; `other` for anything else. */\n  fileType: { image: string; video: string; audio: string; other: string };\n}\n\nexport interface UploadDisplayConfig {\n  copy: UploadDisplayCopy;\n  /** How long a row's time reads as relative before it reads as a clock time. */\n  relativeTimeCutoffMs: number;\n  /** Locale for the clock time and date; the runtime's own when omitted. */\n  locale?: Intl.LocalesArgument;\n}\n\nexport interface UploadDisplayFormatters {\n  /**\n   * An upload's accept time. Within the cutoff of now: just now, minutes ago, or hours ago. Older:\n   * the clock time for today, yesterday and the clock time, or the short date and the clock time —\n   * by local calendar day.\n   */\n  formatUploadTimestamp: (createdAtMs: number, nowMs: number) => string;\n  /** The file's kind from its stored content type; `null` when it has none. */\n  getFileTypeLabel: (contentType: string | undefined) => string | null;\n}\n\nfunction sameCalendarDay(a: Date, b: Date): boolean {\n  return a.getFullYear() === b.getFullYear() && a.getMonth() === b.getMonth() && a.getDate() === b.getDate();\n}\n\nexport function createUploadDisplayFormatters(config: UploadDisplayConfig): UploadDisplayFormatters {\n  const { copy, relativeTimeCutoffMs, locale } = config;\n\n  const formatUploadTimestamp = (createdAtMs: number, nowMs: number): string => {\n    const diffMs = Math.max(0, nowMs - createdAtMs);\n    if (diffMs < relativeTimeCutoffMs) {\n      if (diffMs < 60_000) return copy.justNow;\n      const minutes = Math.floor(diffMs / 60_000);\n      if (minutes < 60) return copy.minutesAgo(minutes);\n      return copy.hoursAgo(Math.floor(diffMs / 3_600_000));\n    }\n\n    const created = new Date(createdAtMs);\n    const now = new Date(nowMs);\n    const time = created.toLocaleTimeString(locale, { hour: \"numeric\", minute: \"2-digit\" });\n    if (sameCalendarDay(created, now)) return time;\n\n    // The previous calendar day, found by stepping the date rather than subtracting 24 hours: a\n    // day that crosses a daylight-saving change is 23 or 25 hours long.\n    const yesterday = new Date(now.getFullYear(), now.getMonth(), now.getDate() - 1);\n    if (sameCalendarDay(created, yesterday)) return copy.yesterdayAt(time);\n\n    return copy.dateAt(created.toLocaleDateString(locale, { month: \"short\", day: \"numeric\" }), time);\n  };\n\n  const getFileTypeLabel = (contentType: string | undefined): string | null => {\n    if (!contentType) return null;\n    switch (getSimplifiedMediaType(contentType)) {\n      case \"image\":\n        return copy.fileType.image;\n      case \"video\":\n        return copy.fileType.video;\n      case \"audio\":\n        return copy.fileType.audio;\n      default:\n        return copy.fileType.other;\n    }\n  };\n\n  return { formatUploadTimestamp, getFileTypeLabel };\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttt-productions/upload-ui",
-  "version": "0.7.15",
+  "version": "0.7.16",
   "description": "Upload UI primitives: local upload guard provider, useGuardedUpload helper, DeferredUploadFormShell for forms that defer Firebase Storage upload until form submit.",
   "repository": {
     "type": "git",
@@ -40,9 +40,9 @@
     "prepublishOnly": "npm run clean && npm run build"
   },
   "dependencies": {
-    "@ttt-productions/file-input": "^0.11.14",
-    "@ttt-productions/media-schemas": "^0.14.9",
-    "@ttt-productions/ui-core": "^0.11.30",
+    "@ttt-productions/file-input": "^0.11.15",
+    "@ttt-productions/media-schemas": "^0.14.10",
+    "@ttt-productions/ui-core": "^0.11.33",
     "@ttt-productions/upload-core": "^0.7.5"
   },
   "peerDependencies": {