cuoral-ionic 0.0.5 → 0.0.7

package/README.md

@@ -343,7 +343,19 @@ new Cuoral({
 
 ```typescript
 // Initialize Cuoral
-cuoral.initialize(): void
+cuoral.initialize(): Promise<void>
+
+// Track page/screen view (for intelligence)
+cuoral.trackPageView(screen: string, metadata?: any): void
+
+// Track error manually (for intelligence)
+cuoral.trackError(message: string, stackTrace?: string, metadata?: any): void
+
+// Start native screen recording programmatically
+cuoral.startRecording(): Promise<boolean>
+
+// Stop native screen recording programmatically
+cuoral.stopRecording(): Promise<{filePath?: string; duration?: number} | null>
 
 // Get widget URL for iframe embedding
 cuoral.getWidgetUrl(): string
@@ -357,10 +369,69 @@ cuoral.closeModal(): void
 // Check if modal is open
 cuoral.isModalOpen(): boolean
 
+// Clear and end current session (call before logout)
+cuoral.clearSession(): Promise<void>
+
 // Clean up resources
 cuoral.destroy(): void
 ```
 
+### Programmatic Screen Recording
+
+You can trigger native screen recording programmatically from your app code:
+
+```typescript
+async startUserRecording() {
+  const started = await this.cuoral.startRecording();
+  if (started) {
+    console.log('Recording started successfully');
+    this.isRecording = true;
+  } else {
+    console.error('Failed to start recording');
+  }
+}
+
+async stopUserRecording() {
+  const result = await this.cuoral.stopRecording();
+  if (result) {
+    console.log('Recording stopped', {
+      filePath: result.filePath,
+      duration: result.duration
+    });
+    this.isRecording = false;
+  } else {
+    console.error('Failed to stop recording');
+  }
+}
+```
+
+**Use Cases:**
+- Allow users to record their issue before contacting support
+- Implement custom recording UI in your app
+- Record specific user flows programmatically
+- Create bug reporting features with automatic recording
+
+**Note:** Recording still requires user permission on iOS (microphone access). The video file is automatically processed and available for playback in the support widget.
+
+### Manual Intelligence Tracking
+
+Track custom events beyond automatic tracking:
+
+```typescript
+// Track page/screen view
+this.cuoral.trackPageView('/checkout', {
+  cart_items: 3,
+  total_value: 99.99
+});
+
+// Track error manually
+this.cuoral.trackError(
+  'Payment failed',
+  error.stack,
+  { payment_method: 'credit_card', amount: 99.99 }
+);
+```
+
 ## What Gets Handled Automatically
 
 - ✅ Support ticket creation and management

package/android/build.gradle

@@ -55,6 +55,7 @@ dependencies {
     implementation fileTree(dir: 'libs', include: ['*.jar'])
     implementation project(':capacitor-android')
     implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
+    implementation 'com.squareup.okhttp3:okhttp:4.12.0'
     testImplementation "junit:junit:$junitVersion"
     androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
     androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"

package/android/src/main/java/com/cuoral/ionic/CuoralPlugin.java

@@ -32,10 +32,20 @@ import java.io.File;
 import java.io.IOException;
 import java.io.PrintWriter;
 import java.io.StringWriter;
+import java.nio.file.Files;
 
 import org.json.JSONObject;
 import org.json.JSONException;
 
+import okhttp3.Call;
+import okhttp3.Callback;
+import okhttp3.MediaType;
+import okhttp3.MultipartBody;
+import okhttp3.OkHttpClient;
+import okhttp3.Request;
+import okhttp3.RequestBody;
+import okhttp3.Response;
+
 @CapacitorPlugin(name = "CuoralPlugin", permissions = {
         @Permission(strings = { Manifest.permission.RECORD_AUDIO }, alias = "audio"),
         @Permission(strings = { Manifest.permission.WRITE_EXTERNAL_STORAGE }, alias = "storage")
@@ -364,6 +374,12 @@ public class CuoralPlugin extends Plugin {
             return;
         }
 
+        // Get upload options
+        boolean autoUpload = call.getBoolean("autoUpload", false);
+        String sessionId = call.getString("sessionId", "");
+        String publicKey = call.getString("publicKey", "");
+        String customerId = call.getString("customerId", "");
+
         try {
             mediaRecorder.stop();
             mediaRecorder.reset();
@@ -389,11 +405,42 @@ public class CuoralPlugin extends Plugin {
             isRecording = false;
             long duration = (System.currentTimeMillis() - recordingStartTime) / 1000;
 
-            JSObject ret = new JSObject();
-            ret.put("success", true);
-            ret.put("filePath", videoFilePath);
-            ret.put("duration", duration);
-            call.resolve(ret);
+            // If autoUpload is enabled, upload the video
+            if (autoUpload && !sessionId.isEmpty() && !publicKey.isEmpty()) {
+                final String filePath = videoFilePath;
+                final long finalDuration = duration;
+                
+                uploadRecording(filePath, sessionId, publicKey, customerId, (int) finalDuration, new UploadCallback() {
+                    @Override
+                    public void onSuccess() {
+                        JSObject ret = new JSObject();
+                        ret.put("success", true);
+                        ret.put("filePath", filePath);
+                        ret.put("duration", finalDuration);
+                        ret.put("uploaded", true);
+                        call.resolve(ret);
+                    }
+
+                    @Override
+                    public void onFailure(String error) {
+                        JSObject ret = new JSObject();
+                        ret.put("success", true);
+                        ret.put("filePath", filePath);
+                        ret.put("duration", finalDuration);
+                        ret.put("uploaded", false);
+                        ret.put("uploadError", error);
+                        call.resolve(ret);
+                    }
+                });
+            } else {
+                // No upload, just return file path
+                JSObject ret = new JSObject();
+                ret.put("success", true);
+                ret.put("filePath", videoFilePath);
+                ret.put("duration", duration);
+                ret.put("uploaded", false);
+                call.resolve(ret);
+            }
 
             // Notify listeners
             JSObject eventData = new JSObject();
@@ -545,4 +592,157 @@ public class CuoralPlugin extends Plugin {
         ret.put("error", message);
         return ret;
     }
+
+    // Upload callback interface
+    private interface UploadCallback {
+        void onSuccess();
+        void onFailure(String error);
+    }
+
+    /**
+     * Upload recording to Cuoral backend
+     */
+    private void uploadRecording(String filePath, String sessionId, String publicKey, 
+                                 String customerId, int duration, UploadCallback callback) {
+        File videoFile = new File(filePath);
+        if (!videoFile.exists()) {
+            callback.onFailure("File not found");
+            return;
+        }
+
+        // Step 1: Initiate recording to get record_id
+        initiateRecording(sessionId, customerId, publicKey, new InitiateCallback() {
+            @Override
+            public void onSuccess(String recordId) {
+                // Step 2: Upload video with the record_id
+                uploadVideo(videoFile, recordId, publicKey, customerId, duration, callback);
+            }
+
+            @Override
+            public void onFailure(String error) {
+                callback.onFailure("Failed to initiate recording: " + error);
+            }
+        });
+    }
+
+    private interface InitiateCallback {
+        void onSuccess(String recordId);
+        void onFailure(String error);
+    }
+
+    /**
+     * Step 1: Initiate recording session
+     */
+    private void initiateRecording(String sessionId, String customerId, String publicKey, 
+                                   InitiateCallback callback) {
+        OkHttpClient client = new OkHttpClient();
+
+        try {
+            JSONObject json = new JSONObject();
+            json.put("session_id", sessionId);
+            json.put("customer_id", customerId);
+
+            RequestBody body = RequestBody.create(
+                json.toString(),
+                MediaType.parse("application/json")
+            );
+
+            Request request = new Request.Builder()
+                .url("https://api.cuoral.com/customer-intelligence/initiate/record")
+                .post(body)
+                .addHeader("Content-Type", "application/json")
+                .addHeader("Accept", "*/*")
+                .addHeader("x-org-id", publicKey)
+                .build();
+
+            client.newCall(request).enqueue(new Callback() {
+                @Override
+                public void onFailure(Call call, IOException e) {
+                    callback.onFailure(e.getMessage());
+                }
+
+                @Override
+                public void onResponse(Call call, Response response) throws IOException {
+                    if (!response.isSuccessful()) {
+                        callback.onFailure("Failed with status " + response.code());
+                        return;
+                    }
+
+                    try {
+                        String responseBody = response.body().string();
+                        JSONObject json = new JSONObject(responseBody);
+                        String status = json.getString("status");
+                        
+                        if ("success".equals(status)) {
+                            String recordId = json.getString("record_id");
+                            callback.onSuccess(recordId);
+                        } else {
+                            callback.onFailure("Invalid response format");
+                        }
+                    } catch (JSONException e) {
+                        callback.onFailure("Failed to parse response: " + e.getMessage());
+                    }
+                }
+            });
+        } catch (JSONException e) {
+            callback.onFailure("Failed to create request: " + e.getMessage());
+        }
+    }
+
+    /**
+     * Step 2: Upload video to the initiated recording
+     */
+    private void uploadVideo(File videoFile, String recordId, String publicKey, 
+                            String customerId, int duration, UploadCallback callback) {
+        OkHttpClient client = new OkHttpClient.Builder()
+            .connectTimeout(60, java.util.concurrent.TimeUnit.SECONDS)
+            .writeTimeout(60, java.util.concurrent.TimeUnit.SECONDS)
+            .readTimeout(60, java.util.concurrent.TimeUnit.SECONDS)
+            .build();
+
+        RequestBody requestBody = new MultipartBody.Builder()
+            .setType(MultipartBody.FORM)
+            .addFormDataPart("record_id", recordId)
+            .addFormDataPart("console_error", "[]")
+            .addFormDataPart("api_response_log", "[]")
+            .addFormDataPart("page_view", "[]")
+            .addFormDataPart("record_media", "recording.mp4",
+                RequestBody.create(videoFile, MediaType.parse("video/mp4")))
+            .build();
+
+        Request request = new Request.Builder()
+            .url("https://api.cuoral.com/customer-intelligence/update/record")
+            .post(requestBody)
+            .addHeader("Accept", "*/*")
+            .build();
+
+        client.newCall(request).enqueue(new Callback() {
+            @Override
+            public void onFailure(Call call, IOException e) {
+                callback.onFailure(e.getMessage());
+            }
+
+            @Override
+            public void onResponse(Call call, Response response) throws IOException {
+                if (!response.isSuccessful()) {
+                    callback.onFailure("Upload failed with status " + response.code());
+                    return;
+                }
+
+                try {
+                    String responseBody = response.body().string();
+                    JSONObject json = new JSONObject(responseBody);
+                    String status = json.getString("status");
+                    
+                    if ("success".equals(status)) {
+                        callback.onSuccess();
+                    } else {
+                        callback.onFailure("Upload failed");
+                    }
+                } catch (JSONException e) {
+                    callback.onFailure("Failed to parse response: " + e.getMessage());
+                }
+            }
+        });
+    }
 }

package/dist/cuoral.d.ts

@@ -40,6 +40,28 @@ export declare class Cuoral {
      * Track an error manually
      */
     trackError(message: string, stackTrace?: string, metadata?: any): void;
+    /**
+     * Update user profile for the current session
+     * Call this after user logs in to update the intelligence session with their profile
+     * @param email - User's email address
+     * @param name - User's full name
+     */
+    updateUserProfile(email: string, name: string): Promise<boolean>;
+    /**
+     * Start native screen recording programmatically
+     * @returns Promise<boolean> - true if recording started successfully
+     */
+    startRecording(): Promise<boolean>;
+    /**
+     * Stop native screen recording programmatically
+     * Recording will be automatically uploaded to the portal
+     * @returns Promise<{filePath?: string; duration?: number; uploaded?: boolean} | null> - Recording result or null if failed
+     */
+    stopRecording(): Promise<{
+        filePath?: string;
+        duration?: number;
+        uploaded?: boolean;
+    } | null>;
     /**
      * Open the widget modal
      */
@@ -60,6 +82,11 @@ export declare class Cuoral {
      * Clear and end the current session (call before logout)
      */
     clearSession(): Promise<void>;
+    /**
+     * Setup localStorage listener for session changes
+     * Widget updates localStorage when creating new session, SDK detects and syncs
+     */
+    private setupStorageListener;
     /**
      * Clean up resources
      */

package/dist/cuoral.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cuoral.d.ts","sourceRoot":"","sources":["../src/cuoral.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAeD;;GAEG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,KAAK,CAAC,CAAc;IAC5B,OAAO,CAAC,YAAY,CAAC,CAAqB;IAC1C,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAuC;IACpF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAwB;gBAElD,OAAO,EAAE,aAAa;IA2ClC;;OAEG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBxC;;OAEG;YACW,sBAAsB;IAwCpC;;OAEG;YACW,yBAAyB;IAoCvC;;OAEG;IACI,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,GAAG,GAAG,IAAI;IAM1D;;OAEG;IACI,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,GAAG,GAAG,IAAI;IAM7E;;OAEG;IACI,SAAS,IAAI,IAAI;IASxB;;OAEG;IACI,UAAU,IAAI,IAAI;IAMzB;;OAEG;IACI,WAAW,IAAI,OAAO;IAI7B;;OAEG;IACI,YAAY,IAAI,MAAM;IAuB7B;;OAEG;IACU,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IA6C1C;;OAEG;IACI,OAAO,IAAI,IAAI;IActB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAa5B;;OAEG;YACW,eAAe;IAkC7B;;OAEG;YACW,UAAU;IAmBxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAuE7B"}
+{"version":3,"file":"cuoral.d.ts","sourceRoot":"","sources":["../src/cuoral.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAeD;;GAEG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,KAAK,CAAC,CAAc;IAC5B,OAAO,CAAC,YAAY,CAAC,CAAqB;IAC1C,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAuC;IACpF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAwB;gBAElD,OAAO,EAAE,aAAa;IAiDlC;;OAEG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBxC;;OAEG;YACW,sBAAsB;IA2CpC;;OAEG;YACW,yBAAyB;IAoCvC;;OAEG;IACI,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,GAAG,GAAG,IAAI;IAM1D;;OAEG;IACI,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,GAAG,GAAG,IAAI;IAM7E;;;;;OAKG;IACU,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA0C7E;;;OAGG;IACU,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAS/C;;;;OAIG;IACU,aAAa,IAAI,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAC,GAAG,IAAI,CAAC;IAiBxG;;OAEG;IACI,SAAS,IAAI,IAAI;IASxB;;OAEG;IACI,UAAU,IAAI,IAAI;IAMzB;;OAEG;IACI,WAAW,IAAI,OAAO;IAI7B;;OAEG;IACI,YAAY,IAAI,MAAM;IAuB7B;;OAEG;IACU,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IA6C1C;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAsB5B;;OAEG;IACI,OAAO,IAAI,IAAI;IActB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAa5B;;OAEG;YACW,eAAe;IAkC7B;;OAEG;YACW,UAAU;IAmBxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAyF7B"}