fix: expose File construct for web target (#483)

mohitpubnub · Mohit Tejani · pubnub-release-bot · web-flow · commit d8b92af4f49f · 2025-11-10T09:04:43.000+05:30
* expose pubnub.File for target specific file handling construct

* test for web to confirm access to File

* update dist/lib

* update .npmignore

* PubNub SDK v10.2.1 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/.gitignore b/.gitignore
@@ -16,6 +16,7 @@ dist/contract
 dist/cucumber
 upload
 test/specs
+.claude/*
 
 # GitHub Actions #
 ##################
diff --git a/.npmignore b/.npmignore
@@ -8,9 +8,15 @@ coverage/
 .idea
 *.iml
 .travis
-
+test/*
+.eslintignore
+.eslintrc.cjs
+.prettierrc
+.prettierignore
+.prettierignore
+.claude/*
 .babelrc
-
 .github
 release-artifacts-*
 resources/*
+docs-snippets/*
diff --git a/.pubnub.yml b/.pubnub.yml
@@ -1,5 +1,10 @@
 ---
 changelog:
+  - date: 2025-11-03
+    version: v10.2.1
+    changes:
+      - type: improvement
+        text: "Expose `File` on pubnub instance to manually create supported File construct."
   - date: 2025-10-29
     version: v10.2.0
     changes:
@@ -1354,7 +1359,7 @@ supported-platforms:
       - 'Ubuntu 14.04 and up'
       - 'Windows 7 and up'
     version: 'Pubnub Javascript for Node'
-version: '10.2.0'
+version: '10.2.1'
 sdks:
   - full-name: PubNub Javascript SDK
     short-name: Javascript
@@ -1370,7 +1375,7 @@ sdks:
           - distribution-type: source
             distribution-repository: GitHub release
             package-name: pubnub.js
-            location: https://github.com/pubnub/javascript/archive/refs/tags/v10.2.0.zip
+            location: https://github.com/pubnub/javascript/archive/refs/tags/v10.2.1.zip
             requires:
               - name: 'agentkeepalive'
                 min-version: '3.5.2'
@@ -2041,7 +2046,7 @@ sdks:
           - distribution-type: library
             distribution-repository: GitHub release
             package-name: pubnub.js
-            location: https://github.com/pubnub/javascript/releases/download/v10.2.0/pubnub.10.2.0.js
+            location: https://github.com/pubnub/javascript/releases/download/v10.2.1/pubnub.10.2.1.js
             requires:
               - name: 'agentkeepalive'
                 min-version: '3.5.2'
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,3 +1,9 @@
+## v10.2.1
+November 03 2025
+
+#### Modified
+- Expose `File` on pubnub instance to manually create supported File construct.
+
 ## v10.2.0
 October 29 2025
 
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.0.js
-     * https://cdn.pubnub.com/sdk/javascript/pubnub.10.2.0.min.js
+     * https://cdn.pubnub.com/sdk/javascript/pubnub.10.2.1.js
+     * https://cdn.pubnub.com/sdk/javascript/pubnub.10.2.1.min.js
 
 2. Configure your keys:
 
diff --git a/dist/web/pubnub.js b/dist/web/pubnub.js
@@ -5436,7 +5436,7 @@
 	            return base.PubNubFile;
 	        },
 	        get version() {
-	            return '10.2.0';
+	            return '10.2.1';
 	        },
 	        getVersion() {
 	            return this.version;
@@ -18358,6 +18358,10 @@
 	            tokenManager,
 	            crypto,
 	        });
+	        /**
+	         * PubNub File constructor.
+	         */
+	        this.File = PubNubFile;
 	        this.onHeartbeatIntervalChange = heartbeatIntervalChangeHandler;
 	        this.onAuthenticationChange = authenticationChangeHandler;
 	        this.onPresenceStateChange = presenceStateChangeHandler;
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.0';
+            return '10.2.1';
         },
         getVersion() {
             return this.version;
diff --git a/lib/react_native/index.js b/lib/react_native/index.js
@@ -88,6 +88,10 @@ class PubNub extends pubnub_common_1.PubNubCore {
             tokenManager,
             crypto,
         });
+        /**
+         * PubNub File constructor.
+         */
+        this.File = react_native_1.default;
     }
 }
 /**
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.0",
+  "version": "10.2.1",
   "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.0';
+      return '10.2.1';
     },
     getVersion(): string {
       return this.version;
diff --git a/src/react_native/index.ts b/src/react_native/index.ts
@@ -19,6 +19,7 @@ import type { CryptorConfiguration, ICryptoModule } from '../core/interfaces/cry
 import { PubNubCore } from '../core/pubnub-common';
 import { setDefaults } from './configuration';
 import Cbor from '../cbor/common';
+import { PubNubFileConstructor } from '../core/types/file';
 
 export type {
   LinearRetryPolicyConfiguration,
@@ -77,6 +78,11 @@ export default class PubNub extends PubNubCore<null, PubNubFileParameters> {
    */
   static generateUUID = PubNubCore.generateUUID;
 
+  /**
+   * PubNub File constructor.
+   */
+  public File: PubNubFileConstructor<PubNubFile, PubNubFileParameters> = PubNubFile;
+
   /**
    * Construct notification payload which will trigger push notification.
    */
diff --git a/src/web/index.ts b/src/web/index.ts
@@ -25,6 +25,7 @@ import WebCryptography from '../crypto/modules/web';
 import { PubNubCore } from '../core/pubnub-common';
 import Cbor from '../cbor/common';
 import { Payload } from '../core/types/api';
+import { PubNubFileConstructor } from '../core/types/file';
 
 /**
  * PubNub client for browser platform.
@@ -36,6 +37,10 @@ export default class PubNub extends PubNubCore<ArrayBuffer | string, PubNubFileP
   static CryptoModule: typeof CryptoModuleType | undefined =
     process.env.CRYPTO_MODULE !== 'disabled' ? WebCryptoModule : undefined;
 
+  /**
+   * PubNub File constructor.
+   */
+  public File: PubNubFileConstructor<PubNubFile, PubNubFileParameters> = PubNubFile;
   /**
    * Create and configure the PubNub client core.
    *
diff --git a/test/dist/react-native.test.js b/test/dist/react-native.test.js
@@ -324,7 +324,7 @@ describe('#distribution test (rkt-native)', function () {
 
     it('should maintain compatibility with all static method signatures', function () {
       // Test that all methods match expected signatures from Web/Node
-      
+
       // Retry policy methods should accept configuration objects
       expect(() => {
         PubNub.ExponentialRetryPolicy({
@@ -356,4 +356,61 @@ describe('#distribution test (rkt-native)', function () {
       }).to.not.throw();
     });
   });
+
+  describe('#File', function () {
+    it('should have access to File property on pubnub instance', function () {
+      expect(pubnub.File).to.be.a('function');
+      expect(pubnub.File).to.have.property('create');
+    });
+
+    it('should be able to create a PubNubFile using pubnub.File.create() with data object', function () {
+      const fileData = {
+        data: 'Hello World',
+        name: 'test.txt',
+        mimeType: 'text/plain'
+      };
+
+      const file = pubnub.File.create(fileData);
+
+      expect(file).to.be.an('object');
+      expect(file).to.have.property('name').equal('test.txt');
+      expect(file).to.have.property('mimeType').equal('text/plain');
+      expect(file).to.have.property('data');
+    });
+
+    it('should be able to create a PubNubFile using pubnub.File.create() with Blob', function () {
+      const blob = new Blob(['test content'], { type: 'text/plain' });
+      const fileData = {
+        data: blob,
+        name: 'blob-test.txt',
+        mimeType: 'text/plain'
+      };
+
+      const file = pubnub.File.create(fileData);
+
+      expect(file).to.be.an('object');
+      expect(file).to.have.property('name').equal('blob-test.txt');
+      expect(file).to.have.property('mimeType').equal('text/plain');
+    });
+
+    it('should be able to create a PubNubFile using pubnub.File.create() with uri', function () {
+      const fileData = {
+        uri: 'file:///path/to/file.txt',
+        name: 'uri-test.txt',
+        mimeType: 'text/plain'
+      };
+
+      const file = pubnub.File.create(fileData);
+
+      expect(file).to.be.an('object');
+      expect(file).to.have.property('name').equal('uri-test.txt');
+      expect(file).to.have.property('mimeType').equal('text/plain');
+    });
+
+    it('should throw error when creating PubNubFile without required parameters', function () {
+      expect(() => {
+        pubnub.File.create({});
+      }).to.throw();
+    });
+  });
 });
diff --git a/test/dist/web.test.js b/test/dist/web.test.js
@@ -0,0 +1,79 @@
+/* global describe, beforeEach, it, before, afterEach, after, chai */
+/* eslint no-console: 0 */
+
+import { expect } from 'chai';
+import PubNub from '../../src/web';
+
+var pubnub;
+
+describe('#distribution test (web)', function () {
+  before(function () {
+    pubnub = new PubNub({
+      subscribeKey: 'demo',
+      publishKey: 'demo',
+      uuid: 'myUUID',
+    });
+  });
+
+  after(function () {
+    pubnub.destroy();
+  });
+
+  describe('#File', function () {
+    it('should have access to File property on pubnub instance', function () {
+      expect(pubnub.File).to.be.a('function');
+      expect(pubnub.File).to.have.property('create');
+    });
+
+    it('should be able to create a PubNubFile using pubnub.File.create() with data object', function () {
+      var fileData = {
+        data: 'Hello World',
+        name: 'test.txt',
+        mimeType: 'text/plain',
+      };
+
+      var file = pubnub.File.create(fileData);
+
+      expect(file).to.be.an('object');
+      expect(file).to.have.property('name').equal('test.txt');
+      expect(file).to.have.property('mimeType').equal('text/plain');
+      expect(file).to.have.property('data');
+    });
+
+    it('should be able to create a PubNubFile using pubnub.File.create() with Blob', function () {
+      var blob = new Blob(['test content'], { type: 'text/plain' });
+      var fileData = {
+        data: blob,
+        name: 'blob-test.txt',
+        mimeType: 'text/plain',
+      };
+
+      var file = pubnub.File.create(fileData);
+
+      expect(file).to.be.an('object');
+      expect(file).to.have.property('name').equal('blob-test.txt');
+      expect(file).to.have.property('mimeType').equal('text/plain');
+    });
+
+    it('should be able to create a PubNubFile using pubnub.File.create() with ArrayBuffer', function () {
+      var buffer = new ArrayBuffer(8);
+      var fileData = {
+        data: buffer,
+        name: 'buffer-test.bin',
+        mimeType: 'application/octet-stream',
+      };
+
+      var file = pubnub.File.create(fileData);
+
+      expect(file).to.be.an('object');
+      expect(file).to.have.property('name').equal('buffer-test.bin');
+      expect(file).to.have.property('mimeType').equal('application/octet-stream');
+    });
+
+    it('should throw error when creating PubNubFile without required parameters', function () {
+      expect(function () {
+        pubnub.File.create({});
+      }).to.throw();
+    });
+  });
+});

Original file line number	Diff line number	Diff line change
`@@ -88,6 +88,10 @@ class PubNub extends pubnub_common_1.PubNubCore {`
`88`	`88`	`tokenManager,`
`89`	`89`	`crypto,`
`90`	`90`	`});`
	`91`	`+ /**`
	`92`	`+ * PubNub File constructor.`
	`93`	`+ */`
	`94`	`+ this.File = react_native_1.default;`
`91`	`95`	`}`
`92`	`96`	`}`
`93`	`97`	`/**`