@react-text-game/core 0.1.0

package/dist/saves/helpers.js

@@ -0,0 +1,84 @@
+import CryptoJS from "crypto-js";
+import { _getOptions } from "../options";
+import { ITERATIONS, KEY_SIZE, SAVE_POSTFIX } from "./constants";
+/**
+ * Generates the encryption password by combining game ID with save postfix
+ * @returns Password string for encryption/decryption
+ */
+const getPassword = () => `${_getOptions().gameId}.${SAVE_POSTFIX}`;
+/**
+ * Encodes (encrypts) data using AES encryption with PBKDF2 key derivation.
+ * The output is a byte array that can be saved to a file.
+ *
+ * @template T - Type of data to encode
+ * @param data - Data to encrypt
+ * @returns Uint8Array containing encrypted data with salt and IV prepended
+ */
+export const encodeSf = (data) => {
+    const salt = CryptoJS.lib.WordArray.random(128 / 8);
+    const key = CryptoJS.PBKDF2(getPassword(), salt, {
+        keySize: KEY_SIZE,
+        iterations: ITERATIONS,
+    });
+    const iv = CryptoJS.lib.WordArray.random(128 / 8);
+    const encrypted = CryptoJS.AES.encrypt(JSON.stringify(data), key, {
+        iv: iv,
+        padding: CryptoJS.pad.Pkcs7,
+        mode: CryptoJS.mode.CBC,
+    });
+    const transitMessage = salt.toString(CryptoJS.enc.Base64) +
+        iv.toString(CryptoJS.enc.Base64) +
+        encrypted.toString();
+    return new TextEncoder().encode(transitMessage);
+};
+/**
+ * Decodes (decrypts) data that was encrypted using encodeSf.
+ * Extracts salt and IV from the encrypted data and uses them to decrypt.
+ *
+ * @template T - Expected type of the decrypted data
+ * @param data - ArrayBuffer containing encrypted data
+ * @returns Decrypted data of type T
+ * @throws Error if decryption fails (corrupted data or password mismatch)
+ */
+export const decodeSf = (data) => {
+    const transitMessage = new TextDecoder().decode(data);
+    const saltString = transitMessage.substring(0, 24);
+    const ivString = transitMessage.substring(24, 48);
+    const encryptedString = transitMessage.substring(48);
+    const salt = CryptoJS.enc.Base64.parse(saltString);
+    const iv = CryptoJS.enc.Base64.parse(ivString);
+    const key = CryptoJS.PBKDF2(getPassword(), salt, {
+        keySize: KEY_SIZE,
+        iterations: ITERATIONS,
+    });
+    const decrypted = CryptoJS.AES.decrypt(encryptedString, key, {
+        iv: iv,
+        padding: CryptoJS.pad.Pkcs7,
+        mode: CryptoJS.mode.CBC,
+    });
+    const jsonString = decrypted.toString(CryptoJS.enc.Utf8);
+    if (!jsonString) {
+        throw new Error("Failed to decrypt. Data might be corrupted or the password/logic has changed.");
+    }
+    return JSON.parse(jsonString);
+};
+/**
+ * Formats a Date object into a human-readable string.
+ * Format: "DD of MONTH, YYYY HH:MM" (24-hour format)
+ *
+ * @param timestamp - Date to format
+ * @returns Formatted date string (e.g., "15 of January, 2025 14:30")
+ */
+export const getDateString = (timestamp) => {
+    const date = new Date(timestamp);
+    const day = date.getDate();
+    const month = date.toLocaleString("default", { month: "long" });
+    const year = date.getFullYear();
+    const time = date.toLocaleTimeString("default", {
+        hour: "2-digit",
+        minute: "2-digit",
+        hour12: false,
+    });
+    return `${day} of ${month}, ${year} ${time}`;
+};
+//# sourceMappingURL=helpers.js.map

package/dist/saves/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/saves/helpers.ts"],"names":[],"mappings":"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"}

package/dist/saves/hooks/index.d.ts

@@ -0,0 +1,10 @@
+export * from "./useDeleteAllSlots";
+export * from "./useDeleteGame";
+export * from "./useExportSaves";
+export * from "./useImportSaves";
+export * from "./useLastLoadGame";
+export * from "./useLoadGame";
+export * from "./useRestartGame";
+export * from "./useSaveGame";
+export * from "./useSaveSlots";
+//# sourceMappingURL=index.d.ts.map

package/dist/saves/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/saves/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC"}

package/dist/saves/hooks/index.js

@@ -0,0 +1,10 @@
+export * from "./useDeleteAllSlots";
+export * from "./useDeleteGame";
+export * from "./useExportSaves";
+export * from "./useImportSaves";
+export * from "./useLastLoadGame";
+export * from "./useLoadGame";
+export * from "./useRestartGame";
+export * from "./useSaveGame";
+export * from "./useSaveSlots";
+//# sourceMappingURL=index.js.map

package/dist/saves/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/saves/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC"}

package/dist/saves/hooks/useDeleteAllSlots.d.ts

@@ -0,0 +1,18 @@
+import { deleteAllGameSaves } from "../../saves";
+/**
+ * React hook that provides a function to delete all game saves.
+ * This function clears all saved game data from the database.
+ *
+ * @returns Callback function that deletes all game saves
+ *
+ * @example
+ * ```tsx
+ * const deleteAllSaves = useDeleteAllSaves();
+ * const handleDeleteAll = async () => {
+ *   await deleteAllSaves();
+ *   console.log('All game saves have been deleted.');
+ * };
+ * ```
+ */
+export declare const useDeleteAllSaves: () => typeof deleteAllGameSaves;
+//# sourceMappingURL=useDeleteAllSlots.d.ts.map

package/dist/saves/hooks/useDeleteAllSlots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDeleteAllSlots.d.ts","sourceRoot":"","sources":["../../../src/saves/hooks/useDeleteAllSlots.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAE5C;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,iBAAiB,iCAA2B,CAAC"}

package/dist/saves/hooks/useDeleteAllSlots.js

@@ -0,0 +1,18 @@
+import { deleteAllGameSaves } from "../../saves";
+/**
+ * React hook that provides a function to delete all game saves.
+ * This function clears all saved game data from the database.
+ *
+ * @returns Callback function that deletes all game saves
+ *
+ * @example
+ * ```tsx
+ * const deleteAllSaves = useDeleteAllSaves();
+ * const handleDeleteAll = async () => {
+ *   await deleteAllSaves();
+ *   console.log('All game saves have been deleted.');
+ * };
+ * ```
+ */
+export const useDeleteAllSaves = () => deleteAllGameSaves;
+//# sourceMappingURL=useDeleteAllSlots.js.map

package/dist/saves/hooks/useDeleteAllSlots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDeleteAllSlots.js","sourceRoot":"","sources":["../../../src/saves/hooks/useDeleteAllSlots.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAE5C;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,EAAE,CAAC,kBAAkB,CAAC"}

package/dist/saves/hooks/useDeleteGame.d.ts

@@ -0,0 +1,22 @@
+/**
+ * React hook that provides a function to delete a saved game by its ID.
+ * Removes the save from IndexedDB storage.
+ *
+ * @returns Function that accepts a save ID and deletes the game, returning a result object on failure
+ *
+ * @example
+ * ```tsx
+ * const deleteGame = useDeleteGame();
+ * const handleDelete = async () => {
+ *   const result = await deleteGame(saveId);
+ *   if (result?.success === false) {
+ *     console.error('Delete failed:', result.message);
+ *   }
+ * };
+ * ```
+ */
+export declare const useDeleteGame: () => (id: number) => Promise<{
+    success: boolean;
+    message: string;
+} | undefined>;
+//# sourceMappingURL=useDeleteGame.d.ts.map

package/dist/saves/hooks/useDeleteGame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDeleteGame.d.ts","sourceRoot":"","sources":["../../../src/saves/hooks/useDeleteGame.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,aAAa,SAAgB,IAAI,MAAM;;;cAYnD,CAAC"}

package/dist/saves/hooks/useDeleteGame.js

@@ -0,0 +1,33 @@
+import { logger } from "../../logger";
+import { deleteSave } from "../../saves";
+/**
+ * React hook that provides a function to delete a saved game by its ID.
+ * Removes the save from IndexedDB storage.
+ *
+ * @returns Function that accepts a save ID and deletes the game, returning a result object on failure
+ *
+ * @example
+ * ```tsx
+ * const deleteGame = useDeleteGame();
+ * const handleDelete = async () => {
+ *   const result = await deleteGame(saveId);
+ *   if (result?.success === false) {
+ *     console.error('Delete failed:', result.message);
+ *   }
+ * };
+ * ```
+ */
+export const useDeleteGame = () => async (id) => {
+    try {
+        await deleteSave(id);
+    }
+    catch (e) {
+        logger.error("Failed to delete save:", e);
+        return {
+            success: false,
+            message: e.message ||
+                "Failed to delete save. Check console for more info.",
+        };
+    }
+};
+//# sourceMappingURL=useDeleteGame.js.map

package/dist/saves/hooks/useDeleteGame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDeleteGame.js","sourceRoot":"","sources":["../../../src/saves/hooks/useDeleteGame.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,EAAE,CAAC,KAAK,EAAE,EAAU,EAAE,EAAE;IACpD,IAAI,CAAC;QACD,MAAM,UAAU,CAAC,EAAE,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE,CAAC,CAAC,CAAC;QAC1C,OAAO;YACH,OAAO,EAAE,KAAK;YACd,OAAO,EACF,CAAW,CAAC,OAAO;gBACpB,qDAAqD;SAC5D,CAAC;IACN,CAAC;AACL,CAAC,CAAC"}

package/dist/saves/hooks/useExportSaves.d.ts

@@ -0,0 +1,27 @@
+/**
+ * React hook that provides a function to export all game saves to an encrypted file.
+ * The exported file is downloaded with the game name, version, and .sx extension.
+ *
+ * @returns Callback function that exports saves and returns a result object
+ *
+ * @example
+ * ```tsx
+ * const exportSaves = useExportSaves();
+ * const handleExport = async () => {
+ *   const result = await exportSaves();
+ *   if (result.success) {
+ *     console.log('Saves exported successfully');
+ *   } else {
+ *     console.error('Export failed:', result.error);
+ *   }
+ * };
+ * ```
+ */
+export declare const useExportSaves: () => () => Promise<{
+    success: boolean;
+    error: string;
+} | {
+    success: boolean;
+    error: null;
+}>;
+//# sourceMappingURL=useExportSaves.d.ts.map

package/dist/saves/hooks/useExportSaves.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useExportSaves.d.ts","sourceRoot":"","sources":["../../../src/saves/hooks/useExportSaves.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,cAAc;;;;;;EA+B1B,CAAC"}

package/dist/saves/hooks/useExportSaves.js

@@ -0,0 +1,54 @@
+import { useCallback } from "react";
+import { _getOptions } from "../../options";
+import { SAFE_FILE_EXTENSION } from "../../saves/constants";
+import { getAllSaves } from "../../saves/db";
+import { encodeSf } from "../../saves/helpers";
+/**
+ * React hook that provides a function to export all game saves to an encrypted file.
+ * The exported file is downloaded with the game name, version, and .sx extension.
+ *
+ * @returns Callback function that exports saves and returns a result object
+ *
+ * @example
+ * ```tsx
+ * const exportSaves = useExportSaves();
+ * const handleExport = async () => {
+ *   const result = await exportSaves();
+ *   if (result.success) {
+ *     console.log('Saves exported successfully');
+ *   } else {
+ *     console.error('Export failed:', result.error);
+ *   }
+ * };
+ * ```
+ */
+export const useExportSaves = () => {
+    return useCallback(async () => {
+        const options = _getOptions();
+        const allSaves = await getAllSaves();
+        if (allSaves.length === 0) {
+            return { success: false, error: "No saves found" };
+        }
+        try {
+            const data = encodeSf(allSaves);
+            const blob = new Blob([data], { type: "application/octet-stream" });
+            const url = URL.createObjectURL(blob);
+            const a = document.createElement("a");
+            a.href = url;
+            a.download = `${options.gameName}-${options.gameVersion}${SAFE_FILE_EXTENSION}`;
+            a.click();
+            a.remove();
+            URL.revokeObjectURL(url);
+            return { success: true, error: null };
+        }
+        catch (e) {
+            console.error(e);
+            return {
+                success: false,
+                error: e.message ||
+                    "Unknown error, check console for more info",
+            };
+        }
+    }, []);
+};
+//# sourceMappingURL=useExportSaves.js.map

package/dist/saves/hooks/useExportSaves.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useExportSaves.js","sourceRoot":"","sources":["../../../src/saves/hooks/useExportSaves.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAEpC,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,EAAE;IAC/B,OAAO,WAAW,CAAC,KAAK,IAAI,EAAE;QAC1B,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;QAE9B,MAAM,QAAQ,GAAG,MAAM,WAAW,EAAE,CAAC;QACrC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;QACvD,CAAC;QAED,IAAI,CAAC;YACD,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAChC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,0BAA0B,EAAE,CAAC,CAAC;YACpE,MAAM,GAAG,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YACtC,MAAM,CAAC,GAAG,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;YACtC,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC;YACb,CAAC,CAAC,QAAQ,GAAG,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,WAAW,GAAG,mBAAmB,EAAE,CAAC;YAChF,CAAC,CAAC,KAAK,EAAE,CAAC;YACV,CAAC,CAAC,MAAM,EAAE,CAAC;YACX,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YAEzB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAC1C,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACjB,OAAO;gBACH,OAAO,EAAE,KAAK;gBACd,KAAK,EACA,CAAW,CAAC,OAAO;oBACpB,4CAA4C;aACnD,CAAC;QACN,CAAC;IACL,CAAC,EAAE,EAAE,CAAC,CAAC;AACX,CAAC,CAAC"}

package/dist/saves/hooks/useImportSaves.d.ts

@@ -0,0 +1,29 @@
+/**
+ * React hook that provides a function to import game saves from an encrypted file.
+ * Opens a file picker, decrypts the selected file, and replaces all existing saves.
+ *
+ * @returns Callback function that imports saves and returns a result object with success status, count, and error
+ *
+ * @example
+ * ```tsx
+ * const importSaves = useImportSaves();
+ * const handleImport = async () => {
+ *   const result = await importSaves();
+ *   if (result.success) {
+ *     console.log(`Successfully imported ${result.count} saves`);
+ *   } else {
+ *     console.error('Import failed:', result.error);
+ *   }
+ * };
+ * ```
+ */
+export declare const useImportSaves: () => () => Promise<{
+    success: boolean;
+    count: number;
+    error: string;
+} | {
+    success: boolean;
+    count: number;
+    error: null;
+}>;
+//# sourceMappingURL=useImportSaves.d.ts.map

package/dist/saves/hooks/useImportSaves.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useImportSaves.d.ts","sourceRoot":"","sources":["../../../src/saves/hooks/useImportSaves.ts"],"names":[],"mappings":"AA2BA;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,cAAc;;;;;;;;EA+E1B,CAAC"}

package/dist/saves/hooks/useImportSaves.js

@@ -0,0 +1,108 @@
+import { useCallback } from "react";
+import { deleteAllGameSaves, saveGame } from "../../saves";
+import { SAFE_FILE_EXTENSION } from "../../saves/constants";
+import { decodeSf } from "../../saves/helpers";
+/**
+ * Helper function to create a file picker and wait for user selection
+ * @param input - HTMLInputElement configured as file picker
+ * @returns Promise resolving to selected File or null if cancelled
+ */
+const createFile = async (input) => new Promise((resolve) => {
+    input.onchange = (event) => {
+        const target = event.target;
+        const selectedFile = target.files?.[0] || null;
+        resolve(selectedFile);
+    };
+    input.oncancel = () => {
+        resolve(null);
+    };
+    // Trigger file explorer
+    input.click();
+});
+/**
+ * React hook that provides a function to import game saves from an encrypted file.
+ * Opens a file picker, decrypts the selected file, and replaces all existing saves.
+ *
+ * @returns Callback function that imports saves and returns a result object with success status, count, and error
+ *
+ * @example
+ * ```tsx
+ * const importSaves = useImportSaves();
+ * const handleImport = async () => {
+ *   const result = await importSaves();
+ *   if (result.success) {
+ *     console.log(`Successfully imported ${result.count} saves`);
+ *   } else {
+ *     console.error('Import failed:', result.error);
+ *   }
+ * };
+ * ```
+ */
+export const useImportSaves = () => {
+    return useCallback(async () => {
+        const input = document.createElement("input");
+        input.type = "file";
+        input.accept = SAFE_FILE_EXTENSION;
+        input.multiple = false;
+        const file = await createFile(input);
+        if (!file) {
+            return { success: false, count: 0, error: "No file selected" };
+        }
+        if (!file.name.endsWith(SAFE_FILE_EXTENSION)) {
+            return {
+                success: false,
+                count: 0,
+                error: `Invalid file type. Please select a file with ${SAFE_FILE_EXTENSION} extension.`,
+            };
+        }
+        const arrayBuffer = await file.arrayBuffer();
+        let saves = [];
+        try {
+            saves = decodeSf(arrayBuffer);
+        }
+        catch (e) {
+            console.error(e);
+            return {
+                success: false,
+                count: 0,
+                error: e.message ||
+                    "Failed to decode save file. Check console for more info.",
+            };
+        }
+        if (!saves || !Array.isArray(saves)) {
+            return {
+                success: false,
+                count: 0,
+                error: "Invalid save file format",
+            };
+        }
+        try {
+            await deleteAllGameSaves();
+        }
+        catch (e) {
+            console.error(e);
+            return {
+                success: false,
+                count: 0,
+                error: e.message ||
+                    "Failed to clear existing saves. Check console for more info.",
+            };
+        }
+        let count = 0;
+        for (const save of saves) {
+            try {
+                await saveGame(save.name, save.gameData, save.description, save.screenshot);
+                count++;
+            }
+            catch (e) {
+                console.error(e);
+            }
+        }
+        return {
+            success: true,
+            count,
+            error: null,
+        };
+    }, []);
+};
+//# sourceMappingURL=useImportSaves.js.map

package/dist/saves/hooks/useImportSaves.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useImportSaves.js","sourceRoot":"","sources":["../../../src/saves/hooks/useImportSaves.ts"],"names":[],"mappings":"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"}

package/dist/saves/hooks/useLastLoadGame.d.ts

@@ -0,0 +1,39 @@
+import { GameSave } from "../../saves";
+/**
+ * A custom hook for managing the loading of the last saved game state.
+ *
+ * This hook provides functionality to determine the availability of the last saved game, as well as to load and restore the game data from the saved state.
+ * It uses reactive data fetching and caching mechanisms to seamlessly manage game state retrieval.
+ *
+ * @function useLastLoadGame
+ * @returns Returns an object containing:
+ * - `hasLastSave` {boolean}: Indicates whether a last saved game exists.
+ * - `loadLastGame` {Function}: Asynchronous function to load the last saved game state.
+ * - `isLoading` {boolean}: Represents whether the last save status is currently being determined.
+ * - `lastSave` {Object|null}: The last saved game data object, or null if not available.
+ *
+ * @example
+ * ```tsx
+ * const { hasLastSave, loadLastGame, isLoading } = useGetLastLoadGame();
+ *
+ * if (isLoading) {
+ *   return <div>Loading...</div>;
+ * }
+ *
+ * return (
+ *   <button onClick={loadLastGame} disabled={!hasLastSave}>
+ *     Continue Last Game
+ *   </button>
+ * );
+ * ```
+ */
+export declare const useLastLoadGame: () => {
+    hasLastSave: boolean;
+    loadLastGame: () => Promise<{
+        success: boolean;
+        error: string;
+    } | undefined>;
+    isLoading: boolean;
+    lastSave: GameSave | null;
+};
+//# sourceMappingURL=useLastLoadGame.d.ts.map

package/dist/saves/hooks/useLastLoadGame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLastLoadGame.d.ts","sourceRoot":"","sources":["../../../src/saves/hooks/useLastLoadGame.ts"],"names":[],"mappings":"AAIA,OAAO,EAAM,QAAQ,EAAY,MAAM,QAAQ,CAAC;AAUhD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,eAAe;;;;;;;;CAkC3B,CAAC"}

package/dist/saves/hooks/useLastLoadGame.js

@@ -0,0 +1,72 @@
+import { useLiveQuery } from "dexie-react-hooks";
+import { useCallback } from "react";
+import { Game } from "../../game";
+import { db, loadGame } from "../../saves";
+const getLastSave = async () => {
+    const save = await db.saves
+        .filter((save) => !save.isSystemSave)
+        .reverse()
+        .sortBy("timestamp");
+    return save[0] ?? null;
+};
+/**
+ * A custom hook for managing the loading of the last saved game state.
+ *
+ * This hook provides functionality to determine the availability of the last saved game, as well as to load and restore the game data from the saved state.
+ * It uses reactive data fetching and caching mechanisms to seamlessly manage game state retrieval.
+ *
+ * @function useLastLoadGame
+ * @returns Returns an object containing:
+ * - `hasLastSave` {boolean}: Indicates whether a last saved game exists.
+ * - `loadLastGame` {Function}: Asynchronous function to load the last saved game state.
+ * - `isLoading` {boolean}: Represents whether the last save status is currently being determined.
+ * - `lastSave` {Object|null}: The last saved game data object, or null if not available.
+ *
+ * @example
+ * ```tsx
+ * const { hasLastSave, loadLastGame, isLoading } = useGetLastLoadGame();
+ *
+ * if (isLoading) {
+ *   return <div>Loading...</div>;
+ * }
+ *
+ * return (
+ *   <button onClick={loadLastGame} disabled={!hasLastSave}>
+ *     Continue Last Game
+ *   </button>
+ * );
+ * ```
+ */
+export const useLastLoadGame = () => {
+    const lastSave = useLiveQuery(getLastSave, [], null);
+    const loadLastGame = useCallback(async () => {
+        if (!lastSave?.id)
+            return;
+        const saveId = Number(lastSave.name);
+        if (isNaN(saveId)) {
+            throw new Error("Invalid save ID");
+        }
+        try {
+            const data = await loadGame(saveId);
+            if (!data) {
+                return { success: false, error: "Game data not found" };
+            }
+            Game.setState(data.gameData);
+        }
+        catch (e) {
+            console.error("Failed to load last game:", e);
+            return {
+                success: false,
+                error: e.message ||
+                    "Unknown error occurred while loading the game, please, check console for more info",
+            };
+        }
+    }, [lastSave?.id]);
+    return {
+        hasLastSave: !!lastSave,
+        loadLastGame,
+        isLoading: lastSave === undefined,
+        lastSave: lastSave ?? null,
+    };
+};
+//# sourceMappingURL=useLastLoadGame.js.map

package/dist/saves/hooks/useLastLoadGame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLastLoadGame.js","sourceRoot":"","sources":["../../../src/saves/hooks/useLastLoadGame.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAEpC,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAC7B,OAAO,EAAE,EAAE,EAAY,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAEhD,MAAM,WAAW,GAAG,KAAK,IAA8B,EAAE;IACrD,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,KAAK;SACtB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC;SACpC,OAAO,EAAE;SACT,MAAM,CAAC,WAAW,CAAC,CAAC;IACzB,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAC3B,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,EAAE;IAChC,MAAM,QAAQ,GAAG,YAAY,CAAC,WAAW,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;IAErD,MAAM,YAAY,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QACxC,IAAI,CAAC,QAAQ,EAAE,EAAE;YAAE,OAAO;QAE1B,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACvC,CAAC;QAED,IAAI,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;YACpC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACR,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC;YAC5D,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,CAAC,CAAC,CAAC;YAC9C,OAAO;gBACH,OAAO,EAAE,KAAK;gBACd,KAAK,EACA,CAAW,CAAC,OAAO;oBACpB,oFAAoF;aAC3F,CAAC;QACN,CAAC;IACL,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;IAEnB,OAAO;QACH,WAAW,EAAE,CAAC,CAAC,QAAQ;QACvB,YAAY;QACZ,SAAS,EAAE,QAAQ,KAAK,SAAS;QACjC,QAAQ,EAAE,QAAQ,IAAI,IAAI;KAC7B,CAAC;AACN,CAAC,CAAC"}

package/dist/saves/hooks/useLoadGame.d.ts

@@ -0,0 +1,22 @@
+/**
+ * React hook that provides a function to load a saved game by its ID.
+ * Restores the game state from the specified save.
+ *
+ * @returns Function that accepts an optional save ID and loads the game, returning a result object on failure
+ *
+ * @example
+ * ```tsx
+ * const loadGame = useLoadGame();
+ * const handleLoad = async () => {
+ *   const result = await loadGame(saveId);
+ *   if (result?.success === false) {
+ *     console.error('Load failed:', result.message);
+ *   }
+ * };
+ * ```
+ */
+export declare const useLoadGame: () => (id: number) => Promise<{
+    success: boolean;
+    message: string;
+} | undefined>;
+//# sourceMappingURL=useLoadGame.d.ts.map

package/dist/saves/hooks/useLoadGame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLoadGame.d.ts","sourceRoot":"","sources":["../../../src/saves/hooks/useLoadGame.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,WAAW,SAAgB,IAAI,MAAM;;;cAmBjD,CAAC"}