@valkey/valkey-glide 1.3.5-rc11 → 1.3.5-rc13

package/build-ts/GlideClusterClient.js

@@ -4,10 +4,8 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GlideClusterClient = exports.GlideClusterClientConfiguration = void 0;
-const native_1 = require("../build-ts/native");
+const _1 = require(".");
 const ProtobufMessage_1 = require("../build-ts/ProtobufMessage");
-const BaseClient_1 = require("./BaseClient");
-const Commands_1 = require("./Commands");
 /* eslint-disable-next-line @typescript-eslint/no-namespace */
 var GlideClusterClientConfiguration;
 (function (GlideClusterClientConfiguration) {
@@ -48,7 +46,7 @@ function convertClusterGlideRecord(res, isRoutedToSingleNodeByDefault, route) {
         (Boolean(route) && route !== "allPrimaries" && route !== "allNodes");
     return isSingleNodeResponse
         ? res
-        : (0, BaseClient_1.convertGlideRecordToRecord)(res);
+        : (0, _1.convertGlideRecordToRecord)(res);
 }
 /**
  * Client used for connection to cluster servers.
@@ -56,7 +54,7 @@ function convertClusterGlideRecord(res, isRoutedToSingleNodeByDefault, route) {
  *
  * @see For full documentation refer to {@link https://github.com/valkey-io/valkey-glide/wiki/NodeJS-wrapper#cluster | Valkey Glide Wiki}.
  */
-class GlideClusterClient extends BaseClient_1.BaseClient {
+class GlideClusterClient extends _1.BaseClient {
     /**
      * @internal
      */
@@ -175,7 +173,7 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
                 (resolveAns) => {
                     try {
                         resolve([
-                            new native_1.ClusterScanCursor(resolveAns[0].toString()),
+                            new _1.ClusterScanCursor(resolveAns[0].toString()),
                             resolveAns[1],
                         ]);
                     }
@@ -277,7 +275,7 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      * ```
      */
     async customCommand(args, options) {
-        const command = (0, Commands_1.createCustomCommand)(args);
+        const command = (0, _1.createCustomCommand)(args);
         return super.createWritePromise(command, options);
     }
     /**
@@ -374,7 +372,7 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      * ```
      */
     async ping(options) {
-        return this.createWritePromise((0, Commands_1.createPing)(options?.message), options);
+        return this.createWritePromise((0, _1.createPing)(options?.message), options);
     }
     /**
      * Gets information and statistics about the server.
@@ -401,7 +399,7 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      * ```
      */
     async info(options) {
-        return this.createWritePromise((0, Commands_1.createInfo)(options?.sections), { decoder: BaseClient_1.Decoder.String, ...options }).then((res) => convertClusterGlideRecord(res, false, options?.route));
+        return this.createWritePromise((0, _1.createInfo)(options?.sections), { decoder: _1.Decoder.String, ...options }).then((res) => convertClusterGlideRecord(res, false, options?.route));
     }
     /**
      * Gets the name of the connection to which the request is routed.
@@ -431,7 +429,7 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      * ```
      */
     async clientGetName(options) {
-        return this.createWritePromise((0, Commands_1.createClientGetName)(), options).then((res) => convertClusterGlideRecord(res, true, options?.route));
+        return this.createWritePromise((0, _1.createClientGetName)(), options).then((res) => convertClusterGlideRecord(res, true, options?.route));
     }
     /**
      * Rewrites the configuration file with the current configuration.
@@ -451,8 +449,8 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      * ```
      */
     async configRewrite(options) {
-        return this.createWritePromise((0, Commands_1.createConfigRewrite)(), {
-            decoder: BaseClient_1.Decoder.String,
+        return this.createWritePromise((0, _1.createConfigRewrite)(), {
+            decoder: _1.Decoder.String,
             ...options,
         });
     }
@@ -474,8 +472,8 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      * ```
      */
     async configResetStat(options) {
-        return this.createWritePromise((0, Commands_1.createConfigResetStat)(), {
-            decoder: BaseClient_1.Decoder.String,
+        return this.createWritePromise((0, _1.createConfigResetStat)(), {
+            decoder: _1.Decoder.String,
             ...options,
         });
     }
@@ -497,7 +495,7 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      * ```
      */
     async clientId(options) {
-        return this.createWritePromise((0, Commands_1.createClientId)(), options).then((res) => convertClusterGlideRecord(res, true, options?.route));
+        return this.createWritePromise((0, _1.createClientId)(), options).then((res) => convertClusterGlideRecord(res, true, options?.route));
     }
     /**
      * Reads the configuration parameters of the running server.
@@ -528,7 +526,7 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      * ```
      */
     async configGet(parameters, options) {
-        return this.createWritePromise((0, Commands_1.createConfigGet)(parameters), options).then((res) => (0, BaseClient_1.convertGlideRecordToRecord)(res));
+        return this.createWritePromise((0, _1.createConfigGet)(parameters), options).then((res) => (0, _1.convertGlideRecordToRecord)(res));
     }
     /**
      * Sets configuration parameters to the specified values.
@@ -550,8 +548,8 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      * ```
      */
     async configSet(parameters, options) {
-        return this.createWritePromise((0, Commands_1.createConfigSet)(parameters), {
-            decoder: BaseClient_1.Decoder.String,
+        return this.createWritePromise((0, _1.createConfigSet)(parameters), {
+            decoder: _1.Decoder.String,
             ...options,
         });
     }
@@ -581,7 +579,7 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      * ```
      */
     async echo(message, options) {
-        return this.createWritePromise((0, Commands_1.createEcho)(message), options).then((res) => convertClusterGlideRecord(res, true, options?.route));
+        return this.createWritePromise((0, _1.createEcho)(message), options).then((res) => convertClusterGlideRecord(res, true, options?.route));
     }
     /**
      * Returns the server time.
@@ -614,7 +612,7 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      * ```
      */
     async time(options) {
-        return this.createWritePromise((0, Commands_1.createTime)(), options).then((res) => convertClusterGlideRecord(res, true, options?.route));
+        return this.createWritePromise((0, _1.createTime)(), options).then((res) => convertClusterGlideRecord(res, true, options?.route));
     }
     /**
      * Copies the value stored at the `source` to the `destination` key. When `replace` is `true`,
@@ -638,7 +636,7 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      * ```
      */
     async copy(source, destination, options) {
-        return this.createWritePromise((0, Commands_1.createCopy)(source, destination, options));
+        return this.createWritePromise((0, _1.createCopy)(source, destination, options));
     }
     /**
      * Displays a piece of generative computer art and the server version.
@@ -657,7 +655,7 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      * ```
      */
     async lolwut(options) {
-        return this.createWritePromise((0, Commands_1.createLolwut)(options), options).then((res) => convertClusterGlideRecord(res, true, options?.route));
+        return this.createWritePromise((0, _1.createLolwut)(options), options).then((res) => convertClusterGlideRecord(res, true, options?.route));
     }
     /**
      * Invokes a previously loaded function.
@@ -679,7 +677,7 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      * ```
      */
     async fcallWithRoute(func, args, options) {
-        return this.createWritePromise((0, Commands_1.createFCall)(func, [], args), options).then((res) => convertClusterGlideRecord(res, true, options?.route));
+        return this.createWritePromise((0, _1.createFCall)(func, [], args), options).then((res) => convertClusterGlideRecord(res, true, options?.route));
     }
     /**
      * Invokes a previously loaded read-only function.
@@ -702,7 +700,7 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      * ```
      */
     async fcallReadonlyWithRoute(func, args, options) {
-        return this.createWritePromise((0, Commands_1.createFCallReadOnly)(func, [], args), options).then((res) => convertClusterGlideRecord(res, true, options?.route));
+        return this.createWritePromise((0, _1.createFCallReadOnly)(func, [], args), options).then((res) => convertClusterGlideRecord(res, true, options?.route));
     }
     /**
      * Deletes a library and all its functions.
@@ -722,8 +720,8 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      * ```
      */
     async functionDelete(libraryCode, options) {
-        return this.createWritePromise((0, Commands_1.createFunctionDelete)(libraryCode), {
-            decoder: BaseClient_1.Decoder.String,
+        return this.createWritePromise((0, _1.createFunctionDelete)(libraryCode), {
+            decoder: _1.Decoder.String,
             ...options,
         });
     }
@@ -749,7 +747,7 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      * ```
      */
     async functionLoad(libraryCode, options) {
-        return this.createWritePromise((0, Commands_1.createFunctionLoad)(libraryCode, options?.replace), options);
+        return this.createWritePromise((0, _1.createFunctionLoad)(libraryCode, options?.replace), options);
     }
     /**
      * Deletes all function libraries.
@@ -769,8 +767,8 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      * ```
      */
     async functionFlush(options) {
-        return this.createWritePromise((0, Commands_1.createFunctionFlush)(options?.mode), {
-            decoder: BaseClient_1.Decoder.String,
+        return this.createWritePromise((0, _1.createFunctionFlush)(options?.mode), {
+            decoder: _1.Decoder.String,
             ...options,
         });
     }
@@ -805,13 +803,13 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      * ```
      */
     async functionList(options) {
-        return this.createWritePromise((0, Commands_1.createFunctionList)(options), options).then((res) => res.length == 0
+        return this.createWritePromise((0, _1.createFunctionList)(options), options).then((res) => res.length == 0
             ? res // no libs
             : (Array.isArray(res[0])
                 ? // single node response
-                    res.map(BaseClient_1.convertGlideRecordToRecord)
+                    res.map(_1.convertGlideRecordToRecord)
                 : // multi node response
-                    (0, BaseClient_1.convertGlideRecordToRecord)(res)));
+                    (0, _1.convertGlideRecordToRecord)(res)));
     }
     /**
      * Returns information about the function that's currently running and information about the
@@ -863,7 +861,7 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      * ```
      */
     async functionStats(options) {
-        return this.createWritePromise((0, Commands_1.createFunctionStats)(), options).then((res) => (0, BaseClient_1.convertGlideRecordToRecord)(res));
+        return this.createWritePromise((0, _1.createFunctionStats)(), options).then((res) => (0, _1.convertGlideRecordToRecord)(res));
     }
     /**
      * Kills a function that is currently executing.
@@ -881,8 +879,8 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      * ```
      */
     async functionKill(options) {
-        return this.createWritePromise((0, Commands_1.createFunctionKill)(), {
-            decoder: BaseClient_1.Decoder.String,
+        return this.createWritePromise((0, _1.createFunctionKill)(), {
+            decoder: _1.Decoder.String,
             ...options,
         });
     }
@@ -902,7 +900,7 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      * ```
      */
     async functionDump(options) {
-        return this.createWritePromise((0, Commands_1.createFunctionDump)(), { decoder: BaseClient_1.Decoder.Bytes, ...options }).then((res) => convertClusterGlideRecord(res, true, options?.route));
+        return this.createWritePromise((0, _1.createFunctionDump)(), { decoder: _1.Decoder.Bytes, ...options }).then((res) => convertClusterGlideRecord(res, true, options?.route));
     }
     /**
      * Restores libraries from the serialized payload returned by {@link functionDump}.
@@ -923,7 +921,7 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      * ```
      */
     async functionRestore(payload, options) {
-        return this.createWritePromise((0, Commands_1.createFunctionRestore)(payload, options?.policy), { decoder: BaseClient_1.Decoder.String, ...options });
+        return this.createWritePromise((0, _1.createFunctionRestore)(payload, options?.policy), { decoder: _1.Decoder.String, ...options });
     }
     /**
      * Deletes all the keys of all the existing databases. This command never fails.
@@ -944,8 +942,8 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      * ```
      */
     async flushall(options) {
-        return this.createWritePromise((0, Commands_1.createFlushAll)(options?.mode), {
-            decoder: BaseClient_1.Decoder.String,
+        return this.createWritePromise((0, _1.createFlushAll)(options?.mode), {
+            decoder: _1.Decoder.String,
             ...options,
         });
     }
@@ -968,8 +966,8 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      * ```
      */
     async flushdb(options) {
-        return this.createWritePromise((0, Commands_1.createFlushDB)(options?.mode), {
-            decoder: BaseClient_1.Decoder.String,
+        return this.createWritePromise((0, _1.createFlushDB)(options?.mode), {
+            decoder: _1.Decoder.String,
             ...options,
         });
     }
@@ -991,7 +989,7 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      * ```
      */
     async dbsize(options) {
-        return this.createWritePromise((0, Commands_1.createDBSize)(), options);
+        return this.createWritePromise((0, _1.createDBSize)(), options);
     }
     /** Publish a message on pubsub channel.
      * This command aggregates PUBLISH and SPUBLISH commands functionalities.
@@ -1020,7 +1018,7 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      * ```
      */
     async publish(message, channel, sharded = false) {
-        return this.createWritePromise((0, Commands_1.createPublish)(message, channel, sharded));
+        return this.createWritePromise((0, _1.createPublish)(message, channel, sharded));
     }
     /**
      * Lists the currently active shard channels.
@@ -1045,7 +1043,7 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      * ```
      */
     async pubsubShardChannels(options) {
-        return this.createWritePromise((0, Commands_1.createPubsubShardChannels)(options?.pattern), options);
+        return this.createWritePromise((0, _1.createPubsubShardChannels)(options?.pattern), options);
     }
     /**
      * Returns the number of subscribers (exclusive of clients subscribed to patterns) for the specified shard channels.
@@ -1068,7 +1066,7 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      * ```
      */
     async pubsubShardNumSub(channels, options) {
-        return this.createWritePromise((0, Commands_1.createPubSubShardNumSub)(channels), options).then((res) => res.map((r) => {
+        return this.createWritePromise((0, _1.createPubSubShardNumSub)(channels), options).then((res) => res.map((r) => {
             return { channel: r.key, numSub: r.value };
         }));
     }
@@ -1090,7 +1088,7 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      * ```
      */
     async lastsave(options) {
-        return this.createWritePromise((0, Commands_1.createLastSave)(), options).then((res) => convertClusterGlideRecord(res, true, options?.route));
+        return this.createWritePromise((0, _1.createLastSave)(), options).then((res) => convertClusterGlideRecord(res, true, options?.route));
     }
     /**
      * Returns a random existing key name.
@@ -1109,7 +1107,7 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      * ```
      */
     async randomKey(options) {
-        return this.createWritePromise((0, Commands_1.createRandomKey)(), options);
+        return this.createWritePromise((0, _1.createRandomKey)(), options);
     }
     /**
      * Flushes all the previously watched keys for a transaction. Executing a transaction will
@@ -1131,8 +1129,8 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      * ```
      */
     async unwatch(options) {
-        return this.createWritePromise((0, Commands_1.createUnWatch)(), {
-            decoder: BaseClient_1.Decoder.String,
+        return this.createWritePromise((0, _1.createUnWatch)(), {
+            decoder: _1.Decoder.String,
             ...options,
         });
     }
@@ -1202,7 +1200,7 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      * ```
      */
     async scriptExists(sha1s, options) {
-        return this.createWritePromise((0, Commands_1.createScriptExists)(sha1s), options);
+        return this.createWritePromise((0, _1.createScriptExists)(sha1s), options);
     }
     /**
      * Flushes the Lua scripts cache.
@@ -1221,8 +1219,8 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      * ```
      */
     async scriptFlush(options) {
-        return this.createWritePromise((0, Commands_1.createScriptFlush)(options?.mode), {
-            decoder: BaseClient_1.Decoder.String,
+        return this.createWritePromise((0, _1.createScriptFlush)(options?.mode), {
+            decoder: _1.Decoder.String,
             ...options,
         });
     }
@@ -1242,8 +1240,8 @@ class GlideClusterClient extends BaseClient_1.BaseClient {
      * ```
      */
     async scriptKill(options) {
-        return this.createWritePromise((0, Commands_1.createScriptKill)(), {
-            decoder: BaseClient_1.Decoder.String,
+        return this.createWritePromise((0, _1.createScriptKill)(), {
+            decoder: _1.Decoder.String,
             ...options,
         });
     }

package/build-ts/Logger.js

@@ -4,7 +4,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Logger = void 0;
-const native_1 = require("../build-ts/native");
+const _1 = require(".");
 const LEVEL = new Map([
     ["error", 0 /* Level.Error */],
     ["warn", 1 /* Level.Warn */],
@@ -24,7 +24,7 @@ const LEVEL = new Map([
  */
 class Logger {
     constructor(level, fileName) {
-        Logger.logger_level = (0, native_1.InitInternalLogger)(LEVEL.get(level), fileName);
+        Logger.logger_level = (0, _1.InitInternalLogger)(LEVEL.get(level), fileName);
     }
     /**
      * Logs the provided message if the provided log level is lower then the logger level.
@@ -44,7 +44,7 @@ class Logger {
         const level = LEVEL.get(logLevel) || 0;
         if (!(level <= Logger.logger_level))
             return;
-        (0, native_1.log)(level, logIdentifier, message);
+        (0, _1.log)(level, logIdentifier, message);
     }
     /**
      * Initialize a logger if it wasn't initialized before - this method is meant to be used when there is no intention to

package/build-ts/OpenTelemetry.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Copyright Valkey GLIDE Project Contributors - SPDX Identifier: Apache-2.0
+ *
+ * ⚠️ 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.
+ *   - **traces**: (optional) Configure trace exporting.
+ *     - **endpoint**: The collector endpoint for traces. Supported protocols:
+ *       - `http://` or `https://` for HTTP/HTTPS
+ *       - `grpc://` for gRPC
+ *       - `file://` for local file export (see below)
+ *     - **samplePercentage**: (optional) The percentage of requests to sample and create a span for, used to measure command duration. Must be between 0 and 100. Defaults to 1 if not specified.
+ *       Note: There is a tradeoff between sampling percentage and performance. Higher sampling percentages will provide more detailed telemetry data but will impact performance.
+ *       It is recommended to keep this number low (1-5%) in production environments unless you have specific needs for higher sampling rates.
+ *   - **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.
+ *
+ * #### File Exporter Details
+ * - For `file://` endpoints:
+ *   - The path must start with `file://` (e.g., `file:///tmp/otel` or `file:///tmp/otel/traces.json`).
+ *   - If the path is a directory or lacks a file extension, data is written to `signals.json` in that directory.
+ *   - If the path includes a filename with an extension, that file is used as-is.
+ *   - The parent directory must already exist; otherwise, initialization will fail with an InvalidInput error.
+ *   - If the target file exists, new data is appended (not overwritten).
+ *
+ * #### Validation Rules
+ * - `flushIntervalMs` must be a positive integer.
+ * - `samplePercentage` must be between 0 and 100.
+ * - File exporter paths must start with `file://` and have an existing parent directory.
+ * - Invalid configuration will throw an error synchronously when calling `OpenTelemetry.init()`.
+ */
+import { OpenTelemetryConfig } from ".";
+export declare class OpenTelemetry {
+    private static _instance;
+    private static openTelemetryConfig;
+    /**
+     * Example usage:
+     * ```typescript
+     * import { OpenTelemetry } from "@valkey/glide";
+     *
+     * OpenTelemetry.init({
+     *   traces: {
+     *     endpoint: "http://localhost:4318/v1/traces",
+     *     samplePercentage: 10, // Optional, defaults to 1. Can also be changed at runtime via setSamplePercentage().
+     *   },
+     *   metrics: {
+     *     endpoint: "http://localhost:4318/v1/metrics",
+     *   },
+     *   flushIntervalMs: 5000, // Optional, defaults to 5000
+     * });
+     * ```
+     *
+     * Initialize the OpenTelemetry instance
+     * @param openTelemetryConfig - The OpenTelemetry configuration
+     */
+    static init(openTelemetryConfig: OpenTelemetryConfig): void;
+    private static internalInit;
+    /**
+     * Check if the OpenTelemetry instance is initialized
+     * @returns True if the OpenTelemetry instance is initialized, false otherwise
+     */
+    static isInitialized(): boolean;
+    /**
+     * Get the sample percentage for traces
+     * @returns The sample percentage for traces only if OpenTelemetry is initialized and the traces config is set, otherwise undefined.
+     */
+    static getSamplePercentage(): number | undefined;
+    /**
+     * Determines if the current request should be sampled for OpenTelemetry tracing.
+     * Uses the configured sample percentage to randomly decide whether to create a span for this request.
+     * @returns true if the request should be sampled, false otherwise
+     */
+    static shouldSample(): boolean;
+    /**
+     * Set the percentage of requests to be sampled and traced. Must be a value between 0 and 100.
+     * This setting only affects traces, not metrics.
+     * @param percentage - The sample percentage 0-100
+     * @throws Error if OpenTelemetry is not initialized or traces config is not set
+     * @remarks
+     * This method can be called at runtime to change the sampling percentage without reinitializing OpenTelemetry.
+     */
+    static setSamplePercentage(percentage: number): void;
+}

package/build-ts/OpenTelemetry.js

@@ -0,0 +1,117 @@
+"use strict";
+/**
+ * Copyright Valkey GLIDE Project Contributors - SPDX Identifier: Apache-2.0
+ *
+ * ⚠️ 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.
+ *   - **traces**: (optional) Configure trace exporting.
+ *     - **endpoint**: The collector endpoint for traces. Supported protocols:
+ *       - `http://` or `https://` for HTTP/HTTPS
+ *       - `grpc://` for gRPC
+ *       - `file://` for local file export (see below)
+ *     - **samplePercentage**: (optional) The percentage of requests to sample and create a span for, used to measure command duration. Must be between 0 and 100. Defaults to 1 if not specified.
+ *       Note: There is a tradeoff between sampling percentage and performance. Higher sampling percentages will provide more detailed telemetry data but will impact performance.
+ *       It is recommended to keep this number low (1-5%) in production environments unless you have specific needs for higher sampling rates.
+ *   - **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.
+ *
+ * #### File Exporter Details
+ * - For `file://` endpoints:
+ *   - The path must start with `file://` (e.g., `file:///tmp/otel` or `file:///tmp/otel/traces.json`).
+ *   - If the path is a directory or lacks a file extension, data is written to `signals.json` in that directory.
+ *   - If the path includes a filename with an extension, that file is used as-is.
+ *   - The parent directory must already exist; otherwise, initialization will fail with an InvalidInput error.
+ *   - If the target file exists, new data is appended (not overwritten).
+ *
+ * #### Validation Rules
+ * - `flushIntervalMs` must be a positive integer.
+ * - `samplePercentage` must be between 0 and 100.
+ * - File exporter paths must start with `file://` and have an existing parent directory.
+ * - Invalid configuration will throw an error synchronously when calling `OpenTelemetry.init()`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenTelemetry = void 0;
+const _1 = require(".");
+class OpenTelemetry {
+    /**
+     * Example usage:
+     * ```typescript
+     * import { OpenTelemetry } from "@valkey/glide";
+     *
+     * OpenTelemetry.init({
+     *   traces: {
+     *     endpoint: "http://localhost:4318/v1/traces",
+     *     samplePercentage: 10, // Optional, defaults to 1. Can also be changed at runtime via setSamplePercentage().
+     *   },
+     *   metrics: {
+     *     endpoint: "http://localhost:4318/v1/metrics",
+     *   },
+     *   flushIntervalMs: 5000, // Optional, defaults to 5000
+     * });
+     * ```
+     *
+     * Initialize the OpenTelemetry instance
+     * @param openTelemetryConfig - The OpenTelemetry configuration
+     */
+    static init(openTelemetryConfig) {
+        if (!this._instance) {
+            this.internalInit(openTelemetryConfig);
+            _1.Logger.log("info", "GlideOpenTelemetry", "OpenTelemetry initialized with config: " +
+                JSON.stringify(openTelemetryConfig));
+            return;
+        }
+        _1.Logger.log("warn", "GlideOpenTelemetry", "OpenTelemetry already initialized");
+    }
+    static internalInit(openTelemetryConfig) {
+        this.openTelemetryConfig = openTelemetryConfig;
+        (0, _1.InitOpenTelemetry)(openTelemetryConfig);
+        this._instance = new OpenTelemetry();
+    }
+    /**
+     * Check if the OpenTelemetry instance is initialized
+     * @returns True if the OpenTelemetry instance is initialized, false otherwise
+     */
+    static isInitialized() {
+        return this._instance != null;
+    }
+    /**
+     * Get the sample percentage for traces
+     * @returns The sample percentage for traces only if OpenTelemetry is initialized and the traces config is set, otherwise undefined.
+     */
+    static getSamplePercentage() {
+        return this.openTelemetryConfig?.traces?.samplePercentage;
+    }
+    /**
+     * Determines if the current request should be sampled for OpenTelemetry tracing.
+     * Uses the configured sample percentage to randomly decide whether to create a span for this request.
+     * @returns true if the request should be sampled, false otherwise
+     */
+    static shouldSample() {
+        const percentage = this.getSamplePercentage();
+        return (this.isInitialized() &&
+            percentage !== undefined &&
+            Math.random() * 100 < percentage);
+    }
+    /**
+     * Set the percentage of requests to be sampled and traced. Must be a value between 0 and 100.
+     * This setting only affects traces, not metrics.
+     * @param percentage - The sample percentage 0-100
+     * @throws Error if OpenTelemetry is not initialized or traces config is not set
+     * @remarks
+     * This method can be called at runtime to change the sampling percentage without reinitializing OpenTelemetry.
+     */
+    static setSamplePercentage(percentage) {
+        if (!this.openTelemetryConfig || !this.openTelemetryConfig.traces) {
+            throw new _1.ConfigurationError("OpenTelemetry config traces not initialized");
+        }
+        this.openTelemetryConfig.traces.samplePercentage = percentage;
+    }
+}
+exports.OpenTelemetry = OpenTelemetry;
+OpenTelemetry._instance = null;
+OpenTelemetry.openTelemetryConfig = null;