From 6f2916edd4f0c104fb24f98abe9867e481cf5502 Mon Sep 17 00:00:00 2001
From: Hassan Khan <h@twodoors.dev>
Date: Sat, 8 Jun 2024 14:37:14 +0100
Subject: [PATCH] feat: show actionable resolutions for native module
 initialization errors

Show a few common resolutions when the native module fails to initialize for any reason.

Partially resolves #16.
---
 src/index.ts | 39 ++++++++++++++++++++++++++++++++++++---
 1 file changed, 36 insertions(+), 3 deletions(-)

diff --git a/src/index.ts b/src/index.ts
index a448579..c412d28 100644
--- a/src/index.ts
+++ b/src/index.ts
@@ -13,6 +13,29 @@ declare global {
   var __PrismaProxy: PrismaProxy | undefined;
 }
 
+const errorResolutions = [
+  `1. Ensure @prisma/react-native is added to the plugins section in app.json`,
+
+  `2. Ensure at least one migration exists:
+
+    $ prisma migrate dev`,
+
+  `3. Try removing the node_modules/ folder and running the prebuild command:
+
+    $ rm -rf node_modules/
+    $ npx expo prebuild --clean
+`,
+  `4. If in a monorepo, ensure the application's package.json also has the required Prisma dependencies:
+
+    $ npm i @prisma/client@latest @prisma/react-native@latest react-native-quick-base64
+    $ yarn add @prisma/client@latest @prisma/react-native@latest react-native-quick-base64
+`,
+];
+
+const makeErrorMessage = (message: string) => {
+  return [message, errorResolutions.join('\n\n')].join('\n\n');
+};
+
 // @ts-expect-error
 const isTurboModuleEnabled = global.__turboModuleProxy != null;
 
@@ -21,13 +44,23 @@ const PrismaModule = isTurboModuleEnabled
   : NativeModules.Prisma;
 
 if (!PrismaModule) {
-  throw new Error('🟥 @prisma/react-native failed to initialize');
+  throw new Error(
+    makeErrorMessage('🟥 @prisma/react-native failed to initialize')
+  );
 }
 
-PrismaModule.install();
+try {
+  PrismaModule.install();
+} catch {
+  throw new Error(
+    makeErrorMessage(`🟥 @prisma/react-native failed to install`)
+  );
+}
 
 if (!global.__PrismaProxy) {
-  throw new Error('🟥 prisma/react-native C++ bindings failed to initialize');
+  throw new Error(
+    makeErrorMessage('🟥 prisma/react-native C++ bindings failed to initialize')
+  );
 }
 
 // Wrap the create function to stringify the env variables if necessary