koin.js 1.0.5 → 1.0.7

package/dist/index.d.mts

@@ -266,6 +266,7 @@ interface UseNostalgistOptions {
     initialVolume?: number;
     romFileName?: string;
     shader?: string;
+    romId?: string;
 }
 interface UseNostalgistReturn {
     status: EmulatorStatus;
@@ -306,7 +307,7 @@ interface UseNostalgistReturn {
     getNostalgistInstance: () => Nostalgist | null;
     isPerformanceMode: boolean;
 }
-declare const useNostalgist: ({ system, romUrl, core, biosUrl, initialState, getCanvasElement, keyboardControls, gamepadBindings, retroAchievements, onReady, onError, initialVolume, romFileName, shader, }: UseNostalgistOptions) => UseNostalgistReturn;
+declare const useNostalgist: ({ system, romUrl, core, biosUrl, initialState, getCanvasElement, keyboardControls, gamepadBindings, retroAchievements, onReady, onError, initialVolume, romFileName, shader, romId, }: UseNostalgistOptions) => UseNostalgistReturn;
 
 /**
  * Available CRT Shader Presets
@@ -855,4 +856,10 @@ interface UseGameRecordingReturn {
  */
 declare function useGameRecording({ getCanvasElement, }: UseGameRecordingProps): UseGameRecordingReturn;
 
-export { ALL_BUTTONS, AchievementPopup, BUTTON_GROUPS, BUTTON_LABELS, type ButtonId, CONSOLE_CAPABILITIES, CONSOLE_KEYBOARD_OVERRIDES, type Cheat, type CheatModalProps, type ConsoleCapabilities, type ControlConfig, type ControlMapperProps, type ControlMapping, type ControllerBrand, DEFAULT_CONTROLS, DEFAULT_GAMEPAD, DEFAULT_KEYBOARD, DPAD_BUTTONS, type EmulatorStatus, FACE_BUTTONS, GamePlayer, type GamePlayerProps, type GamepadInfo, type GamepadMapping, type KeyboardMapping, PERFORMANCE_TIER_1_SYSTEMS, PERFORMANCE_TIER_2_SYSTEMS, type PlayerControlsProps, type PlayerIndex, type RAAchievement, type RACredentials, type RAGame, type RAGameExtended, type RAHardcodeRestrictions, RASidebar, type RAUser, RA_MEDIA_BASE, type RetroAchievementsConfig, SHADER_PRESETS, SHOULDER_BUTTONS, STANDARD_AXIS_MAP, STANDARD_GAMEPAD_BUTTONS, STICK_BUTTONS, SUPPORTED_EXTENSIONS, SYSTEMS, SYSTEM_BUTTONS, type SaveSlot, type SaveSlotModalProps, type ShaderPresetId, ShaderSelector, ShortcutsReference, type ShowToastOptions, type SpeedMultiplier, type StandardAxis, type SystemConfig, TRIGGER_BUTTONS, type Toast, ToastContainer, type ToastType, type UseGamepadOptions, type UseGamepadReturn, type UseNostalgistReturn, type UseToastReturn, buildRetroArchConfig, clearAllControls, consoleHasButton, detectControllerBrand, detectSystem, formatGamepadButton, formatKeyCode, gamepadToRetroArchConfig, getAchievementBadgeUrl, getConsoleButtons, getConsoleCapabilities, getConsoleKeyboardDefaults, getCore, getDBSystemNames, getFullGamepadMapping, getFullKeyboardMapping, getSupportedExtensions, getSystem, getSystemByDbName, getSystemByKey, getSystemFromExtension, getSystemsList, getUserAvatarUrl, isSystemSupported, keyboardToRetroArchConfig, loadAllGamepadMappings, loadGamepadMapping, loadKeyboardMapping, normalizeSystemKey, saveGamepadMapping, saveKeyboardMapping, systemsMatch, useGameRecording, useGamepad, useNostalgist, useToast };
+/**
+ * Get a ROM blob from the browser cache
+ */
+declare function getCachedRom(romId: string): Promise<Blob | null>;
+declare function fetchAndCacheRom(romId: string, url: string): Promise<Blob>;
+
+export { ALL_BUTTONS, AchievementPopup, BUTTON_GROUPS, BUTTON_LABELS, type ButtonId, CONSOLE_CAPABILITIES, CONSOLE_KEYBOARD_OVERRIDES, type Cheat, type CheatModalProps, type ConsoleCapabilities, type ControlConfig, type ControlMapperProps, type ControlMapping, type ControllerBrand, DEFAULT_CONTROLS, DEFAULT_GAMEPAD, DEFAULT_KEYBOARD, DPAD_BUTTONS, type EmulatorStatus, FACE_BUTTONS, GamePlayer, type GamePlayerProps, type GamepadInfo, type GamepadMapping, type KeyboardMapping, PERFORMANCE_TIER_1_SYSTEMS, PERFORMANCE_TIER_2_SYSTEMS, type PlayerControlsProps, type PlayerIndex, type RAAchievement, type RACredentials, type RAGame, type RAGameExtended, type RAHardcodeRestrictions, RASidebar, type RAUser, RA_MEDIA_BASE, type RetroAchievementsConfig, SHADER_PRESETS, SHOULDER_BUTTONS, STANDARD_AXIS_MAP, STANDARD_GAMEPAD_BUTTONS, STICK_BUTTONS, SUPPORTED_EXTENSIONS, SYSTEMS, SYSTEM_BUTTONS, type SaveSlot, type SaveSlotModalProps, type ShaderPresetId, ShaderSelector, ShortcutsReference, type ShowToastOptions, type SpeedMultiplier, type StandardAxis, type SystemConfig, TRIGGER_BUTTONS, type Toast, ToastContainer, type ToastType, type UseGamepadOptions, type UseGamepadReturn, type UseNostalgistReturn, type UseToastReturn, buildRetroArchConfig, clearAllControls, consoleHasButton, detectControllerBrand, detectSystem, fetchAndCacheRom, formatGamepadButton, formatKeyCode, gamepadToRetroArchConfig, getAchievementBadgeUrl, getCachedRom, getConsoleButtons, getConsoleCapabilities, getConsoleKeyboardDefaults, getCore, getDBSystemNames, getFullGamepadMapping, getFullKeyboardMapping, getSupportedExtensions, getSystem, getSystemByDbName, getSystemByKey, getSystemFromExtension, getSystemsList, getUserAvatarUrl, isSystemSupported, keyboardToRetroArchConfig, loadAllGamepadMappings, loadGamepadMapping, loadKeyboardMapping, normalizeSystemKey, saveGamepadMapping, saveKeyboardMapping, systemsMatch, useGameRecording, useGamepad, useNostalgist, useToast };

package/dist/index.d.ts

@@ -266,6 +266,7 @@ interface UseNostalgistOptions {
     initialVolume?: number;
     romFileName?: string;
     shader?: string;
+    romId?: string;
 }
 interface UseNostalgistReturn {
     status: EmulatorStatus;
@@ -306,7 +307,7 @@ interface UseNostalgistReturn {
     getNostalgistInstance: () => Nostalgist | null;
     isPerformanceMode: boolean;
 }
-declare const useNostalgist: ({ system, romUrl, core, biosUrl, initialState, getCanvasElement, keyboardControls, gamepadBindings, retroAchievements, onReady, onError, initialVolume, romFileName, shader, }: UseNostalgistOptions) => UseNostalgistReturn;
+declare const useNostalgist: ({ system, romUrl, core, biosUrl, initialState, getCanvasElement, keyboardControls, gamepadBindings, retroAchievements, onReady, onError, initialVolume, romFileName, shader, romId, }: UseNostalgistOptions) => UseNostalgistReturn;
 
 /**
  * Available CRT Shader Presets
@@ -855,4 +856,10 @@ interface UseGameRecordingReturn {
  */
 declare function useGameRecording({ getCanvasElement, }: UseGameRecordingProps): UseGameRecordingReturn;
 
-export { ALL_BUTTONS, AchievementPopup, BUTTON_GROUPS, BUTTON_LABELS, type ButtonId, CONSOLE_CAPABILITIES, CONSOLE_KEYBOARD_OVERRIDES, type Cheat, type CheatModalProps, type ConsoleCapabilities, type ControlConfig, type ControlMapperProps, type ControlMapping, type ControllerBrand, DEFAULT_CONTROLS, DEFAULT_GAMEPAD, DEFAULT_KEYBOARD, DPAD_BUTTONS, type EmulatorStatus, FACE_BUTTONS, GamePlayer, type GamePlayerProps, type GamepadInfo, type GamepadMapping, type KeyboardMapping, PERFORMANCE_TIER_1_SYSTEMS, PERFORMANCE_TIER_2_SYSTEMS, type PlayerControlsProps, type PlayerIndex, type RAAchievement, type RACredentials, type RAGame, type RAGameExtended, type RAHardcodeRestrictions, RASidebar, type RAUser, RA_MEDIA_BASE, type RetroAchievementsConfig, SHADER_PRESETS, SHOULDER_BUTTONS, STANDARD_AXIS_MAP, STANDARD_GAMEPAD_BUTTONS, STICK_BUTTONS, SUPPORTED_EXTENSIONS, SYSTEMS, SYSTEM_BUTTONS, type SaveSlot, type SaveSlotModalProps, type ShaderPresetId, ShaderSelector, ShortcutsReference, type ShowToastOptions, type SpeedMultiplier, type StandardAxis, type SystemConfig, TRIGGER_BUTTONS, type Toast, ToastContainer, type ToastType, type UseGamepadOptions, type UseGamepadReturn, type UseNostalgistReturn, type UseToastReturn, buildRetroArchConfig, clearAllControls, consoleHasButton, detectControllerBrand, detectSystem, formatGamepadButton, formatKeyCode, gamepadToRetroArchConfig, getAchievementBadgeUrl, getConsoleButtons, getConsoleCapabilities, getConsoleKeyboardDefaults, getCore, getDBSystemNames, getFullGamepadMapping, getFullKeyboardMapping, getSupportedExtensions, getSystem, getSystemByDbName, getSystemByKey, getSystemFromExtension, getSystemsList, getUserAvatarUrl, isSystemSupported, keyboardToRetroArchConfig, loadAllGamepadMappings, loadGamepadMapping, loadKeyboardMapping, normalizeSystemKey, saveGamepadMapping, saveKeyboardMapping, systemsMatch, useGameRecording, useGamepad, useNostalgist, useToast };
+/**
+ * Get a ROM blob from the browser cache
+ */
+declare function getCachedRom(romId: string): Promise<Blob | null>;
+declare function fetchAndCacheRom(romId: string, url: string): Promise<Blob>;
+
+export { ALL_BUTTONS, AchievementPopup, BUTTON_GROUPS, BUTTON_LABELS, type ButtonId, CONSOLE_CAPABILITIES, CONSOLE_KEYBOARD_OVERRIDES, type Cheat, type CheatModalProps, type ConsoleCapabilities, type ControlConfig, type ControlMapperProps, type ControlMapping, type ControllerBrand, DEFAULT_CONTROLS, DEFAULT_GAMEPAD, DEFAULT_KEYBOARD, DPAD_BUTTONS, type EmulatorStatus, FACE_BUTTONS, GamePlayer, type GamePlayerProps, type GamepadInfo, type GamepadMapping, type KeyboardMapping, PERFORMANCE_TIER_1_SYSTEMS, PERFORMANCE_TIER_2_SYSTEMS, type PlayerControlsProps, type PlayerIndex, type RAAchievement, type RACredentials, type RAGame, type RAGameExtended, type RAHardcodeRestrictions, RASidebar, type RAUser, RA_MEDIA_BASE, type RetroAchievementsConfig, SHADER_PRESETS, SHOULDER_BUTTONS, STANDARD_AXIS_MAP, STANDARD_GAMEPAD_BUTTONS, STICK_BUTTONS, SUPPORTED_EXTENSIONS, SYSTEMS, SYSTEM_BUTTONS, type SaveSlot, type SaveSlotModalProps, type ShaderPresetId, ShaderSelector, ShortcutsReference, type ShowToastOptions, type SpeedMultiplier, type StandardAxis, type SystemConfig, TRIGGER_BUTTONS, type Toast, ToastContainer, type ToastType, type UseGamepadOptions, type UseGamepadReturn, type UseNostalgistReturn, type UseToastReturn, buildRetroArchConfig, clearAllControls, consoleHasButton, detectControllerBrand, detectSystem, fetchAndCacheRom, formatGamepadButton, formatKeyCode, gamepadToRetroArchConfig, getAchievementBadgeUrl, getCachedRom, getConsoleButtons, getConsoleCapabilities, getConsoleKeyboardDefaults, getCore, getDBSystemNames, getFullGamepadMapping, getFullKeyboardMapping, getSupportedExtensions, getSystem, getSystemByDbName, getSystemByKey, getSystemFromExtension, getSystemsList, getUserAvatarUrl, isSystemSupported, keyboardToRetroArchConfig, loadAllGamepadMappings, loadGamepadMapping, loadKeyboardMapping, normalizeSystemKey, saveGamepadMapping, saveKeyboardMapping, systemsMatch, useGameRecording, useGamepad, useNostalgist, useToast };

package/dist/index.js

@@ -5646,10 +5646,59 @@ function getCore2(system) {
   return getCore(system);
 }
 
+// src/lib/rom-cache.ts
+var CACHE_NAME = "koin-rom-cache-v1";
+async function getCachedRom(romId) {
+  if (typeof caches === "undefined") return null;
+  try {
+    const cache = await caches.open(CACHE_NAME);
+    const response = await cache.match(romId);
+    if (response) {
+      console.log(`[Cache] Hit for ROM ${romId}`);
+      return await response.blob();
+    }
+  } catch (e) {
+    console.warn("[Cache] Read failed:", e);
+  }
+  return null;
+}
+var pendingFetches = /* @__PURE__ */ new Map();
+async function fetchAndCacheRom(romId, url) {
+  if (pendingFetches.has(romId)) {
+    console.log(`[Cache] Joining in-flight fetch for ${romId}`);
+    return pendingFetches.get(romId);
+  }
+  const fetchPromise = (async () => {
+    try {
+      const cached = await getCachedRom(romId);
+      if (cached) return cached;
+      console.log(`[Cache] Fetching ROM ${romId}...`);
+      const response = await fetch(url);
+      if (!response.ok) throw new Error(`Failed to fetch ROM: ${response.statusText}`);
+      const blob = await response.blob();
+      if (typeof caches !== "undefined") {
+        try {
+          const cache = await caches.open(CACHE_NAME);
+          await cache.put(romId, new Response(blob));
+          console.log(`[Cache] Cached ROM ${romId}`);
+        } catch (e) {
+          console.warn("[Cache] Write failed:", e);
+        }
+      }
+      return blob;
+    } finally {
+      pendingFetches.delete(romId);
+    }
+  })();
+  pendingFetches.set(romId, fetchPromise);
+  return fetchPromise;
+}
+
 // src/hooks/emulator/useEmulatorCore.ts
 function useEmulatorCore({
   system,
   romUrl,
+  romId,
   core: coreOverride,
   biosUrl,
   initialState,
@@ -5731,7 +5780,25 @@ function useEmulatorCore({
       setError(null);
       const core = coreOverride || getCore2(system);
       let romOption = romUrl;
-      if (romFileName) {
+      if (romId) {
+        try {
+          let blob = await getCachedRom(romId);
+          if (!blob) {
+            console.log(`[Nostalgist] Fetching and caching ROM ${romId}`);
+            blob = await fetchAndCacheRom(romId, romUrl);
+          } else {
+            console.log(`[Nostalgist] Loaded ROM ${romId} from cache`);
+          }
+          if (blob) {
+            romOption = {
+              fileName: romFileName || "rom.bin",
+              fileContent: blob
+            };
+          }
+        } catch (err) {
+          console.error("[Nostalgist] Cache/Fetch error, falling back to direct URL:", err);
+        }
+      } else if (romFileName) {
         romOption = { fileName: romFileName, fileContent: romUrl };
       }
       const inputConfig = buildRetroArchConfig({
@@ -6398,7 +6465,8 @@ var useNostalgist = ({
   onError,
   initialVolume = 100,
   romFileName,
-  shader
+  shader,
+  romId
 }) => {
   const isHeavySystem = React5.useMemo(() => {
     return PERFORMANCE_TIER_2_SYSTEMS.has(system.toUpperCase());
@@ -6426,6 +6494,7 @@ var useNostalgist = ({
   } = useEmulatorCore({
     system,
     romUrl,
+    romId,
     core,
     biosUrl,
     initialState,
@@ -6619,6 +6688,7 @@ function useControls(system, onNotify) {
 function useGameSession(props) {
   const {
     romUrl,
+    romId,
     romFileName,
     system,
     core,
@@ -6667,6 +6737,7 @@ function useGameSession(props) {
   const nostalgist = useNostalgist({
     system,
     romUrl,
+    romId,
     romFileName,
     core,
     biosUrl,
@@ -8163,10 +8234,12 @@ exports.clearAllControls = clearAllControls;
 exports.consoleHasButton = consoleHasButton;
 exports.detectControllerBrand = detectControllerBrand;
 exports.detectSystem = detectSystem;
+exports.fetchAndCacheRom = fetchAndCacheRom;
 exports.formatGamepadButton = formatGamepadButton;
 exports.formatKeyCode = formatKeyCode;
 exports.gamepadToRetroArchConfig = gamepadToRetroArchConfig;
 exports.getAchievementBadgeUrl = getAchievementBadgeUrl;
+exports.getCachedRom = getCachedRom;
 exports.getConsoleButtons = getConsoleButtons;
 exports.getConsoleCapabilities = getConsoleCapabilities;
 exports.getConsoleKeyboardDefaults = getConsoleKeyboardDefaults;