/**
 * Copyright (c) Facebook, Inc. and its affiliates.
 *
 * <p>This source code is licensed under the MIT license found in the LICENSE file in the root
 * directory of this source tree.
 */
package com.facebook.react.bridge;

import android.content.Context;
import android.content.res.AssetManager;

/** An interface for classes that initialize JavaScript using {@link JSBundleLoader} */
public interface JSBundleLoaderDelegate {

  /**
   * Load a JS bundle from Android assets. See {@link JSBundleLoader#createAssetLoader(Context,
   * String, boolean)}
   *
   * @param assetManager
   * @param assetURL
   * @param loadSynchronously
   */
  void loadScriptFromAssets(AssetManager assetManager, String assetURL, boolean loadSynchronously);

  /**
   * Load a JS bundle from the filesystem. See {@link JSBundleLoader#createFileLoader(String)} and
   * {@link JSBundleLoader#createCachedBundleFromNetworkLoader(String, String)}
   *
   * @param fileName
   * @param sourceURL
   * @param loadSynchronously
   */
  void loadScriptFromFile(String fileName, String sourceURL, boolean loadSynchronously);

  /**
   * Load a delta bundle from Metro. See {@link JSBundleLoader#createDeltaFromNetworkLoader(String,
   * NativeDeltaClient)}
   *
   * @param sourceURL
   * @param deltaClient
   * @param loadSynchronously
   */
  void loadScriptFromDeltaBundle(
      String sourceURL, NativeDeltaClient deltaClient, boolean loadSynchronously);

  /**
   * This API is used in situations where the JS bundle is being executed not on the device, but on
   * a host machine. In that case, we must provide two source URLs for the JS bundle: One to be used
   * on the device, and one to be used on the remote debugging machine.
   *
   * @param deviceURL A source URL that is accessible from this device.
   * @param remoteURL A source URL that is accessible from the remote machine executing the JS.
   */
  void setSourceURLs(String deviceURL, String remoteURL);
}