React native/files types (#490)

mohitpubnub · Mohit Tejani · pubnub-release-bot · web-flow · commit 2d58c9abe5a6 · 2026-02-12T17:17:24.000+05:30
* added ReadableFile types filedata for react native target to use durin files operations

* fix minor lint

* PubNub SDK v10.2.7 release.

---------

Co-authored-by: Mohit Tejani &lt;mohit.tejani@Mohits-MacBook-Pro.local&gt;
Co-authored-by: PubNub Release Bot &lt;120067856+pubnub-release-bot@users.noreply.github.com&gt;
diff --git a/.pubnub.yml b/.pubnub.yml
@@ -1,5 +1,10 @@
 ---
 changelog:
+  - date: 2026-02-11
+    version: v10.2.7
+    changes:
+      - type: improvement
+        text: "PubNubFile to support `ReadableFile` type for React Native target platform."
   - date: 2026-01-13
     version: v10.2.6
     changes:
@@ -1384,7 +1389,7 @@ supported-platforms:
       - 'Ubuntu 14.04 and up'
       - 'Windows 7 and up'
     version: 'Pubnub Javascript for Node'
-version: '10.2.6'
+version: '10.2.7'
 sdks:
   - full-name: PubNub Javascript SDK
     short-name: Javascript
@@ -1400,7 +1405,7 @@ sdks:
           - distribution-type: source
             distribution-repository: GitHub release
             package-name: pubnub.js
-            location: https://github.com/pubnub/javascript/archive/refs/tags/v10.2.6.zip
+            location: https://github.com/pubnub/javascript/archive/refs/tags/v10.2.7.zip
             requires:
               - name: 'agentkeepalive'
                 min-version: '3.5.2'
@@ -2071,7 +2076,7 @@ sdks:
           - distribution-type: library
             distribution-repository: GitHub release
             package-name: pubnub.js
-            location: https://github.com/pubnub/javascript/releases/download/v10.2.6/pubnub.10.2.6.js
+            location: https://github.com/pubnub/javascript/releases/download/v10.2.7/pubnub.10.2.7.js
             requires:
               - name: 'agentkeepalive'
                 min-version: '3.5.2'
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,3 +1,9 @@
+## v10.2.7
+February 11 2026
+
+#### Modified
+- PubNubFile to support `ReadableFile` type for React Native target platform.
+
 ## v10.2.6
 January 13 2026
 
diff --git a/README.md b/README.md
@@ -27,8 +27,8 @@ Watch [Getting Started with PubNub JS SDK](https://app.dashcam.io/replay/64ee0d2
      npm install pubnub
      ```
    * or download one of our builds from our CDN: 
-     * https://cdn.pubnub.com/sdk/javascript/pubnub.10.2.6.js
-     * https://cdn.pubnub.com/sdk/javascript/pubnub.10.2.6.min.js
+     * https://cdn.pubnub.com/sdk/javascript/pubnub.10.2.7.js
+     * https://cdn.pubnub.com/sdk/javascript/pubnub.10.2.7.min.js
 
 2. Configure your keys:
 
diff --git a/dist/web/pubnub.js b/dist/web/pubnub.js
@@ -5438,7 +5438,7 @@
 	            return base.PubNubFile;
 	        },
 	        get version() {
-	            return '10.2.6';
+	            return '10.2.7';
 	        },
 	        getVersion() {
 	            return this.version;
diff --git a/dist/web/pubnub.min.js b/dist/web/pubnub.min.js
diff --git a/lib/core/components/configuration.js b/lib/core/components/configuration.js
@@ -168,7 +168,7 @@ const makeConfiguration = (base, setupCryptoModule) => {
             return base.PubNubFile;
         },
         get version() {
-            return '10.2.6';
+            return '10.2.7';
         },
         getVersion() {
             return this.version;
diff --git a/lib/file/modules/react-native.js b/lib/file/modules/react-native.js
@@ -35,8 +35,52 @@ class PubNubFile {
             const contents = file.data;
             fileMimeType = file.mimeType;
             fileName = file.name;
-            fileData = new File([contents], fileName, { type: fileMimeType });
-            contentLength = fileData.size;
+            // create a ReadableFile wrapper for ArrayBuffer data
+            if (contents instanceof ArrayBuffer || ArrayBuffer.isView(contents)) {
+                // Create ReadableFile wrapper for ArrayBuffer
+                const arrayBuffer = contents instanceof ArrayBuffer ? contents : contents.buffer;
+                contentLength = arrayBuffer.byteLength;
+                fileData = {
+                    arrayBuffer: () => __awaiter(this, void 0, void 0, function* () { return arrayBuffer; }),
+                    blob: () => __awaiter(this, void 0, void 0, function* () {
+                        throw new Error('toBlob() is not supported in React Native environment. Use toArrayBuffer() instead.');
+                    }),
+                    text: () => __awaiter(this, void 0, void 0, function* () {
+                        const decoder = new TextDecoder();
+                        return decoder.decode(arrayBuffer);
+                    }),
+                };
+            }
+            else if (typeof contents === 'string') {
+                // Handle string data
+                const encoder = new TextEncoder();
+                const arrayBuffer = encoder.encode(contents).buffer;
+                contentLength = arrayBuffer.byteLength;
+                fileData = {
+                    arrayBuffer: () => __awaiter(this, void 0, void 0, function* () { return arrayBuffer; }),
+                    blob: () => __awaiter(this, void 0, void 0, function* () { return new Blob([contents], { type: fileMimeType }); }),
+                    text: () => __awaiter(this, void 0, void 0, function* () { return contents; }),
+                };
+            }
+            else if (contents instanceof Blob) {
+                // Handle Blob data
+                contentLength = contents.size;
+                fileData = {
+                    arrayBuffer: () => __awaiter(this, void 0, void 0, function* () { return yield contents.arrayBuffer(); }),
+                    blob: () => __awaiter(this, void 0, void 0, function* () { return contents; }),
+                    text: () => __awaiter(this, void 0, void 0, function* () { return yield contents.text(); }),
+                };
+            }
+            else {
+                // Fallback: Try to use File constructor (may still fail in some environments)
+                try {
+                    fileData = new File([contents], fileName, { type: fileMimeType });
+                    contentLength = fileData.size;
+                }
+                catch (error) {
+                    throw new Error(`Unable to create file from provided data type. ArrayBuffer, Blob, or string expected.Error: ${error}`);
+                }
+            }
         }
         else if ('uri' in file) {
             fileMimeType = file.mimeType;
diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "pubnub",
-  "version": "10.2.6",
+  "version": "10.2.7",
   "author": "PubNub <support@pubnub.com>",
   "description": "Publish & Subscribe Real-time Messaging with PubNub",
   "scripts": {
diff --git a/src/core/components/configuration.ts b/src/core/components/configuration.ts
@@ -236,7 +236,7 @@ export const makeConfiguration = (
       return base.PubNubFile;
     },
     get version(): string {
-      return '10.2.6';
+      return '10.2.7';
     },
     getVersion(): string {
       return this.version;
diff --git a/src/file/modules/react-native.ts b/src/file/modules/react-native.ts
@@ -116,8 +116,53 @@ export class PubNubFile implements PubNubFileInterface {
 
       fileMimeType = file.mimeType;
       fileName = file.name;
-      fileData = new File([contents], fileName, { type: fileMimeType });
-      contentLength = fileData.size;
+
+      // create a ReadableFile wrapper for ArrayBuffer data
+      if (contents instanceof ArrayBuffer || ArrayBuffer.isView(contents)) {
+        // Create ReadableFile wrapper for ArrayBuffer
+        const arrayBuffer = contents instanceof ArrayBuffer ? contents : contents.buffer;
+        contentLength = arrayBuffer.byteLength;
+
+        fileData = {
+          arrayBuffer: async () => arrayBuffer,
+          blob: async () => {
+            throw new Error('toBlob() is not supported in React Native environment. Use toArrayBuffer() instead.');
+          },
+          text: async () => {
+            const decoder = new TextDecoder();
+            return decoder.decode(arrayBuffer);
+          },
+        } as ReadableFile;
+      } else if (typeof contents === 'string') {
+        // Handle string data
+        const encoder = new TextEncoder();
+        const arrayBuffer = encoder.encode(contents).buffer;
+        contentLength = arrayBuffer.byteLength;
+
+        fileData = {
+          arrayBuffer: async () => arrayBuffer,
+          blob: async () => new Blob([contents], { type: fileMimeType }),
+          text: async () => contents,
+        } as ReadableFile;
+      } else if (contents instanceof Blob) {
+        // Handle Blob data
+        contentLength = contents.size;
+        fileData = {
+          arrayBuffer: async () => await contents.arrayBuffer(),
+          blob: async () => contents,
+          text: async () => await contents.text(),
+        } as ReadableFile;
+      } else {
+        // Fallback: Try to use File constructor (may still fail in some environments)
+        try {
+          fileData = new File([contents], fileName, { type: fileMimeType });
+          contentLength = fileData.size;
+        } catch (error) {
+          throw new Error(
+            `Unable to create file from provided data type. ArrayBuffer, Blob, or string expected.Error: ${error}`,
+          );
+        }
+      }
     } else if ('uri' in file) {
       fileMimeType = file.mimeType;
       fileName = file.name;
diff --git a/test/dist/react-native.test.js b/test/dist/react-native.test.js
@@ -412,5 +412,69 @@ describe('#distribution test (rkt-native)', function () {
         pubnub.File.create({});
       }).to.throw();
     });
+
+    it('should wrap string data with readable file support', async function () {
+      const fileData = {
+        data: 'Hello React Native',
+        name: 'string-test.txt',
+        mimeType: 'text/plain'
+      };
+
+      const file = pubnub.File.create(fileData);
+
+      expect(file).to.be.an('object');
+      expect(file).to.have.property('name').equal('string-test.txt');
+      expect(file).to.have.property('mimeType').equal('text/plain');
+
+      const text = await file.toString();
+      expect(text).to.equal('Hello React Native');
+
+      const arrayBuffer = await file.toArrayBuffer();
+      const decoded = new TextDecoder().decode(arrayBuffer);
+      expect(decoded).to.equal('Hello React Native');
+
+      const blob = await file.toBlob();
+      expect(blob).to.be.instanceOf(Blob);
+      expect(blob.type).to.equal('text/plain');
+    });
+
+    it('should wrap ArrayBuffer data and disallow toBlob in React Native', async function () {
+      const encoder = new TextEncoder();
+      const arrayBuffer = encoder.encode('ArrayBuffer content').buffer;
+      const fileData = {
+        data: arrayBuffer,
+        name: 'arraybuffer-test.txt',
+        mimeType: 'text/plain'
+      };
+
+      const file = pubnub.File.create(fileData);
+
+      const buffer = await file.toArrayBuffer();
+      const decoded = new TextDecoder().decode(buffer);
+      expect(decoded).to.equal('ArrayBuffer content');
+
+      try {
+        await file.toBlob();
+        throw new Error('Expected toBlob to throw');
+      } catch (error) {
+        expect(error.message).to.equal(
+          'toBlob() is not supported in React Native environment. Use toArrayBuffer() instead.'
+        );
+      }
+    });
+
+    it('should accept ArrayBufferView data and expose content via toArrayBuffer', async function () {
+      const dataView = new Uint8Array([80, 117, 98, 78, 117, 98]);
+      const fileData = {
+        data: dataView,
+        name: 'view-test.txt',
+        mimeType: 'text/plain'
+      };
+
+      const file = pubnub.File.create(fileData);
+      const buffer = await file.toArrayBuffer();
+      const decoded = new TextDecoder().decode(buffer);
+      expect(decoded).to.equal('PubNub');
+    });
   });
 });

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "pubnub",`
`3`		`- "version": "10.2.6",`
	`3`	`+ "version": "10.2.7",`
`4`	`4`	`"author": "PubNub <support@pubnub.com>",`
`5`	`5`	`"description": "Publish & Subscribe Real-time Messaging with PubNub",`
`6`	`6`	`"scripts": {`