react-native-bspatch 1.0.0

package/android/src/main/java/vn/reactnativebspatch/BsPatchModule.kt

@@ -0,0 +1,139 @@
+package vn.reactnativebspatch
+
+import android.os.Handler
+import android.os.Looper
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReactMethod
+import com.facebook.react.bridge.Callback
+import com.facebook.react.bridge.Promise
+import java.io.File
+import java.io.FileInputStream
+import java.io.FileOutputStream
+import java.io.BufferedInputStream
+import java.io.BufferedOutputStream
+import java.util.zip.ZipInputStream
+import java.util.zip.GZIPInputStream
+
+
+class BsPatchModule(private val reactContext: ReactApplicationContext) : NativeBsPatchSpec(reactContext) {
+
+    companion object {
+        const val NAME = "BsPatch"
+
+        init {
+            System.loadLibrary("bspatch")
+        }
+    }
+
+    override fun getName(): String {
+        return NAME
+    }
+
+    private external fun nativeApplyPatch(oldPath: String, newPath: String, patchPath: String): Boolean
+
+    override fun applyPatch(oldPath: String, newPath: String, patchPath: String, promise: com.facebook.react.bridge.Promise) {
+        Thread {
+            try {
+                val result = nativeApplyPatch(oldPath, newPath, patchPath)
+                promise.resolve(result)
+            } catch (e: Exception) {
+                promise.reject("ERR_BSPATCH", e.message, e)
+            }
+        }.start()
+    }
+
+    override fun unzip(source: String, targetDir: String, promise: Promise) {
+        Thread {
+            try {
+                val sourceFile = File(source)
+                val destDir = File(targetDir)
+                if (!destDir.exists()) destDir.mkdirs()
+
+                ZipInputStream(BufferedInputStream(FileInputStream(sourceFile))).use { zis ->
+                    var entry = zis.nextEntry
+                    while (entry != null) {
+                        val file = File(destDir, entry.name)
+                        if (entry.isDirectory) {
+                            file.mkdirs()
+                        } else {
+                            file.parentFile?.mkdirs()
+                            BufferedOutputStream(FileOutputStream(file)).use { bos ->
+                                zis.copyTo(bos)
+                            }
+                        }
+                        zis.closeEntry()
+                        entry = zis.nextEntry
+                    }
+                }
+                promise.resolve(true)
+            } catch (e: Exception) {
+                promise.reject("ERR_UNZIP", e.message, e)
+            }
+        }.start()
+    }
+
+    /**
+     * Extracts the JS bundle from APK assets using Android AssetManager.
+     * Guarantees byte-exact copy — RNFS.copyFileAssets can produce different
+     * bytes in certain APK configurations.
+     */
+    override fun extractBundleFromAssets(assetName: String, destPath: String, promise: Promise) {
+        Thread {
+            try {
+                val assetManager = reactContext.assets
+                assetManager.open(assetName).use { input ->
+                    val destFile = File(destPath)
+                    destFile.parentFile?.mkdirs()
+                    BufferedOutputStream(FileOutputStream(destFile)).use { output ->
+                        input.copyTo(output, bufferSize = 8192)
+                    }
+                }
+                promise.resolve(true)
+            } catch (e: Exception) {
+                promise.reject("ERR_EXTRACT_ASSET", e.message, e)
+            }
+        }.start()
+    }
+
+    override fun markAsHealthy() {
+        OtaBundleResolver.markAsHealthy(reactContext)
+    }
+
+    override fun reloadBundle() {
+        val activity = reactContext.currentActivity
+        if (activity != null) {
+            Handler(Looper.getMainLooper()).post {
+                val intent = activity.packageManager.getLaunchIntentForPackage(activity.packageName)
+                if (intent != null) {
+                    intent.addFlags(android.content.Intent.FLAG_ACTIVITY_NEW_TASK or android.content.Intent.FLAG_ACTIVITY_CLEAR_TASK or android.content.Intent.FLAG_ACTIVITY_CLEAR_TOP)
+                    activity.startActivity(intent)
+                    Runtime.getRuntime().exit(0)
+                }
+            }
+        }
+    }
+
+    override fun logNative(message: String?) {
+        android.util.Log.d("JS-OTA", message ?: "")
+    }
+
+    override fun decompressGzip(sourcePath: String, destPath: String, promise: Promise) {
+        Thread {
+            try {
+                val source = File(sourcePath)
+                val dest = File(destPath)
+                dest.parentFile?.mkdirs()
+
+                GZIPInputStream(BufferedInputStream(FileInputStream(source))).use { gis ->
+                    BufferedOutputStream(FileOutputStream(dest)).use { bos ->
+                        gis.copyTo(bos)
+                    }
+                }
+                promise.resolve(true)
+            } catch (e: Exception) {
+                promise.reject("ERR_GZIP_DECOMPRESS", e.message, e)
+            }
+        }.start()
+    }
+
+}

package/android/src/main/java/vn/reactnativebspatch/BsPatchPackage.kt

@@ -0,0 +1,16 @@
+package vn.reactnativebspatch
+
+import com.facebook.react.ReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.uimanager.ViewManager
+
+class BsPatchPackage : ReactPackage {
+    override fun createNativeModules(reactContext: ReactApplicationContext): List<NativeModule> {
+        return listOf<NativeModule>(BsPatchModule(reactContext) as NativeModule)
+    }
+
+    override fun createViewManagers(reactContext: ReactApplicationContext): List<ViewManager<*, *>> {
+        return emptyList()
+    }
+}

package/android/src/main/java/vn/reactnativebspatch/OtaBundleResolver.kt

@@ -0,0 +1,227 @@
+package vn.reactnativebspatch
+
+import android.content.Context
+import android.util.Log
+import org.json.JSONArray
+import org.json.JSONObject
+import java.io.File
+
+/**
+ * OtaBundleResolver — encapsulates OTA bundle path resolution with
+ * crash detection and automatic rollback.
+ *
+ * IMPORTANT: This runs BEFORE any JS code. If the OTA bundle is corrupted,
+ * Hermes crashes before React Native boots. This native resolver handles
+ * crash detection so the app can recover without JS ever running.
+ *
+ * Lifecycle:
+ *   1. Read metadata.json
+ *   2. If lastLaunchSuccessful == false → rollback to previous version
+ *   3. Mark current launch as pending (lastLaunchSuccessful = false)
+ *   4. Return the bundle path (or null for APK default)
+ *   5. JS calls markAsHealthy() → sets lastLaunchSuccessful = true
+ *   6. If crash before markAsHealthy → next boot sees false → rollback
+ *
+ * Usage in MainApplication.kt:
+ * ```
+ * jsBundleFilePath = OtaBundleResolver.resolve(applicationContext)
+ * ```
+ */
+object OtaBundleResolver {
+
+    private const val TAG = "OtaBundleResolver"
+    private const val OTA_DIR_NAME = "ota"
+    private const val METADATA_FILE = "metadata.json"
+    private const val DEFAULT_BASE_VERSION = 1
+    private const val MAX_ROLLBACK = 3
+
+    /**
+     * Resolves the JS bundle path from OTA metadata.
+     * Handles crash detection and rollback entirely on the native side.
+     *
+     * @param context Android Application context
+     * @param baseVersion The OTA version baked into the APK (default: 1)
+     * @return Absolute path to the OTA bundle, or null to use the APK default.
+     */
+    @JvmStatic
+    fun resolve(context: Context, baseVersion: Int = DEFAULT_BASE_VERSION): String? {
+        return try {
+            val otaDir = File(context.filesDir, OTA_DIR_NAME)
+            val metadataFile = File(otaDir, METADATA_FILE)
+
+            if (!metadataFile.exists()) {
+                Log.d(TAG, "No OTA metadata → APK bundle")
+                return null
+            }
+
+            var metadata = JSONObject(metadataFile.readText())
+            val currentVersion = metadata.optInt("currentVersion", baseVersion)
+            val lastLaunchOk = metadata.optBoolean("lastLaunchSuccessful", true)
+            val rollbackCount = metadata.optInt("rollbackCount", 0)
+
+            // ── Step 1: Crash detection & rollback ──────────────────────────
+            if (!lastLaunchOk && currentVersion > baseVersion) {
+                Log.w(TAG, "Previous launch failed! Rolling back from V$currentVersion...")
+                metadata = performRollback(metadata, baseVersion, rollbackCount, otaDir)
+                writeMetadata(metadataFile, metadata)
+
+                val newVersion = metadata.optInt("currentVersion", baseVersion)
+                if (newVersion <= baseVersion) {
+                    Log.i(TAG, "Rolled back to factory APK bundle")
+                    return null
+                }
+
+                // Check if the rollback target bundle exists
+                val rollbackVDir = File(otaDir, "v${newVersion}")
+                val rollbackBundle = File(rollbackVDir, "index.android.bundle")
+                if (!rollbackBundle.exists()) {
+                    Log.w(TAG, "Rollback target index.android.bundle missing in V$newVersion → factory")
+                    resetToFactory(metadataFile, baseVersion)
+                    return null
+                }
+
+                // Mark this rollback attempt as pending
+                metadata.put("lastLaunchSuccessful", false)
+                writeMetadata(metadataFile, metadata)
+
+                Log.i(TAG, "Trying rollback bundle: ${rollbackBundle.absolutePath}")
+                return rollbackBundle.absolutePath
+            }
+
+            // ── Step 2: Normal boot — no OTA bundle needed ──────────────────
+            if (currentVersion <= baseVersion) {
+                Log.d(TAG, "OTA v$currentVersion ≤ base v$baseVersion → APK bundle")
+                return null
+            }
+
+            // ── Step 3: OTA bundle — mark as pending verification ───────────
+            val vDir = File(otaDir, "v${currentVersion}")
+            val bundleFile = File(vDir, "index.android.bundle")
+            if (!bundleFile.exists()) {
+                Log.w(TAG, "index.android.bundle missing in V$currentVersion → APK bundle")
+                resetToFactory(metadataFile, baseVersion)
+                return null
+            }
+
+            // Mark launch as pending — if Hermes crashes loading this bundle,
+            // the next boot will see false and trigger rollback
+            metadata.put("lastLaunchSuccessful", false)
+            writeMetadata(metadataFile, metadata)
+
+            Log.i(TAG, "Loading OTA bundle: ${bundleFile.absolutePath}")
+            bundleFile.absolutePath
+        } catch (e: Exception) {
+            Log.e(TAG, "Error resolving OTA bundle: ${e.message}")
+            null
+        }
+    }
+
+    /**
+     * Performs rollback by popping from previousVersions.
+     * If maxRollback reached, resets to factory.
+     */
+    private fun performRollback(
+        metadata: JSONObject,
+        baseVersion: Int,
+        currentRollbackCount: Int,
+        otaDir: File
+    ): JSONObject {
+        val newCount = currentRollbackCount + 1
+
+        // Max rollback reached → factory reset
+        if (newCount >= MAX_ROLLBACK) {
+            Log.w(TAG, "Max rollback ($MAX_ROLLBACK) reached → factory reset")
+            return JSONObject().apply {
+                put("currentVersion", baseVersion)
+                put("previousVersions", JSONArray())
+                put("rollbackCount", 0)
+                put("lastLaunchSuccessful", true)
+            }
+        }
+
+        val prevVersions = metadata.optJSONArray("previousVersions") ?: JSONArray()
+
+        if (prevVersions.length() == 0) {
+            Log.w(TAG, "No previous versions to rollback to → factory reset")
+            return JSONObject().apply {
+                put("currentVersion", baseVersion)
+                put("previousVersions", JSONArray())
+                put("rollbackCount", newCount)
+                put("lastLaunchSuccessful", true)
+            }
+        }
+
+        // Pop the first previous version
+        val rollbackTo = prevVersions.optInt(0, baseVersion)
+        val remaining = JSONArray()
+        for (i in 1 until prevVersions.length()) {
+            remaining.put(prevVersions.optInt(i))
+        }
+
+        Log.i(TAG, "Rolling back: V${metadata.optInt("currentVersion")} → V$rollbackTo (attempt $newCount)")
+
+        // Check if this rollback target bundle exists
+        val vDir = File(otaDir, "v${rollbackTo}")
+        val targetBundle = File(vDir, "index.android.bundle")
+        if (!targetBundle.exists() && rollbackTo > baseVersion) {
+            Log.w(TAG, "index.android.bundle not found in V$rollbackTo, trying deeper rollback...")
+            val intermediate = JSONObject().apply {
+                put("currentVersion", rollbackTo)
+                put("previousVersions", remaining)
+                put("rollbackCount", newCount)
+                put("lastLaunchSuccessful", false)
+            }
+            return performRollback(intermediate, baseVersion, newCount, otaDir)
+        }
+
+        return JSONObject().apply {
+            put("currentVersion", rollbackTo)
+            put("previousVersions", remaining)
+            put("rollbackCount", newCount)
+            put("lastLaunchSuccessful", true) // Will be set to false again in resolve()
+        }
+    }
+
+    /**
+     * Resets metadata to factory defaults.
+     */
+    private fun resetToFactory(metadataFile: File, baseVersion: Int) {
+        val factory = JSONObject().apply {
+            put("currentVersion", baseVersion)
+            put("previousVersions", JSONArray())
+            put("rollbackCount", 0)
+            put("lastLaunchSuccessful", true)
+        }
+        writeMetadata(metadataFile, factory)
+    }
+
+    @JvmStatic
+    fun markAsHealthy(context: Context) {
+        try {
+            val otaDir = File(context.filesDir, OTA_DIR_NAME)
+            val metadataFile = File(otaDir, METADATA_FILE)
+            if (!metadataFile.exists()) return
+
+            val metadata = JSONObject(metadataFile.readText())
+            metadata.put("lastLaunchSuccessful", true)
+            metadata.put("rollbackCount", 0)
+
+            writeMetadata(metadataFile, metadata)
+            Log.i(TAG, "App marked as healthy")
+        } catch (e: Exception) {
+            Log.e(TAG, "Failed to mark as healthy: ${e.message}")
+        }
+    }
+
+    /**
+     * Writes metadata JSON to disk.
+     */
+    private fun writeMetadata(file: File, metadata: JSONObject) {
+        try {
+            file.parentFile?.mkdirs()
+            file.writeText(metadata.toString(2))
+        } catch (e: Exception) {
+            Log.e(TAG, "Failed to write metadata: ${e.message}")
+        }
+    }
+}

package/cpp/CMakeLists.txt

@@ -0,0 +1,43 @@
+cmake_minimum_required(VERSION 3.18.1)
+
+project("bspatch")
+
+# Define bzip2 sources explicitly to avoid including executables
+set(BZIP2_SOURCES
+    "bzip2/blocksort.c"
+    "bzip2/huffman.c"
+    "bzip2/crctable.c"
+    "bzip2/randtable.c"
+    "bzip2/compress.c"
+    "bzip2/decompress.c"
+    "bzip2/bzlib.c"
+)
+
+# React Native includes
+set(REACT_NATIVE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/../../../../node_modules/react-native)
+
+# Add our custom library
+add_library(
+        bspatch
+        SHARED
+
+        bspatch_jni.cpp
+        bsdiff/bspatch_wrapper.c
+        bsdiff/bspatch.c
+        ${BZIP2_SOURCES}
+)
+
+# Include directories
+target_include_directories(bspatch PRIVATE bzip2 bsdiff)
+
+# Link against Android standard libraries
+target_link_libraries(
+        bspatch
+        log
+)
+
+# Set 16KB (2^14) page alignment for Android compatibility
+# Required for arm64-v8a and x86_64 architectures
+if(ANDROID)
+    target_link_options(bspatch PRIVATE "LINKER:-z,max-page-size=16384")
+endif()

package/cpp/bsdiff/bspatch.c

@@ -0,0 +1,194 @@
+/*-
+ * Copyright 2003-2005 Colin Percival
+ * Copyright 2012 Matthew Endsley
+ * All rights reserved
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted providing that the following conditions 
+ * are met:
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+ * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
+ * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+ * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+ * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
+ * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#include <limits.h>
+#include "bspatch.h"
+
+static int64_t offtin(uint8_t *buf)
+{
+	int64_t y;
+
+	y=buf[7]&0x7F;
+	y=y*256;y+=buf[6];
+	y=y*256;y+=buf[5];
+	y=y*256;y+=buf[4];
+	y=y*256;y+=buf[3];
+	y=y*256;y+=buf[2];
+	y=y*256;y+=buf[1];
+	y=y*256;y+=buf[0];
+
+	if(buf[7]&0x80) y=-y;
+
+	return y;
+}
+
+int bspatch(const uint8_t* old, int64_t oldsize, uint8_t* new, int64_t newsize, struct bspatch_stream* stream)
+{
+	uint8_t buf[8];
+	int64_t oldpos,newpos;
+	int64_t ctrl[3];
+	int64_t i;
+
+	oldpos=0;newpos=0;
+	while(newpos<newsize) {
+		/* Read control data */
+		for(i=0;i<=2;i++) {
+			if (stream->read(stream, buf, 8))
+				return -1;
+			ctrl[i]=offtin(buf);
+		};
+
+		/* Sanity-check */
+		if (ctrl[0]<0 || ctrl[0]>INT_MAX ||
+			ctrl[1]<0 || ctrl[1]>INT_MAX ||
+			newpos+ctrl[0]>newsize)
+			return -1;
+
+		/* Read diff string */
+		if (stream->read(stream, new + newpos, ctrl[0]))
+			return -1;
+
+		/* Add old data to diff string */
+		for(i=0;i<ctrl[0];i++)
+			if((oldpos+i>=0) && (oldpos+i<oldsize))
+				new[newpos+i]+=old[oldpos+i];
+
+		/* Adjust pointers */
+		newpos+=ctrl[0];
+		oldpos+=ctrl[0];
+
+		/* Sanity-check */
+		if(newpos+ctrl[1]>newsize)
+			return -1;
+
+		/* Read extra string */
+		if (stream->read(stream, new + newpos, ctrl[1]))
+			return -1;
+
+		/* Adjust pointers */
+		newpos+=ctrl[1];
+		oldpos+=ctrl[2];
+	};
+
+	return 0;
+}
+
+#if defined(BSPATCH_EXECUTABLE)
+
+#include <bzlib.h>
+#include <stdlib.h>
+#include <stdint.h>
+#include <stdio.h>
+#include <string.h>
+#include <err.h>
+#include <sys/types.h>
+#include <sys/stat.h>
+#include <unistd.h>
+#include <fcntl.h>
+
+static int bz2_read(const struct bspatch_stream* stream, void* buffer, int length)
+{
+	int n;
+	int bz2err;
+	BZFILE* bz2;
+
+	bz2 = (BZFILE*)stream->opaque;
+	n = BZ2_bzRead(&bz2err, bz2, buffer, length);
+	if (n != length)
+		return -1;
+
+	return 0;
+}
+
+int main(int argc,char * argv[])
+{
+	FILE * f;
+	int fd;
+	int bz2err;
+	uint8_t header[24];
+	uint8_t *old, *new;
+	int64_t oldsize, newsize;
+	BZFILE* bz2;
+	struct bspatch_stream stream;
+	struct stat sb;
+
+	if(argc!=4) errx(1,"usage: %s oldfile newfile patchfile\n",argv[0]);
+
+	/* Open patch file */
+	if ((f = fopen(argv[3], "r")) == NULL)
+		err(1, "fopen(%s)", argv[3]);
+
+	/* Read header */
+	if (fread(header, 1, 24, f) != 24) {
+		if (feof(f))
+			errx(1, "Corrupt patch\n");
+		err(1, "fread(%s)", argv[3]);
+	}
+
+	/* Check for appropriate magic */
+	if (memcmp(header, "ENDSLEY/BSDIFF43", 16) != 0)
+		errx(1, "Corrupt patch\n");
+
+	/* Read lengths from header */
+	newsize=offtin(header+16);
+	if(newsize<0)
+		errx(1,"Corrupt patch\n");
+
+	/* Close patch file and re-open it via libbzip2 at the right places */
+	if(((fd=open(argv[1],O_RDONLY,0))<0) ||
+		((oldsize=lseek(fd,0,SEEK_END))==-1) ||
+		((old=malloc(oldsize+1))==NULL) ||
+		(lseek(fd,0,SEEK_SET)!=0) ||
+		(read(fd,old,oldsize)!=oldsize) ||
+		(fstat(fd, &sb)) ||
+		(close(fd)==-1)) err(1,"%s",argv[1]);
+	if((new=malloc(newsize+1))==NULL) err(1,NULL);
+
+	if (NULL == (bz2 = BZ2_bzReadOpen(&bz2err, f, 0, 0, NULL, 0)))
+		errx(1, "BZ2_bzReadOpen, bz2err=%d", bz2err);
+
+	stream.read = bz2_read;
+	stream.opaque = bz2;
+	if (bspatch(old, oldsize, new, newsize, &stream))
+		errx(1, "bspatch");
+
+	/* Clean up the bzip2 reads */
+	BZ2_bzReadClose(&bz2err, bz2);
+	fclose(f);
+
+	/* Write the new file */
+	if(((fd=open(argv[2],O_CREAT|O_TRUNC|O_WRONLY,sb.st_mode))<0) ||
+		(write(fd,new,newsize)!=newsize) || (close(fd)==-1))
+		err(1,"%s",argv[2]);
+
+	free(new);
+	free(old);
+
+	return 0;
+}
+
+#endif

package/cpp/bsdiff/bspatch.h

@@ -0,0 +1,41 @@
+/*-
+ * Copyright 2003-2005 Colin Percival
+ * Copyright 2012 Matthew Endsley
+ * All rights reserved
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted providing that the following conditions 
+ * are met:
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+ * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
+ * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+ * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+ * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
+ * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef BSPATCH_H
+# define BSPATCH_H
+
+# include <stdint.h>
+
+struct bspatch_stream
+{
+	void* opaque;
+	int (*read)(const struct bspatch_stream* stream, void* buffer, int length);
+};
+
+int bspatch(const uint8_t* old, int64_t oldsize, uint8_t* new, int64_t newsize, struct bspatch_stream* stream);
+
+#endif