feat(node-sdk): add refreshFlags() method (#529)

Allow users to trigger an on-demand refresh of cached flag definitions
instead of waiting for the next automatic refresh cycle.

Author: roncohen

packages/node-sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reflag/node-sdk",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "license": "MIT",
   "repository": {
     "type": "git",

packages/node-sdk/src/client.ts

@@ -598,6 +598,21 @@ export class ReflagClient {
     await this.flagsCache.waitRefresh();
   }
 
+  /**
+   * Refreshes the flag definitions from the server.
+   *
+   * @remarks
+   * This triggers an on-demand refresh of the cached flag definitions.
+   * Useful when you know flags have changed and don't want to wait for the next automatic refresh cycle.
+   *
+   * Note: updated flag rules take a few seconds to propagate to all servers.
+   *
+   * Concurrent calls are deduplicated — multiple calls share the same in-flight request.
+   */
+  public async refreshFlags() {
+    await this.flagsCache.refresh();
+  }
+
   /**
    * Destroys the client and cleans up all resources including timers and background processes.
    *
@@ -1491,6 +1506,13 @@ export class BoundReflagClient {
   public async flush() {
     await this._client.flush();
   }
+
+  /**
+   * Refreshes the flag definitions from the server.
+   */
+  public async refreshFlags() {
+    await this._client.refreshFlags();
+  }
 }
 
 function checkMeta(

packages/node-sdk/test/client.test.ts

@@ -992,6 +992,34 @@ describe("ReflagClient", () => {
     });
   });
 
+  describe("refreshFlags", () => {
+    it("should call flagsCache.refresh()", async () => {
+      const client = new ReflagClient(validOptions);
+
+      const refresh = vi
+        .spyOn(client["flagsCache"], "refresh")
+        .mockResolvedValue(undefined);
+
+      await client.refreshFlags();
+
+      expect(refresh).toHaveBeenCalledTimes(1);
+    });
+
+    it("should call flagsCache.refresh() on each invocation", async () => {
+      const client = new ReflagClient(validOptions);
+
+      const refresh = vi
+        .spyOn(client["flagsCache"], "refresh")
+        .mockResolvedValue(undefined);
+
+      await client.refreshFlags();
+      await client.refreshFlags();
+      await client.refreshFlags();
+
+      expect(refresh).toHaveBeenCalledTimes(3);
+    });
+  });
+
   describe("getFlag", () => {
     let client: ReflagClient;
 

yarn.lock

@@ -5140,7 +5140,16 @@ __metadata:
   languageName: unknown
   linkType: soft
 
-"@reflag/node-sdk@npm:1.1.0, @reflag/node-sdk@workspace:packages/node-sdk":
+"@reflag/node-sdk@npm:1.1.0":
+  version: 1.1.0
+  resolution: "@reflag/node-sdk@npm:1.1.0"
+  dependencies:
+    "@reflag/flag-evaluation": "npm:1.0.0"
+  checksum: 10c0/32f1ba05ac40fe7c3b8a772efd04cc577ba6d6c043873ca0253fee3db00c51c1a3489982e8f60849e86bc3c958f5eb43f6995ead02cee90dae4d2c6df44e7a2c
+  languageName: node
+  linkType: hard
+
+"@reflag/node-sdk@workspace:packages/node-sdk":
   version: 0.0.0-use.local
   resolution: "@reflag/node-sdk@workspace:packages/node-sdk"
   dependencies: