@valkey/valkey-glide 2.2.6 → 2.3.0-rc5

package/README.md

@@ -14,8 +14,7 @@ Valkey General Language Independent Driver for the Enterprise (GLIDE) is the off
 
 ## Documentation
 
-See GLIDE's [documentation site](https://valkey.io/valkey-glide/).  
-Visit our [wiki](https://github.com/valkey-io/valkey-glide/wiki/NodeJS-wrapper) for examples and further details on TLS, Read strategy, Timeouts and various other configurations.
+See GLIDE's Node.js [documentation site](https://glide.valkey.io/languages/nodejs).
 
 ## Supported Engine Versions
 

package/build-ts/BaseClient.d.ts

@@ -2265,7 +2265,7 @@ export declare class BaseClient {
      *
      * @see {@link https://valkey.io/commands/blmove/|valkey.io} for details.
      * @remarks When in cluster mode, both `source` and `destination` must map to the same hash slot.
-     * @remarks `BLMOVE` is a client blocking command, see {@link https://github.com/valkey-io/valkey-glide/wiki/General-Concepts#blocking-commands|Valkey Glide Wiki} for more details and best practices.
+     * @remarks `BLMOVE` is a client blocking command, see {@link https://glide.valkey.io/how-to/connection-management/#blocking-commands|Valkey GLIDE Documentation} for more details and best practices.
      * @remarks Since Valkey version 6.2.0.
      *
      * @param source - The key to the source list.
@@ -5248,7 +5248,7 @@ export declare class BaseClient {
      *
      * @see {@link https://valkey.io/commands/brpop/|valkey.io} for more details.
      * @remarks When in cluster mode, all `keys` must map to the same hash slot.
-     * @remarks `BRPOP` is a blocking command, see [Blocking Commands](https://github.com/valkey-io/valkey-glide/wiki/General-Concepts#blocking-commands) for more details and best practices.
+     * @remarks `BRPOP` is a blocking command, see [Blocking Commands](https://glide.valkey.io/how-to/connection-management/#blocking-commands) for more details and best practices.
      *
      * @param keys - The `keys` of the lists to pop from.
      * @param timeout - The `timeout` in seconds.
@@ -5273,7 +5273,7 @@ export declare class BaseClient {
      *
      * @see {@link https://valkey.io/commands/blpop/|valkey.io} for more details.
      * @remarks When in cluster mode, all `keys` must map to the same hash slot.
-     * @remarks `BLPOP` is a blocking command, see [Blocking Commands](https://github.com/valkey-io/valkey-glide/wiki/General-Concepts#blocking-commands) for more details and best practices.
+     * @remarks `BLPOP` is a blocking command, see [Blocking Commands](https://glide.valkey.io/how-to/connection-management/#blocking-commands) for more details and best practices.
      *
      * @param keys - The `keys` of the lists to pop from.
      * @param timeout - The `timeout` in seconds.
@@ -5768,7 +5768,7 @@ export declare class BaseClient {
      *
      * @see {@link https://valkey.io/commands/bzmpop/|valkey.io} for more details.
      * @remarks When in cluster mode, all `keys` must map to the same hash slot.
-     * @remarks `BZMPOP` is a client blocking command, see {@link https://github.com/valkey-io/valkey-glide/wiki/General-Concepts#blocking-commands | Valkey Glide Wiki} for more details and best practices.
+     * @remarks `BZMPOP` is a client blocking command, see {@link https://glide.valkey.io/how-to/connection-management/#blocking-commands | Valkey GLIDE Documentation} for more details and best practices.
      * @remarks Since Valkey version 7.0.0.
      *
      * @param keys - The keys of the sorted sets.
@@ -6067,7 +6067,7 @@ export declare class BaseClient {
      * will only execute commands if the watched keys are not modified before execution of the
      * transaction. Executing a transaction will automatically flush all previously watched keys.
      *
-     * @see {@link https://valkey.io/commands/watch/|valkey.io} and {@link https://valkey.io/topics/transactions/#cas|Valkey Glide Wiki} for more details.
+     * @see {@link https://valkey.io/commands/watch/|valkey.io} and {@link https://valkey.io/topics/transactions/#cas|Valkey GLIDE Documentation} for more details.
      *
      * @remarks In cluster mode, if keys in `keys` map to different hash slots,
      * the command will be split across these slots and executed separately for each.

package/build-ts/BaseClient.js

@@ -476,7 +476,10 @@ class BaseClient {
                 const commandName = command instanceof ProtobufMessage_1.command_request.Command
                     ? ProtobufMessage_1.command_request.RequestType[command.requestType]
                     : "Batch";
-                const pair = (0, _1.createLeakedOtelSpan)(commandName);
+                const parentCtx = _1.OpenTelemetry.getParentSpanContext();
+                const pair = parentCtx
+                    ? (0, _1.createOtelSpanWithTraceContext)(commandName, parentCtx.traceId, parentCtx.spanId, parentCtx.traceFlags, parentCtx.traceState)
+                    : (0, _1.createLeakedOtelSpan)(commandName);
                 spanPtr = new long_1.default(pair[0], pair[1]);
             }
             this.promiseCallbackFunctions[callbackIndex] = [
@@ -2540,7 +2543,7 @@ class BaseClient {
      *
      * @see {@link https://valkey.io/commands/blmove/|valkey.io} for details.
      * @remarks When in cluster mode, both `source` and `destination` must map to the same hash slot.
-     * @remarks `BLMOVE` is a client blocking command, see {@link https://github.com/valkey-io/valkey-glide/wiki/General-Concepts#blocking-commands|Valkey Glide Wiki} for more details and best practices.
+     * @remarks `BLMOVE` is a client blocking command, see {@link https://glide.valkey.io/how-to/connection-management/#blocking-commands|Valkey GLIDE Documentation} for more details and best practices.
      * @remarks Since Valkey version 6.2.0.
      *
      * @param source - The key to the source list.
@@ -5722,7 +5725,7 @@ class BaseClient {
      *
      * @see {@link https://valkey.io/commands/brpop/|valkey.io} for more details.
      * @remarks When in cluster mode, all `keys` must map to the same hash slot.
-     * @remarks `BRPOP` is a blocking command, see [Blocking Commands](https://github.com/valkey-io/valkey-glide/wiki/General-Concepts#blocking-commands) for more details and best practices.
+     * @remarks `BRPOP` is a blocking command, see [Blocking Commands](https://glide.valkey.io/how-to/connection-management/#blocking-commands) for more details and best practices.
      *
      * @param keys - The `keys` of the lists to pop from.
      * @param timeout - The `timeout` in seconds.
@@ -5749,7 +5752,7 @@ class BaseClient {
      *
      * @see {@link https://valkey.io/commands/blpop/|valkey.io} for more details.
      * @remarks When in cluster mode, all `keys` must map to the same hash slot.
-     * @remarks `BLPOP` is a blocking command, see [Blocking Commands](https://github.com/valkey-io/valkey-glide/wiki/General-Concepts#blocking-commands) for more details and best practices.
+     * @remarks `BLPOP` is a blocking command, see [Blocking Commands](https://glide.valkey.io/how-to/connection-management/#blocking-commands) for more details and best practices.
      *
      * @param keys - The `keys` of the lists to pop from.
      * @param timeout - The `timeout` in seconds.
@@ -6282,7 +6285,7 @@ class BaseClient {
      *
      * @see {@link https://valkey.io/commands/bzmpop/|valkey.io} for more details.
      * @remarks When in cluster mode, all `keys` must map to the same hash slot.
-     * @remarks `BZMPOP` is a client blocking command, see {@link https://github.com/valkey-io/valkey-glide/wiki/General-Concepts#blocking-commands | Valkey Glide Wiki} for more details and best practices.
+     * @remarks `BZMPOP` is a client blocking command, see {@link https://glide.valkey.io/how-to/connection-management/#blocking-commands | Valkey GLIDE Documentation} for more details and best practices.
      * @remarks Since Valkey version 7.0.0.
      *
      * @param keys - The keys of the sorted sets.
@@ -6596,7 +6599,7 @@ class BaseClient {
      * will only execute commands if the watched keys are not modified before execution of the
      * transaction. Executing a transaction will automatically flush all previously watched keys.
      *
-     * @see {@link https://valkey.io/commands/watch/|valkey.io} and {@link https://valkey.io/topics/transactions/#cas|Valkey Glide Wiki} for more details.
+     * @see {@link https://valkey.io/commands/watch/|valkey.io} and {@link https://valkey.io/topics/transactions/#cas|Valkey GLIDE Documentation} for more details.
      *
      * @remarks In cluster mode, if keys in `keys` map to different hash slots,
      * the command will be split across these slots and executed separately for each.

package/build-ts/Batch.d.ts

@@ -922,7 +922,7 @@ export declare class BaseBatch<T extends BaseBatch<T>> {
      *
      * @see {@link https://valkey.io/commands/blmove/|valkey.io} for details.
      * @remarks When in cluster mode, both `source` and `destination` must map to the same hash slot.
-     * @remarks `BLMOVE` is a client blocking command, see {@link https://github.com/valkey-io/valkey-glide/wiki/General-Concepts#blocking-commands|Valkey Glide Wiki} for more details and best practices.
+     * @remarks `BLMOVE` is a client blocking command, see {@link https://glide.valkey.io/how-to/connection-management/#blocking-commands|Valkey GLIDE Documentation} for more details and best practices.
      * @remarks Since Valkey version 6.2.0.
      *
      * @param source - The key to the source list.
@@ -1945,7 +1945,7 @@ export declare class BaseBatch<T extends BaseBatch<T>> {
     /** Executes a single command, without checking inputs. Every part of the command, including subcommands,
      *  should be added as a separate value in args.
      *
-     * @see {@link https://github.com/valkey-io/valkey-glide/wiki/General-Concepts#custom-command|Valkey Glide Wiki} for details on the restrictions and limitations of the custom command API.
+     * @see {@link https://glide.valkey.io/concepts/client-features/custom-commands/|Valkey GLIDE Documentation} for details on the restrictions and limitations of the custom command API.
      *
      * Command Response - A response from Valkey with an `Object`.
      */
@@ -2362,7 +2362,7 @@ export declare class BaseBatch<T extends BaseBatch<T>> {
      * Blocks the connection when there are no elements to pop from any of the given lists.
      *
      * @see {@link https://valkey.io/commands/brpop/|valkey.io} for details.
-     * @remarks `BRPOP` is a blocking command, see [Blocking Commands](https://github.com/valkey-io/valkey-glide/wiki/General-Concepts#blocking-commands) for more details and best practices.
+     * @remarks `BRPOP` is a blocking command, see [Blocking Commands](https://glide.valkey.io/how-to/connection-management/#blocking-commands) for more details and best practices.
      *
      * @param keys - The `keys` of the lists to pop from.
      * @param timeout - The `timeout` in seconds.
@@ -2377,7 +2377,7 @@ export declare class BaseBatch<T extends BaseBatch<T>> {
      * Blocks the connection when there are no elements to pop from any of the given lists.
      *
      * @see {@link https://valkey.io/commands/blpop/|valkey.io} for details.
-     * @remarks `BLPOP` is a blocking command, see [Blocking Commands](https://github.com/valkey-io/valkey-glide/wiki/General-Concepts#blocking-commands) for more details and best practices.
+     * @remarks `BLPOP` is a blocking command, see [Blocking Commands](https://glide.valkey.io/how-to/connection-management/#blocking-commands) for more details and best practices.
      *
      * @param keys - The `keys` of the lists to pop from.
      * @param timeout - The `timeout` in seconds.
@@ -2761,7 +2761,7 @@ export declare class BaseBatch<T extends BaseBatch<T>> {
      * to pop from any of the given sorted sets. `BZMPOP` is the blocking variant of {@link zmpop}.
      *
      * @see {@link https://valkey.io/commands/bzmpop/|valkey.io} for details.
-     * @remarks `BZMPOP` is a client blocking command, see {@link https://github.com/valkey-io/valkey-glide/wiki/General-Concepts#blocking-commands | Valkey Glide Wiki} for more details and best practices.
+     * @remarks `BZMPOP` is a client blocking command, see {@link https://glide.valkey.io/how-to/connection-management/#blocking-commands | Valkey GLIDE Documentation} for more details and best practices.
      * @remarks Since Valkey version 7.0.0.
      *
      * @param keys - The keys of the sorted sets.

package/build-ts/Batch.js

@@ -1061,7 +1061,7 @@ class BaseBatch {
      *
      * @see {@link https://valkey.io/commands/blmove/|valkey.io} for details.
      * @remarks When in cluster mode, both `source` and `destination` must map to the same hash slot.
-     * @remarks `BLMOVE` is a client blocking command, see {@link https://github.com/valkey-io/valkey-glide/wiki/General-Concepts#blocking-commands|Valkey Glide Wiki} for more details and best practices.
+     * @remarks `BLMOVE` is a client blocking command, see {@link https://glide.valkey.io/how-to/connection-management/#blocking-commands|Valkey GLIDE Documentation} for more details and best practices.
      * @remarks Since Valkey version 6.2.0.
      *
      * @param source - The key to the source list.
@@ -2216,7 +2216,7 @@ class BaseBatch {
     /** Executes a single command, without checking inputs. Every part of the command, including subcommands,
      *  should be added as a separate value in args.
      *
-     * @see {@link https://github.com/valkey-io/valkey-glide/wiki/General-Concepts#custom-command|Valkey Glide Wiki} for details on the restrictions and limitations of the custom command API.
+     * @see {@link https://glide.valkey.io/concepts/client-features/custom-commands/|Valkey GLIDE Documentation} for details on the restrictions and limitations of the custom command API.
      *
      * Command Response - A response from Valkey with an `Object`.
      */
@@ -2695,7 +2695,7 @@ class BaseBatch {
      * Blocks the connection when there are no elements to pop from any of the given lists.
      *
      * @see {@link https://valkey.io/commands/brpop/|valkey.io} for details.
-     * @remarks `BRPOP` is a blocking command, see [Blocking Commands](https://github.com/valkey-io/valkey-glide/wiki/General-Concepts#blocking-commands) for more details and best practices.
+     * @remarks `BRPOP` is a blocking command, see [Blocking Commands](https://glide.valkey.io/how-to/connection-management/#blocking-commands) for more details and best practices.
      *
      * @param keys - The `keys` of the lists to pop from.
      * @param timeout - The `timeout` in seconds.
@@ -2712,7 +2712,7 @@ class BaseBatch {
      * Blocks the connection when there are no elements to pop from any of the given lists.
      *
      * @see {@link https://valkey.io/commands/blpop/|valkey.io} for details.
-     * @remarks `BLPOP` is a blocking command, see [Blocking Commands](https://github.com/valkey-io/valkey-glide/wiki/General-Concepts#blocking-commands) for more details and best practices.
+     * @remarks `BLPOP` is a blocking command, see [Blocking Commands](https://glide.valkey.io/how-to/connection-management/#blocking-commands) for more details and best practices.
      *
      * @param keys - The `keys` of the lists to pop from.
      * @param timeout - The `timeout` in seconds.
@@ -3154,7 +3154,7 @@ class BaseBatch {
      * to pop from any of the given sorted sets. `BZMPOP` is the blocking variant of {@link zmpop}.
      *
      * @see {@link https://valkey.io/commands/bzmpop/|valkey.io} for details.
-     * @remarks `BZMPOP` is a client blocking command, see {@link https://github.com/valkey-io/valkey-glide/wiki/General-Concepts#blocking-commands | Valkey Glide Wiki} for more details and best practices.
+     * @remarks `BZMPOP` is a client blocking command, see {@link https://glide.valkey.io/how-to/connection-management/#blocking-commands | Valkey GLIDE Documentation} for more details and best practices.
      * @remarks Since Valkey version 7.0.0.
      *
      * @param keys - The keys of the sorted sets.

package/build-ts/Commands.js

@@ -252,11 +252,15 @@ function isLargeCommand(args) {
 function toBuffersArray(args) {
     const argsBytes = [];
     for (const arg of args) {
-        if (typeof arg == "string") {
+        if (Buffer.isBuffer(arg)) {
+            argsBytes.push(arg);
+        }
+        else if (typeof arg === "string") {
             argsBytes.push(Buffer.from(arg));
         }
         else {
-            argsBytes.push(arg);
+            // Fallback for unexpected types (number, boolean, etc.)
+            argsBytes.push(Buffer.from(String(arg)));
         }
     }
     return argsBytes;

package/build-ts/GlideClient.d.ts

@@ -71,6 +71,24 @@ export type GlideClientConfiguration = BaseClientConfiguration & {
      * Advanced configuration settings for the client.
      */
     advancedConfiguration?: AdvancedGlideClientConfiguration;
+    /**
+     * When true, enables read-only mode for the standalone client.
+     *
+     * In read-only mode:
+     * - The client skips primary node detection (INFO REPLICATION command)
+     * - All connected nodes are treated as valid read targets
+     * - Write commands are blocked and will return an error
+     * - The default ReadFrom strategy becomes PreferReplica if not explicitly set
+     *
+     * This is useful for connecting to replica-only deployments or when you want to
+     * prevent accidental write operations.
+     *
+     * Note: read-only mode is not compatible with AZAffinity or AZAffinityReplicasAndPrimary
+     * read strategies.
+     *
+     * Defaults to false.
+     */
+    readOnly?: boolean;
 };
 /**
  * Represents advanced configuration settings for creating a {@link GlideClient | GlideClient} used in {@link GlideClientConfiguration | GlideClientConfiguration}.
@@ -91,7 +109,7 @@ export type AdvancedGlideClientConfiguration = AdvancedBaseClientConfiguration &
  * Client used for connection to standalone servers.
  * Use {@link createClient} to request a client.
  *
- * @see For full documentation refer to {@link https://github.com/valkey-io/valkey-glide/wiki/NodeJS-wrapper#standalone | Valkey Glide Wiki}.
+ * @see For full documentation refer to {@link https://glide.valkey.io/how-to/client-initialization/#standalone | Valkey GLIDE Documentation}.
  */
 export declare class GlideClient extends BaseClient {
     /**
@@ -152,7 +170,7 @@ export declare class GlideClient extends BaseClient {
      * **Notes:**
      * - **Atomic Batches - Transactions:** If the transaction fails due to a `WATCH` command, `EXEC` will return `null`.
      *
-     * @see {@link https://github.com/valkey-io/valkey-glide/wiki/NodeJS-wrapper#transaction|Valkey Glide Wiki} for details on Valkey Transactions.
+     * @see {@link https://github.com/valkey-io/valkey-glide/wiki/NodeJS-wrapper#transaction|Valkey GLIDE Documentation} for details on Valkey Transactions.
      *
      * @param batch - A {@link Batch} object containing a list of commands to be executed.
      * @param raiseOnError - Determines how errors are handled within the batch response.
@@ -199,7 +217,7 @@ export declare class GlideClient extends BaseClient {
      *
      * Note: An error will occur if the string decoder is used with commands that return only bytes as a response.
      *
-     * @see {@link https://github.com/valkey-io/valkey-glide/wiki/General-Concepts#custom-command|Valkey Glide Wiki} for details on the restrictions and limitations of the custom command API.
+     * @see {@link https://glide.valkey.io/concepts/client-features/custom-commands/|Valkey GLIDE Documentation} for details on the restrictions and limitations of the custom command API.
      *
      * @param args - A list including the command name and arguments for the custom command.
      * @param options - (Optional) See {@link DecoderOption}.
@@ -674,7 +692,7 @@ export declare class GlideClient extends BaseClient {
      * Flushes all the previously watched keys for a transaction. Executing a transaction will
      * automatically flush all previously watched keys.
      *
-     * @see {@link https://valkey.io/commands/unwatch/|valkey.io} and {@link https://valkey.io/topics/transactions/#cas|Valkey Glide Wiki} for more details.
+     * @see {@link https://valkey.io/commands/unwatch/|valkey.io} and {@link https://valkey.io/topics/transactions/#cas|Valkey GLIDE Documentation} for more details.
      *
      * @returns A simple `"OK"` response.
      *

package/build-ts/GlideClient.js

@@ -29,7 +29,7 @@ var GlideClientConfiguration;
  * Client used for connection to standalone servers.
  * Use {@link createClient} to request a client.
  *
- * @see For full documentation refer to {@link https://github.com/valkey-io/valkey-glide/wiki/NodeJS-wrapper#standalone | Valkey Glide Wiki}.
+ * @see For full documentation refer to {@link https://glide.valkey.io/how-to/client-initialization/#standalone | Valkey GLIDE Documentation}.
  */
 class GlideClient extends BaseClient_1.BaseClient {
     /**
@@ -41,6 +41,10 @@ class GlideClient extends BaseClient_1.BaseClient {
         if (options.advancedConfiguration) {
             this.configureAdvancedConfigurationBase(options.advancedConfiguration, configuration);
         }
+        // Set read-only mode if specified
+        if (options.readOnly !== undefined) {
+            configuration.readOnly = options.readOnly;
+        }
         return configuration;
     }
     /**
@@ -109,7 +113,7 @@ class GlideClient extends BaseClient_1.BaseClient {
      * **Notes:**
      * - **Atomic Batches - Transactions:** If the transaction fails due to a `WATCH` command, `EXEC` will return `null`.
      *
-     * @see {@link https://github.com/valkey-io/valkey-glide/wiki/NodeJS-wrapper#transaction|Valkey Glide Wiki} for details on Valkey Transactions.
+     * @see {@link https://github.com/valkey-io/valkey-glide/wiki/NodeJS-wrapper#transaction|Valkey GLIDE Documentation} for details on Valkey Transactions.
      *
      * @param batch - A {@link Batch} object containing a list of commands to be executed.
      * @param raiseOnError - Determines how errors are handled within the batch response.
@@ -158,7 +162,7 @@ class GlideClient extends BaseClient_1.BaseClient {
      *
      * Note: An error will occur if the string decoder is used with commands that return only bytes as a response.
      *
-     * @see {@link https://github.com/valkey-io/valkey-glide/wiki/General-Concepts#custom-command|Valkey Glide Wiki} for details on the restrictions and limitations of the custom command API.
+     * @see {@link https://glide.valkey.io/concepts/client-features/custom-commands/|Valkey GLIDE Documentation} for details on the restrictions and limitations of the custom command API.
      *
      * @param args - A list including the command name and arguments for the custom command.
      * @param options - (Optional) See {@link DecoderOption}.
@@ -707,7 +711,7 @@ class GlideClient extends BaseClient_1.BaseClient {
      * Flushes all the previously watched keys for a transaction. Executing a transaction will
      * automatically flush all previously watched keys.
      *
-     * @see {@link https://valkey.io/commands/unwatch/|valkey.io} and {@link https://valkey.io/topics/transactions/#cas|Valkey Glide Wiki} for more details.
+     * @see {@link https://valkey.io/commands/unwatch/|valkey.io} and {@link https://valkey.io/topics/transactions/#cas|Valkey GLIDE Documentation} for more details.
      *
      * @returns A simple `"OK"` response.
      *

package/build-ts/GlideClusterClient.d.ts

@@ -405,7 +405,7 @@ export type SingleNodeRoute =
  * Client used for connection to cluster servers.
  * Use {@link createClient} to request a client.
  *
- * @see For full documentation refer to {@link https://github.com/valkey-io/valkey-glide/wiki/NodeJS-wrapper#cluster | Valkey Glide Wiki}.
+ * @see For full documentation refer to {@link https://glide.valkey.io/how-to/client-initialization/#cluster | Valkey GLIDE Documentation}.
  */
 export declare class GlideClusterClient extends BaseClient {
     /**
@@ -476,7 +476,7 @@ export declare class GlideClusterClient extends BaseClient {
      * Using the same cursor object for multiple iterations may result in unexpected behavior.
      *
      * For more information about the Cluster Scan implementation, see
-     * {@link https://github.com/valkey-io/valkey-glide/wiki/General-Concepts#cluster-scan | Cluster Scan}.
+     * {@link https://glide.valkey.io/concepts/client-features/cluster-scan/ | Cluster Scan}.
      *
      * This method can iterate over all keys in the database from the start of the scan until it ends.
      * The same key may be returned in multiple scan iterations.
@@ -535,7 +535,7 @@ export declare class GlideClusterClient extends BaseClient {
      *
      * Note: An error will occur if the string decoder is used with commands that return only bytes as a response.
      *
-     * @see {@link https://github.com/valkey-io/valkey-glide/wiki/General-Concepts#custom-command|Glide for Valkey Wiki} for details on the restrictions and limitations of the custom command API.
+     * @see {@link https://glide.valkey.io/concepts/client-features/custom-commands/|Glide for Valkey Wiki} for details on the restrictions and limitations of the custom command API.
      *
      * @param args - A list including the command name and arguments for the custom command.
      * @param options - (Optional) See {@link RouteOption} and {@link DecoderOption}
@@ -563,7 +563,7 @@ export declare class GlideClusterClient extends BaseClient {
      *
      * - **Atomic Batches (Transactions):** All key-based commands must map to the same hash slot. If keys span different slots, the transaction will fail. If the transaction fails due to a `WATCH` command, `exec` will return `null`.
      *
-     * @see {@link https://github.com/valkey-io/valkey-glide/wiki/NodeJS-wrapper#transaction|Valkey Glide Wiki} for details on Valkey Transactions.
+     * @see {@link https://github.com/valkey-io/valkey-glide/wiki/NodeJS-wrapper#transaction|Valkey GLIDE Documentation} for details on Valkey Transactions.
      *
      * **Retry and Redirection:**
      *
@@ -1289,7 +1289,7 @@ export declare class GlideClusterClient extends BaseClient {
      *
      * The command will be routed to all primary nodes, unless `route` is provided
      *
-     * @see {@link https://valkey.io/commands/unwatch/|valkey.io} and {@link https://valkey.io/topics/transactions/#cas|Valkey Glide Wiki} for more details.
+     * @see {@link https://valkey.io/commands/unwatch/|valkey.io} and {@link https://valkey.io/topics/transactions/#cas|Valkey GLIDE Documentation} for more details.
      *
      * @param options - (Optional) See {@link RouteOption}.
      * @returns A simple `"OK"` response.

package/build-ts/GlideClusterClient.js

@@ -54,7 +54,7 @@ function convertClusterGlideRecord(res, isRoutedToSingleNodeByDefault, route) {
  * Client used for connection to cluster servers.
  * Use {@link createClient} to request a client.
  *
- * @see For full documentation refer to {@link https://github.com/valkey-io/valkey-glide/wiki/NodeJS-wrapper#cluster | Valkey Glide Wiki}.
+ * @see For full documentation refer to {@link https://glide.valkey.io/how-to/client-initialization/#cluster | Valkey GLIDE Documentation}.
  */
 class GlideClusterClient extends BaseClient_1.BaseClient {
     /**
@@ -220,7 +220,7 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      * Using the same cursor object for multiple iterations may result in unexpected behavior.
      *
      * For more information about the Cluster Scan implementation, see
-     * {@link https://github.com/valkey-io/valkey-glide/wiki/General-Concepts#cluster-scan | Cluster Scan}.
+     * {@link https://glide.valkey.io/concepts/client-features/cluster-scan/ | Cluster Scan}.
      *
      * This method can iterate over all keys in the database from the start of the scan until it ends.
      * The same key may be returned in multiple scan iterations.
@@ -281,7 +281,7 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      *
      * Note: An error will occur if the string decoder is used with commands that return only bytes as a response.
      *
-     * @see {@link https://github.com/valkey-io/valkey-glide/wiki/General-Concepts#custom-command|Glide for Valkey Wiki} for details on the restrictions and limitations of the custom command API.
+     * @see {@link https://glide.valkey.io/concepts/client-features/custom-commands/|Glide for Valkey Wiki} for details on the restrictions and limitations of the custom command API.
      *
      * @param args - A list including the command name and arguments for the custom command.
      * @param options - (Optional) See {@link RouteOption} and {@link DecoderOption}
@@ -312,7 +312,7 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      *
      * - **Atomic Batches (Transactions):** All key-based commands must map to the same hash slot. If keys span different slots, the transaction will fail. If the transaction fails due to a `WATCH` command, `exec` will return `null`.
      *
-     * @see {@link https://github.com/valkey-io/valkey-glide/wiki/NodeJS-wrapper#transaction|Valkey Glide Wiki} for details on Valkey Transactions.
+     * @see {@link https://github.com/valkey-io/valkey-glide/wiki/NodeJS-wrapper#transaction|Valkey GLIDE Documentation} for details on Valkey Transactions.
      *
      * **Retry and Redirection:**
      *
@@ -1111,7 +1111,7 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      *
      * The command will be routed to all primary nodes, unless `route` is provided
      *
-     * @see {@link https://valkey.io/commands/unwatch/|valkey.io} and {@link https://valkey.io/topics/transactions/#cas|Valkey Glide Wiki} for more details.
+     * @see {@link https://valkey.io/commands/unwatch/|valkey.io} and {@link https://valkey.io/topics/transactions/#cas|Valkey GLIDE Documentation} for more details.
      *
      * @param options - (Optional) See {@link RouteOption}.
      * @returns A simple `"OK"` response.

package/build-ts/OpenTelemetry.d.ts

@@ -2,12 +2,66 @@
  * Copyright Valkey GLIDE Project Contributors - SPDX Identifier: Apache-2.0
  */
 import { OpenTelemetryConfig } from ".";
+/**
+ * Extended OpenTelemetry configuration that includes JS-side options
+ * not representable in the native (NAPI) config.
+ *
+ * Pass this to {@link OpenTelemetry.init} instead of the plain `OpenTelemetryConfig`.
+ */
+export interface GlideOpenTelemetryConfig extends OpenTelemetryConfig {
+    /**
+     * Optional callback that returns the active parent span context for each command.
+     *
+     * When a {@link GlideSpanContext} is returned, the GLIDE command span will be created
+     * as a child of that context, enabling end-to-end distributed tracing.
+     *
+     * The callback is invoked synchronously before each sampled command. Keep the
+     * implementation lightweight — avoid I/O, async work, or expensive computation.
+     *
+     * @example
+     * ```typescript
+     * import { trace } from "@opentelemetry/api";
+     *
+     * OpenTelemetry.init({
+     *     traces: { endpoint: "http://localhost:4318/v1/traces" },
+     *     parentSpanContextProvider: () => {
+     *         const span = trace.getActiveSpan();
+     *         if (!span) return undefined;
+     *         const ctx = span.spanContext();
+     *         return {
+     *             traceId: ctx.traceId,
+     *             spanId: ctx.spanId,
+     *             traceFlags: ctx.traceFlags,
+     *             traceState: ctx.traceState?.toString(),
+     *         };
+     *     },
+     * });
+     * ```
+     */
+    parentSpanContextProvider?: () => GlideSpanContext | undefined;
+}
+/**
+ * Represents the trace context of a remote span, used for parent span context propagation.
+ *
+ * When a user's application has an active OTel span (e.g., from an HTTP request handler),
+ * this context allows GLIDE command spans to appear as children of that span in tracing UIs.
+ */
+export interface GlideSpanContext {
+    /** The trace ID as a 32-character lowercase hex string. */
+    traceId: string;
+    /** The span ID as a 16-character lowercase hex string. */
+    spanId: string;
+    /** Trace flags (e.g., 1 for sampled). */
+    traceFlags: number;
+    /** Optional W3C trace state (e.g., "vendorname1=opaqueValue1,vendorname2=opaqueValue2"). */
+    traceState?: string;
+}
 /**
  * ⚠️ OpenTelemetry can only be initialized once per process. Calling `OpenTelemetry.init()` more than once will be ignored.
  * If you need to change configuration, restart the process with new settings.
  * ### OpenTelemetry
  *
- * - **openTelemetryConfig**: Use this object to configure OpenTelemetry exporters and options.
+ * - **openTelemetryConfig**: Use {@link GlideOpenTelemetryConfig} to configure OpenTelemetry exporters and options.
  *   - **traces**: (optional) Configure trace exporting.
  *     - **endpoint**: The collector endpoint for traces. Supported protocols:
  *       - `http://` or `https://` for HTTP/HTTPS
@@ -19,6 +73,7 @@ import { OpenTelemetryConfig } from ".";
  *   - **metrics**: (optional) Configure metrics exporting.
  *     - **endpoint**: The collector endpoint for metrics. Same protocol rules as above.
  *   - **flushIntervalMs**: (optional) Interval in milliseconds for flushing data to the collector. Must be a positive integer. Defaults to 5000ms if not specified.
+ *   - **parentSpanContextProvider**: (optional) Callback returning the active parent span context. See {@link GlideOpenTelemetryConfig.parentSpanContextProvider}.
  *
  * #### File Exporter Details
  * - For `file://` endpoints:
@@ -37,6 +92,9 @@ import { OpenTelemetryConfig } from ".";
 export declare class OpenTelemetry {
     private static _instance;
     private static openTelemetryConfig;
+    private static spanContextFn;
+    private static readonly TRACE_ID_REGEX;
+    private static readonly SPAN_ID_REGEX;
     /**
      * Singleton class for managing OpenTelemetry configuration and operations.
      * This class provides a centralized way to initialize OpenTelemetry and control
@@ -44,23 +102,26 @@ export declare class OpenTelemetry {
      *
      * Example usage:
      * ```typescript
-     * import { OpenTelemetry, OpenTelemetryConfig, OpenTelemetryTracesConfig, OpenTelemetryMetricsConfig } from "@valkey/valkey-glide";
+     * import { OpenTelemetry, GlideOpenTelemetryConfig } from "@valkey/valkey-glide";
+     * import { trace } from "@opentelemetry/api";
      *
-     * let tracesConfig: OpenTelemetryTracesConfig = {
-     *  endpoint: "http://localhost:4318/v1/traces",
-     *  samplePercentage: 10, // Optional, defaults to 1. Can also be changed at runtime via setSamplePercentage().
-     * };
-     * let metricsConfig: OpenTelemetryMetricsConfig = {
-     *  endpoint: "http://localhost:4318/v1/metrics",
-     * };
-
-     * let config : OpenTelemetryConfig = {
-     *  traces: tracesConfig,
-     *  metrics: metricsConfig,
-     *  flushIntervalMs: 1000, // Optional, defaults to 5000
+     * const config: GlideOpenTelemetryConfig = {
+     *     traces: {
+     *         endpoint: "http://localhost:4318/v1/traces",
+     *         samplePercentage: 10,
+     *     },
+     *     metrics: {
+     *         endpoint: "http://localhost:4318/v1/metrics",
+     *     },
+     *     flushIntervalMs: 1000,
+     *     parentSpanContextProvider: () => {
+     *         const span = trace.getActiveSpan();
+     *         if (!span) return undefined;
+     *         const ctx = span.spanContext();
+     *         return { traceId: ctx.traceId, spanId: ctx.spanId, traceFlags: ctx.traceFlags };
+     *     },
      * };
      * OpenTelemetry.init(config);
-     *
      * ```
      *
      * @remarks
@@ -71,7 +132,7 @@ export declare class OpenTelemetry {
      * Initialize the OpenTelemetry instance
      * @param openTelemetryConfig - The OpenTelemetry configuration
      */
-    static init(openTelemetryConfig: OpenTelemetryConfig): void;
+    static init(openTelemetryConfig: GlideOpenTelemetryConfig): void;
     private static internalInit;
     /**
      * Check if the OpenTelemetry instance is initialized
@@ -98,4 +159,31 @@ export declare class OpenTelemetry {
      * This method can be called at runtime to change the sampling percentage without reinitializing OpenTelemetry.
      */
     static setSamplePercentage(percentage: number): void;
+    /**
+     * Register or replace the callback that returns the active parent span context.
+     *
+     * This allows changing the provider at runtime (e.g., switching tracing contexts
+     * in a multi-tenant application). The initial provider can also be set via
+     * {@link GlideOpenTelemetryConfig.parentSpanContextProvider} in `init()`.
+     *
+     * @param fn - A function returning a `GlideSpanContext` or `undefined`, or `null` to clear.
+     *
+     * @example
+     * ```typescript
+     * import { trace } from "@opentelemetry/api";
+     *
+     * OpenTelemetry.setParentSpanContextProvider(() => {
+     *     const span = trace.getActiveSpan();
+     *     if (!span) return undefined;
+     *     const ctx = span.spanContext();
+     *     return {
+     *         traceId: ctx.traceId,
+     *         spanId: ctx.spanId,
+     *         traceFlags: ctx.traceFlags,
+     *         traceState: ctx.traceState?.toString(),
+     *     };
+     * });
+     * ```
+     */
+    static setParentSpanContextProvider(fn: (() => GlideSpanContext | undefined) | null): void;
 }