saltfish 0.2.72 → 0.2.74

package/dist/types/index.d.ts

@@ -82,7 +82,7 @@ export declare const TIMING: {
     readonly CURSOR_UPDATE_THROTTLE: 100;
     readonly ANALYTICS_FLUSH_INTERVAL: 30000;
     readonly USER_DATA_TIMEOUT: 5000;
-    readonly STEP_TIMEOUT: 60000;
+    readonly STEP_TIMEOUT: 120000;
     readonly CURSOR_DEFAULT_DISTANCE: 100;
     readonly SESSION_EXPIRY: number;
 };

package/dist/utils/progressUtils.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Maximum age in milliseconds for saved progress to be considered valid
+ * Progress older than this will be ignored and playlists will start from beginning
+ */
+export declare const MAX_PROGRESS_AGE_MS = 6000;
+/**
+ * Parses a timestamp from various formats (Firestore, number, etc.)
+ * @param progressData - The progress data object containing timestamp information
+ * @returns Timestamp in milliseconds, or null if no valid timestamp found
+ */
+export declare function parseProgressTimestamp(progressData: any): number | null;
+/**
+ * Checks if saved progress is recent enough to be used for resuming playback
+ * @param progressData - The progress data object containing timestamp information
+ * @param maxAgeMs - Maximum age in milliseconds (defaults to MAX_PROGRESS_AGE_MS)
+ * @returns Object with isValid boolean and ageMs number
+ */
+export declare function isProgressRecent(progressData: any, maxAgeMs?: number): {
+    isValid: boolean;
+    ageMs: number | null;
+    timestampMs: number | null;
+};
+/**
+ * Logs progress validation details for debugging
+ * @param playlistId - The playlist ID being checked
+ * @param progressData - The progress data object
+ * @param context - Context string for the log (e.g., 'PlaylistLoader', 'PlayerInitializationService')
+ */
+export declare function logProgressValidation(playlistId: string, progressData: any, context: string): void;
+//# sourceMappingURL=progressUtils.d.ts.map

package/dist/utils/progressUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progressUtils.d.ts","sourceRoot":"","sources":["../../src/utils/progressUtils.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI,CAuBvE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,GAAG,EACjB,QAAQ,GAAE,MAA4B,GACrC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAexE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,GAAG,EACjB,OAAO,EAAE,MAAM,GACd,IAAI,CAmBN"}

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.2.71";
+export declare const VERSION = "0.2.73";
 //# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "saltfish",
-  "version": "0.2.72",
+  "version": "0.2.74",
   "description": "An interactive video-guided tour system for web applications",
   "main": "dist/saltfish-playlist-player.umd.js",
   "types": "dist/index.d.ts",