@sparkvault/sdk-mobile 7.0.0 → 7.0.2

package/src/types.ts

@@ -743,11 +743,10 @@ export interface UploadResult {
    */
   created?: boolean;
   /**
-   * The ingot status the upload last observed: `active` when the server
-   * confirmed activation. Anything else means the transfer completed but the
-   * activation poll budget ran out first - the ingot usually activates
-   * moments later, but a caller recording "backed up" must not take that on
-   * faith (resume the session later; Forge re-confirms finalization).
+   * The ingot status the upload confirmed: `active`, the server's read of
+   * the published ingot. An upload whose activation the poll budget could
+   * not confirm never resolves: it rejects with a `TusUploadError` whose
+   * `retryLater` is set.
    */
   status?: Ingot['status'];
 }
@@ -866,14 +865,23 @@ export interface MobileFileReader {
 
 /**
  * A tus upload session as Forge created it: the session URL, the per-upload
- * token every request on it must carry, and the chunk geometry Forge fixed
- * for it. Persist it to resume the upload after a failed attempt or a
- * relaunch (`ingots.resumeUpload`) instead of re-sending bytes Forge holds.
+ * token every request on it must carry, the chunk geometry Forge fixed for
+ * it, and when it lapses. Persist it to resume the upload after a failed
+ * attempt or a relaunch (`ingots.resumeUpload`) instead of re-sending bytes
+ * Forge holds.
  */
 export interface TusSessionInfo {
   uploadUrl: string;
   istk: string;
   chunkSize: number;
+  /**
+   * When the session lapses (epoch ms, Forge's `Upload-Expires`), or null
+   * when Forge named no expiry. Forge slides it forward on every committed
+   * chunk, so a caller that persists the session keeps this current through
+   * the upload's `onSessionExpiry`; past it, Forge refuses every request to
+   * the session (`isSessionExpired`).
+   */
+  expiresAt: number | null;
 }
 
 /**