couchbase 4.7.0 → 4.7.1

package/dist/diagnosticsexecutor.js

@@ -67,13 +67,13 @@ class PingExecutor {
      */
     async ping(options) {
         return new Promise((resolve, reject) => {
-            // BUG(JSCBC-993): timeout is not currently sent to the C++ client
-            void options.timeout;
             this._cluster.conn.ping({
                 report_id: options.reportId,
+                bucket_name: options.bucket,
                 services: options.serviceTypes
                     ? options.serviceTypes.map((svc) => (0, bindingutilities_1.serviceTypeToCpp)(svc))
                     : undefined,
+                timeout: options.timeout,
             }, (cppErr, resp) => {
                 const err = (0, bindingutilities_1.errorFromCpp)(cppErr);
                 if (err || !resp) {

package/dist/diagnosticstypes.d.ts

@@ -280,3 +280,39 @@ export interface DiagnosticsOptions {
      */
     reportId?: string;
 }
+/**
+ * Represents the desired state of a cluster.
+ *
+ * @category Diagnostics
+ */
+export declare enum ClusterState {
+    /**
+     * Indicates that all nodes and their sockets are reachable.
+     */
+    Online = "online",
+    /**
+     * Indicates that at least one socket per service is reachable.
+     */
+    Degraded = "degraded",
+    /**
+     * Indicates that not even one socket per service is reachable.
+     * Invalid as a desired state for waitUntilReady.
+     */
+    Offline = "offline"
+}
+/**
+ * Options for the waitUntilReady operation on a Cluster or Bucket.
+ *
+ * @category Diagnostics
+ */
+export interface WaitUntilReadyOptions {
+    /**
+     * The desired cluster state to wait for.
+     * Defaults to ClusterState.Online.
+     */
+    desiredState?: ClusterState;
+    /**
+     * The set of services to wait on.
+     */
+    serviceTypes?: ServiceType[];
+}

package/dist/diagnosticstypes.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DiagnosticsResult = exports.DiagnosticsEndpoint = exports.PingResult = exports.PingEndpoint = exports.PingState = exports.EndpointState = void 0;
+exports.ClusterState = exports.DiagnosticsResult = exports.DiagnosticsEndpoint = exports.PingResult = exports.PingEndpoint = exports.PingState = exports.EndpointState = void 0;
 /**
  * Represents the status of an an endpoint in a diagnostics report.
  *
@@ -170,3 +170,24 @@ class DiagnosticsResult {
     }
 }
 exports.DiagnosticsResult = DiagnosticsResult;
+/**
+ * Represents the desired state of a cluster.
+ *
+ * @category Diagnostics
+ */
+var ClusterState;
+(function (ClusterState) {
+    /**
+     * Indicates that all nodes and their sockets are reachable.
+     */
+    ClusterState["Online"] = "online";
+    /**
+     * Indicates that at least one socket per service is reachable.
+     */
+    ClusterState["Degraded"] = "degraded";
+    /**
+     * Indicates that not even one socket per service is reachable.
+     * Invalid as a desired state for waitUntilReady.
+     */
+    ClusterState["Offline"] = "offline";
+})(ClusterState || (exports.ClusterState = ClusterState = {}));

package/dist/observability.d.ts

@@ -22,6 +22,10 @@ export declare class NoOpSpan implements RequestSpan {
      * @internal
      */
     end(): void;
+    /**
+     * @internal
+     */
+    isRecording(): boolean;
     /**
      * @internal
      */
@@ -39,7 +43,7 @@ export declare class NoOpTracer implements RequestTracer {
 /**
  * @internal
  */
-export declare function wrapObservableBindingCall<TReq extends CppObservableRequests, TResp extends CppObservableResponse>(fn: ObservableBindingFunc<TReq, TResp>, req: TReq, obsReqHandler: ObservableRequestHandler): Promise<[Error | null, TResp]>;
+export declare function wrapObservableBindingCall<TReq extends CppObservableRequests, TResp extends CppObservableResponse>(fn: ObservableBindingFunc<TReq, TResp>, req: TReq, obsReqHandler: ObservableRequestHandler | null): Promise<[Error | null, TResp]>;
 /**
  * @internal
  */

package/dist/observability.js

@@ -22,6 +22,12 @@ class NoOpSpan {
      * @internal
      */
     end() { }
+    /**
+     * @internal
+     */
+    isRecording() {
+        return false;
+    }
     /**
      * @internal
      */
@@ -47,15 +53,17 @@ exports.NoOpTracer = NoOpTracer;
  */
 async function wrapObservableBindingCall(fn, req, obsReqHandler) {
     return await new Promise((resolve) => {
-        req.wrapper_span_name = obsReqHandler.wrapperSpanName;
+        if (obsReqHandler) {
+            req.wrapper_span_name = obsReqHandler.wrapperSpanName;
+        }
         fn(req, (cppErr, res) => {
             let err = null;
             if (cppErr) {
                 err = (0, bindingutilities_1.errorFromCpp)(cppErr);
-                obsReqHandler.processCoreSpan(cppErr.cpp_core_span);
+                obsReqHandler === null || obsReqHandler === void 0 ? void 0 : obsReqHandler.processCoreSpan(cppErr.cpp_core_span);
             }
             else {
-                obsReqHandler.processCoreSpan(res.cpp_core_span);
+                obsReqHandler === null || obsReqHandler === void 0 ? void 0 : obsReqHandler.processCoreSpan(res.cpp_core_span);
             }
             resolve([err, res]);
         });

package/dist/observabilityhandler.d.ts

@@ -5,6 +5,11 @@ import { ObservabilityInstruments } from './observabilitytypes';
 import { AttributeValue, CppOpAttributeName, OpType, OpAttributeName, SpanStatus, ServiceName } from './observabilitytypes';
 import { HttpOpAttributesOptions } from './observabilityutilities';
 import { RequestSpan, RequestTracer } from './tracing';
+/**
+ * Returns true when both tracer and meter are NoOp, enabling the fast-path bypass in KV ops.
+ * @internal
+ */
+export declare function isNoopObservabilityInstruments(instruments: ObservabilityInstruments): boolean;
 /**
  * @internal
  */
@@ -80,6 +85,7 @@ export declare class WrappedSpan implements RequestSpan {
     private readonly _tracer;
     private readonly _hasMultipleEncodingSpans;
     readonly _requestSpan: RequestSpan;
+    private readonly _isRecording;
     private _parentSpan;
     private _endedEncodingSpans;
     private _encodingSpan;

package/dist/observabilityhandler.js

@@ -1,17 +1,22 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WrappedSpan = exports.ObservableRequestHandler = void 0;
+exports.WrappedSpan = exports.ObservableRequestHandler = exports.isNoopObservabilityInstruments = void 0;
+const binding_1 = __importDefault(require("./binding"));
 const observability_1 = require("./observability");
 const observabilitytypes_1 = require("./observabilitytypes");
 const observabilityutilities_1 = require("./observabilityutilities");
 const observabilityutilities_2 = require("./observabilityutilities");
 const utilities_1 = require("./utilities");
+const _DATASTRUCTURE_OPS = new Set(Object.values(observabilitytypes_1.DatastructureOp));
 /**
  * @internal
  */
 class ObservableRequestHandlerTracerImpl {
-    constructor(opType, observabilityInstruments, parentSpan) {
-        this._startTime = (0, observabilityutilities_1.timeInputToHiResTime)();
+    constructor(opType, observabilityInstruments, parentSpan, startTime) {
+        this._startTime = startTime !== null && startTime !== void 0 ? startTime : (0, observabilityutilities_1.timeInputToHiResTime)();
         this._opType = opType;
         this._serviceName = (0, observabilitytypes_1.serviceNameFromOpType)(opType);
         this._tracer = observabilityInstruments.tracer;
@@ -120,11 +125,23 @@ class ObservableRequestHandlerTracerImpl {
      * @internal
      */
     setRequestKeyValueAttributes(cppDocId, durability) {
-        const opAttrs = (0, observabilityutilities_1.getAttributesForKeyValueOpType)(this._opType, cppDocId, durability);
-        for (const [k, v] of Object.entries(opAttrs)) {
-            this._wrappedSpan.setAttribute(k, v);
+        this._wrappedSpan.setAttribute(observabilitytypes_1.OpAttributeName.SystemName, 'couchbase');
+        this._wrappedSpan.setAttribute(observabilitytypes_1.OpAttributeName.Service, observabilitytypes_1.ServiceName.KeyValue);
+        this._wrappedSpan.setAttribute(observabilitytypes_1.OpAttributeName.OperationName, this._opType);
+        this._wrappedSpan.setAttribute(observabilitytypes_1.OpAttributeName.BucketName, cppDocId.bucket);
+        this._wrappedSpan.setAttribute(observabilitytypes_1.OpAttributeName.ScopeName, cppDocId.scope);
+        this._wrappedSpan.setAttribute(observabilitytypes_1.OpAttributeName.CollectionName, cppDocId.collection);
+        if (durability && durability !== binding_1.default.durability_level.none) {
+            if (durability === binding_1.default.durability_level.majority) {
+                this._wrappedSpan.setAttribute(observabilitytypes_1.OpAttributeName.DurabilityLevel, 'majority');
+            }
+            else if (durability === binding_1.default.durability_level.majority_and_persist_to_active) {
+                this._wrappedSpan.setAttribute(observabilitytypes_1.OpAttributeName.DurabilityLevel, 'majority_and_persist_to_active');
+            }
+            else if (durability === binding_1.default.durability_level.persist_to_majority) {
+                this._wrappedSpan.setAttribute(observabilitytypes_1.OpAttributeName.DurabilityLevel, 'persist_to_majority');
+            }
         }
-        // TODO: meter attrs
     }
 }
 /**
@@ -223,14 +240,14 @@ class ObservableRequestHandlerNoOpMeterImpl {
  * @internal
  */
 class ObservableRequestHandlerMeterImpl {
-    constructor(opType, observabilityInstruments) {
+    constructor(opType, observabilityInstruments, startTime) {
         this._attrs = {};
         this._opType = opType;
         this._serviceName = (0, observabilitytypes_1.serviceNameFromOpType)(opType);
         this._meter = observabilityInstruments.meter;
         this._getClusterLabelsFn = observabilityInstruments.clusterLabelsFn;
-        this._startTime = (0, observabilityutilities_1.timeInputToHiResTime)();
-        this._ignoreTopLevelOp = Object.values(observabilitytypes_1.DatastructureOp).includes(opType);
+        this._startTime = startTime !== null && startTime !== void 0 ? startTime : (0, observabilityutilities_1.timeInputToHiResTime)();
+        this._ignoreTopLevelOp = _DATASTRUCTURE_OPS.has(opType);
     }
     /**
      * @internal
@@ -315,6 +332,17 @@ class ObservableRequestHandlerMeterImpl {
         tags[observabilitytypes_1.OpAttributeName.ErrorType] = errorType;
     }
 }
+const _NOOP_TRACER_IMPL = new ObservableRequestHandlerNoOpTracerImpl('', null);
+const _NOOP_METER_IMPL = new ObservableRequestHandlerNoOpMeterImpl('', null);
+/**
+ * Returns true when both tracer and meter are NoOp, enabling the fast-path bypass in KV ops.
+ * @internal
+ */
+function isNoopObservabilityInstruments(instruments) {
+    return ((!instruments.tracer || instruments.tracer instanceof observability_1.NoOpTracer) &&
+        instruments.meter instanceof observability_1.NoOpMeter);
+}
+exports.isNoopObservabilityInstruments = isNoopObservabilityInstruments;
 /**
  * @internal
  */
@@ -322,18 +350,19 @@ class ObservableRequestHandler {
     constructor(opType, observabilityInstruments, parentSpan) {
         this._opType = opType;
         this._requestHasEnded = false;
+        const startTime = (0, observabilityutilities_1.timeInputToHiResTime)();
         if (!observabilityInstruments.tracer ||
             observabilityInstruments.tracer instanceof observability_1.NoOpTracer) {
-            this._tracerImpl = new ObservableRequestHandlerNoOpTracerImpl(opType, observabilityInstruments, parentSpan);
+            this._tracerImpl = _NOOP_TRACER_IMPL;
         }
         else {
-            this._tracerImpl = new ObservableRequestHandlerTracerImpl(opType, observabilityInstruments, parentSpan);
+            this._tracerImpl = new ObservableRequestHandlerTracerImpl(opType, observabilityInstruments, parentSpan, startTime);
         }
         if (observabilityInstruments.meter instanceof observability_1.NoOpMeter) {
-            this._meterImpl = new ObservableRequestHandlerNoOpMeterImpl(opType, observabilityInstruments);
+            this._meterImpl = _NOOP_METER_IMPL;
         }
         else {
-            this._meterImpl = new ObservableRequestHandlerMeterImpl(opType, observabilityInstruments);
+            this._meterImpl = new ObservableRequestHandlerMeterImpl(opType, observabilityInstruments, startTime);
         }
     }
     /**
@@ -444,6 +473,7 @@ class WrappedEncodingSpan {
  */
 class WrappedSpan {
     constructor(serviceName, opType, tracer, startTime, parentSpan) {
+        var _a, _b, _c;
         this._serviceName = serviceName;
         this._opType = opType;
         this._tracer = tracer;
@@ -454,6 +484,7 @@ class WrappedSpan {
             : this._parentSpan;
         this._hasMultipleEncodingSpans = this._opType == observabilitytypes_1.KeyValueOp.MutateIn;
         this._requestSpan = this._createRequestSpan(this._opType, startTime, pSpan);
+        this._isRecording = (_c = (_b = (_a = this._requestSpan).isRecording) === null || _b === void 0 ? void 0 : _b.call(_a)) !== null && _c !== void 0 ? _c : true;
         this._endedEncodingSpans = false;
         this._startTime = startTime;
         this._endTimeWatermark = (0, observabilityutilities_1.timeInputToHiResTime)();
@@ -660,6 +691,9 @@ class WrappedSpan {
      * @internal
      */
     processCoreSpan(coreSpan) {
+        if (!this._isRecording) {
+            return;
+        }
         this._maybeSetAttributeFromCoreSpan(coreSpan, observabilitytypes_1.CppOpAttributeName.ClusterName);
         this._maybeSetAttributeFromCoreSpan(coreSpan, observabilitytypes_1.CppOpAttributeName.ClusterUUID);
         this._maybeSetAttributeFromCoreSpan(coreSpan, observabilitytypes_1.CppOpAttributeName.RetryCount, true);
@@ -705,6 +739,9 @@ class WrappedSpan {
      * @internal
      */
     setAttribute(key, value) {
+        if (!this._isRecording) {
+            return;
+        }
         if (key === observabilitytypes_1.OpAttributeName.ClusterName) {
             this._clusterName = value;
         }

package/dist/observabilitytypes.js

@@ -263,52 +263,29 @@ var ServiceName;
     ServiceName["Transactions"] = "transactions";
     ServiceName["Views"] = "views";
 })(ServiceName || (exports.ServiceName = ServiceName = {}));
+const _OP_TYPE_TO_SERVICE = new Map([
+    ...Object.values(KeyValueOp).map((v) => [v, ServiceName.KeyValue]),
+    ...Object.values(DatastructureOp).map((v) => [v, ServiceName.KeyValue]),
+    [StreamingOp.Analytics, ServiceName.Analytics],
+    [StreamingOp.Query, ServiceName.Query],
+    [StreamingOp.Search, ServiceName.Search],
+    [StreamingOp.View, ServiceName.Views],
+    ...Object.values(AnalyticsMgmtOp).map((v) => [v, ServiceName.Analytics]),
+    ...Object.values(BucketMgmtOp).map((v) => [v, ServiceName.Management]),
+    ...Object.values(CollectionMgmtOp).map((v) => [v, ServiceName.Management]),
+    ...Object.values(EventingFunctionMgmtOp).map((v) => [v, ServiceName.Eventing]),
+    ...Object.values(QueryIndexMgmtOp).map((v) => [v, ServiceName.Query]),
+    ...Object.values(SearchIndexMgmtOp).map((v) => [v, ServiceName.Search]),
+    ...Object.values(UserMgmtOp).map((v) => [v, ServiceName.Management]),
+    ...Object.values(ViewIndexMgmtOp).map((v) => [v, ServiceName.Views]),
+]);
 /**
  * @internal
  */
 function serviceNameFromOpType(opType) {
-    if (Object.values(KeyValueOp).includes(opType)) {
-        return ServiceName.KeyValue;
-    }
-    else if (Object.values(DatastructureOp).includes(opType)) {
-        return ServiceName.KeyValue;
-    }
-    else if (Object.values(StreamingOp).includes(opType)) {
-        switch (opType) {
-            case StreamingOp.Analytics:
-                return ServiceName.Analytics;
-            case StreamingOp.Query:
-                return ServiceName.Query;
-            case StreamingOp.Search:
-                return ServiceName.Search;
-            case StreamingOp.View:
-                return ServiceName.Views;
-        }
-    }
-    else if (Object.values(AnalyticsMgmtOp).includes(opType)) {
-        return ServiceName.Analytics;
-    }
-    else if (Object.values(BucketMgmtOp).includes(opType)) {
-        return ServiceName.Management;
-    }
-    else if (Object.values(CollectionMgmtOp).includes(opType)) {
-        return ServiceName.Management;
-    }
-    else if (Object.values(EventingFunctionMgmtOp).includes(opType)) {
-        return ServiceName.Eventing;
-    }
-    else if (Object.values(QueryIndexMgmtOp).includes(opType)) {
-        return ServiceName.Query;
-    }
-    else if (Object.values(SearchIndexMgmtOp).includes(opType)) {
-        return ServiceName.Search;
-    }
-    else if (Object.values(UserMgmtOp).includes(opType)) {
-        return ServiceName.Management;
-    }
-    else if (Object.values(ViewIndexMgmtOp).includes(opType)) {
-        return ServiceName.Views;
-    }
+    const svc = _OP_TYPE_TO_SERVICE.get(opType);
+    if (svc !== undefined)
+        return svc;
     throw new Error(`Unknown OpType: ${opType}`);
 }
 exports.serviceNameFromOpType = serviceNameFromOpType;

package/dist/observabilityutilities.js

@@ -120,7 +120,7 @@ exports.timeInputToHiResTime = timeInputToHiResTime;
 function getAttributesForKeyValueOpType(opType, cppDocId, durability) {
     const attributes = {
         [observabilitytypes_1.OpAttributeName.SystemName]: 'couchbase',
-        [observabilitytypes_1.OpAttributeName.Service]: (0, observabilitytypes_1.serviceNameFromOpType)(opType),
+        [observabilitytypes_1.OpAttributeName.Service]: observabilitytypes_1.ServiceName.KeyValue,
         [observabilitytypes_1.OpAttributeName.OperationName]: opType,
         [observabilitytypes_1.OpAttributeName.BucketName]: cppDocId.bucket,
         [observabilitytypes_1.OpAttributeName.ScopeName]: cppDocId.scope,

package/dist/oteltracer.d.ts

@@ -40,6 +40,11 @@ export declare class OTelWrapperSpan implements RequestSpan {
      * @param endTime - Optional timestamp for when the span ended.
      */
     end(endTime?: TimeInput): void;
+    /**
+     * Delegates to the underlying OTel span's isRecording, allowing the SDK
+     * to skip attribute and dispatch span work when the sampler dropped the span.
+     */
+    isRecording(): boolean;
 }
 /**
  * Wrapper class for OpenTelemetry Tracer that implements RequestTracer interface.

package/dist/oteltracer.js

@@ -77,6 +77,13 @@ class OTelWrapperSpan {
     end(endTime) {
         this._otelSpan.end(endTime);
     }
+    /**
+     * Delegates to the underlying OTel span's isRecording, allowing the SDK
+     * to skip attribute and dispatch span work when the sampler dropped the span.
+     */
+    isRecording() {
+        return this._otelSpan.isRecording();
+    }
 }
 exports.OTelWrapperSpan = OTelWrapperSpan;
 /**

package/dist/queryindexmanager.js

@@ -212,6 +212,14 @@ class InternalQueryIndexManager {
         }, callback);
     }
 }
+/**
+ * @internal
+ */
+function _checkCollectionQueryIndexManagerOptions(options) {
+    if (options.collectionName !== undefined || options.scopeName !== undefined) {
+        throw new errors_1.InvalidArgumentError(new Error('collectionName and scopeName are not supported on CollectionQueryIndexManager. Use CollectionQueryIndexManager directly instead.'));
+    }
+}
 /**
  * CollectionQueryIndexManager provides an interface for managing the
  * query indexes on the collection.
@@ -244,6 +252,7 @@ class CollectionQueryIndexManager {
         if (!options) {
             options = {};
         }
+        _checkCollectionQueryIndexManagerOptions(options);
         const obsReqHandler = new observabilityhandler_1.ObservableRequestHandler(observabilitytypes_1.QueryIndexMgmtOp.QueryIndexCreate, this._manager.observabilityInstruments, options === null || options === void 0 ? void 0 : options.parentSpan);
         obsReqHandler.setRequestHttpAttributes();
         try {
@@ -277,6 +286,7 @@ class CollectionQueryIndexManager {
         if (!options) {
             options = {};
         }
+        _checkCollectionQueryIndexManagerOptions(options);
         const obsReqHandler = new observabilityhandler_1.ObservableRequestHandler(observabilitytypes_1.QueryIndexMgmtOp.QueryIndexCreate, this._manager.observabilityInstruments, options === null || options === void 0 ? void 0 : options.parentSpan);
         obsReqHandler.setRequestHttpAttributes();
         try {
@@ -309,6 +319,7 @@ class CollectionQueryIndexManager {
         if (!options) {
             options = {};
         }
+        _checkCollectionQueryIndexManagerOptions(options);
         const obsReqHandler = new observabilityhandler_1.ObservableRequestHandler(observabilitytypes_1.QueryIndexMgmtOp.QueryIndexDrop, this._manager.observabilityInstruments, options === null || options === void 0 ? void 0 : options.parentSpan);
         obsReqHandler.setRequestHttpAttributes();
         try {
@@ -339,6 +350,7 @@ class CollectionQueryIndexManager {
         if (!options) {
             options = {};
         }
+        _checkCollectionQueryIndexManagerOptions(options);
         const obsReqHandler = new observabilityhandler_1.ObservableRequestHandler(observabilitytypes_1.QueryIndexMgmtOp.QueryIndexDrop, this._manager.observabilityInstruments, options === null || options === void 0 ? void 0 : options.parentSpan);
         obsReqHandler.setRequestHttpAttributes();
         try {
@@ -369,6 +381,7 @@ class CollectionQueryIndexManager {
         if (!options) {
             options = {};
         }
+        _checkCollectionQueryIndexManagerOptions(options);
         const obsReqHandler = new observabilityhandler_1.ObservableRequestHandler(observabilitytypes_1.QueryIndexMgmtOp.QueryIndexGetAll, this._manager.observabilityInstruments, options === null || options === void 0 ? void 0 : options.parentSpan);
         obsReqHandler.setRequestHttpAttributes();
         try {
@@ -397,6 +410,7 @@ class CollectionQueryIndexManager {
         if (!options) {
             options = {};
         }
+        _checkCollectionQueryIndexManagerOptions(options);
         const obsReqHandler = new observabilityhandler_1.ObservableRequestHandler(observabilitytypes_1.QueryIndexMgmtOp.QueryIndexBuildDeferred, this._manager.observabilityInstruments, options === null || options === void 0 ? void 0 : options.parentSpan);
         obsReqHandler.setRequestHttpAttributes();
         try {
@@ -427,6 +441,7 @@ class CollectionQueryIndexManager {
         if (!options) {
             options = {};
         }
+        _checkCollectionQueryIndexManagerOptions(options);
         const obsReqHandler = new observabilityhandler_1.ObservableRequestHandler(observabilitytypes_1.QueryIndexMgmtOp.QueryIndexWatchIndexes, this._manager.observabilityInstruments, options === null || options === void 0 ? void 0 : options.parentSpan);
         obsReqHandler.setRequestHttpAttributes();
         try {

package/dist/thresholdlogging.d.ts

@@ -196,6 +196,11 @@ export declare class ThresholdLoggingSpan implements RequestSpan {
      * Adds a timestamped event to the span.
      */
     addEvent(): void;
+    /**
+     * Always returns true — threshold logging spans must record every operation
+     * to evaluate against configured thresholds.
+     */
+    isRecording(): boolean;
     /**
      * Sets the status of the span.
      *

package/dist/thresholdlogging.js

@@ -447,6 +447,13 @@ class ThresholdLoggingSpan {
      * Adds a timestamped event to the span.
      */
     addEvent() { }
+    /**
+     * Always returns true — threshold logging spans must record every operation
+     * to evaluate against configured thresholds.
+     */
+    isRecording() {
+        return true;
+    }
     /**
      * Sets the status of the span.
      *

package/dist/tracing.d.ts

@@ -36,6 +36,12 @@ export interface RequestSpan {
      * @param endTime - Optional end time; defaults to current time if not provided.
      */
     end(endTime?: TimeInput): void;
+    /**
+     * Returns whether this span is actively recording. When false, setAttribute
+     * and processCoreSpan work is skipped. Defaults to true when not implemented,
+     * preserving backward compatibility with existing custom implementations.
+     */
+    isRecording?(): boolean;
 }
 /**
  * Interface for creating and managing distributed tracing spans.

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const SDK_VERSION = "4.7.0";
+export declare const SDK_VERSION = "4.7.1";
 export declare const SDK_NAME = "couchbase";

package/dist/version.js

@@ -3,5 +3,5 @@
 // DO NOT EDIT DIRECTLY.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_NAME = exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = '4.7.0';
+exports.SDK_VERSION = '4.7.1';
 exports.SDK_NAME = 'couchbase';

package/dist/waituntilreadyexecutor.d.ts

@@ -0,0 +1,37 @@
+import { Cluster } from './cluster';
+import { WaitUntilReadyOptions } from './diagnosticstypes';
+/**
+ * @internal
+ */
+export declare class WaitUntilReadyExecutor {
+    private _cluster;
+    private _bucketName;
+    private _diagExec;
+    private _pingExec;
+    /**
+     * @internal
+     */
+    constructor(cluster: Cluster, bucketName?: string);
+    /**
+     * Checks whether the endpoints for a single service satisfy the desired cluster state.
+     *
+     * @internal
+     */
+    private _meetsDesiredState;
+    /**
+     * Logs any ping endpoints that reported an error, at warn level.
+     *
+     * @internal
+     */
+    private _logPingErrors;
+    /**
+     * Builds the set of services to wait on, either from the user provided list or via discovery ping.
+     *
+     * @internal
+     */
+    private _resolveWaitSet;
+    /**
+     * @internal
+     */
+    waitUntilReady(timeout: number, options: WaitUntilReadyOptions): Promise<void>;
+}