couchbase 4.6.0 → 4.7.0-dev.1

package/dist/errors.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DocumentNotJsonError = exports.ValueInvalidError = exports.ValueTooDeepError = exports.PathTooDeepError = exports.PathTooBigError = exports.PathInvalidError = exports.PathMismatchError = exports.PathNotFoundError = exports.MutationLostError = exports.DurableWriteReCommitInProgressError = exports.DurableWriteInProgressError = exports.DurabilityAmbiguousError = exports.DurabilityImpossibleError = exports.DurabilityLevelNotAvailableError = exports.ValueNotJsonError = exports.DocumentExistsError = exports.ValueTooLargeError = exports.DocumentNotLockedError = exports.DocumentLockedError = exports.DocumentUnretrievableError = exports.DocumentNotFoundError = exports.IndexExistsError = exports.QuotaLimitedError = exports.RateLimitedError = exports.IndexNotFoundError = exports.ScopeNotFoundError = exports.FeatureNotAvailableError = exports.UnambiguousTimeoutError = exports.AmbiguousTimeoutError = exports.UnsupportedOperationError = exports.DecodingFailureError = exports.EncodingFailureError = exports.CollectionNotFoundError = exports.BucketNotFoundError = exports.CasMismatchError = exports.ParsingFailureError = exports.TemporaryFailureError = exports.AuthenticationFailureError = exports.InternalServerFailureError = exports.ServiceNotAvailableError = exports.InvalidArgumentError = exports.RequestCanceledError = exports.TimeoutError = exports.InvalidDurabilityReplicateToLevel = exports.InvalidDurabilityPersistToLevel = exports.InvalidDurabilityLevel = exports.NeedOpenBucketError = exports.ClusterClosedError = exports.ConnectionClosedError = exports.CouchbaseError = void 0;
-exports.TransactionCommitAmbiguousError = exports.TransactionExpiredError = exports.TransactionFailedError = exports.TransactionOperationFailedError = exports.EventingFunctionPausedError = exports.EventingFunctionDeployedError = exports.EventingFunctionNotBootstrappedError = exports.EventingFunctionIdenticalKeyspaceError = exports.EventingFunctionCompilationFailureError = exports.EventingFunctionNotDeployedError = exports.EventingFunctionNotFoundError = exports.BucketNotFlushableError = exports.UserExistsError = exports.BucketExistsError = exports.GroupNotFoundError = exports.UserNotFoundError = exports.ScopeExistsError = exports.CollectionExistsError = exports.DesignDocumentNotFoundError = exports.ViewNotFoundError = exports.LinkExistsError = exports.LinkNotFoundError = exports.DataverseExistsError = exports.DatasetExistsError = exports.DataverseNotFoundError = exports.DatasetNotFoundError = exports.JobQueueFullError = exports.CompilationFailureError = exports.IndexNotReadyError = exports.DmlFailureError = exports.PreparedStatementFailureError = exports.IndexFailureError = exports.PlanningFailureError = exports.PathExistsError = exports.DeltaInvalidError = exports.NumberTooBigError = void 0;
+exports.MeterError = exports.TransactionCommitAmbiguousError = exports.TransactionExpiredError = exports.TransactionFailedError = exports.TransactionOperationFailedError = exports.EventingFunctionPausedError = exports.EventingFunctionDeployedError = exports.EventingFunctionNotBootstrappedError = exports.EventingFunctionIdenticalKeyspaceError = exports.EventingFunctionCompilationFailureError = exports.EventingFunctionNotDeployedError = exports.EventingFunctionNotFoundError = exports.BucketNotFlushableError = exports.UserExistsError = exports.BucketExistsError = exports.GroupNotFoundError = exports.UserNotFoundError = exports.ScopeExistsError = exports.CollectionExistsError = exports.DesignDocumentNotFoundError = exports.ViewNotFoundError = exports.LinkExistsError = exports.LinkNotFoundError = exports.DataverseExistsError = exports.DatasetExistsError = exports.DataverseNotFoundError = exports.DatasetNotFoundError = exports.JobQueueFullError = exports.CompilationFailureError = exports.IndexNotReadyError = exports.DmlFailureError = exports.PreparedStatementFailureError = exports.IndexFailureError = exports.PlanningFailureError = exports.PathExistsError = exports.DeltaInvalidError = exports.NumberTooBigError = void 0;
 require("./errorcontexts");
 /**
  * A generic base error that all errors inherit.  Exposes the cause and
@@ -1002,3 +1002,14 @@ class TransactionCommitAmbiguousError extends CouchbaseError {
     }
 }
 exports.TransactionCommitAmbiguousError = TransactionCommitAmbiguousError;
+/**
+ * Indicates an error occurred during a observability metric operation.
+ *
+ * @category Error Handling
+ */
+class MeterError extends CouchbaseError {
+    constructor(cause) {
+        super('An error occurred during a metrics operation', cause);
+    }
+}
+exports.MeterError = MeterError;

package/dist/eventingfunctionmanager.d.ts

@@ -2,6 +2,8 @@ import { Cluster } from './cluster';
 import { QueryScanConsistency } from './querytypes';
 import { NodeCallback } from './utilities';
 import { CppManagementEventingFunction, CppManagementEventingFunctionBucketBinding, CppManagementEventingFunctionConstantBinding, CppManagementEventingFunctionSettings, CppManagementEventingFunctionUrlBinding, CppManagementEventingStatus, CppManagementEventingFunctionState } from './binding';
+import { ObservabilityInstruments } from './observabilitytypes';
+import { RequestSpan } from './tracing';
 /**
  * Represents the various dcp boundary options for eventing functions.
  *
@@ -613,6 +615,10 @@ export interface UpsertFunctionOptions {
      * The timeout for this operation, represented in milliseconds.
      */
     timeout?: number;
+    /**
+     * Specifies the parent span for this specific operation.
+     */
+    parentSpan?: RequestSpan;
 }
 /**
  * @category Management
@@ -622,6 +628,10 @@ export interface DropFunctionOptions {
      * The timeout for this operation, represented in milliseconds.
      */
     timeout?: number;
+    /**
+     * Specifies the parent span for this specific operation.
+     */
+    parentSpan?: RequestSpan;
 }
 /**
  * @category Management
@@ -631,6 +641,10 @@ export interface GetAllFunctionsOptions {
      * The timeout for this operation, represented in milliseconds.
      */
     timeout?: number;
+    /**
+     * Specifies the parent span for this specific operation.
+     */
+    parentSpan?: RequestSpan;
 }
 /**
  * @category Management
@@ -640,6 +654,10 @@ export interface GetFunctionOptions {
      * The timeout for this operation, represented in milliseconds.
      */
     timeout?: number;
+    /**
+     * Specifies the parent span for this specific operation.
+     */
+    parentSpan?: RequestSpan;
 }
 /**
  * @category Management
@@ -649,6 +667,10 @@ export interface DeployFunctionOptions {
      * The timeout for this operation, represented in milliseconds.
      */
     timeout?: number;
+    /**
+     * Specifies the parent span for this specific operation.
+     */
+    parentSpan?: RequestSpan;
 }
 /**
  * @category Management
@@ -658,6 +680,10 @@ export interface UndeployFunctionOptions {
      * The timeout for this operation, represented in milliseconds.
      */
     timeout?: number;
+    /**
+     * Specifies the parent span for this specific operation.
+     */
+    parentSpan?: RequestSpan;
 }
 /**
  * @category Management
@@ -667,6 +693,10 @@ export interface PauseFunctionOptions {
      * The timeout for this operation, represented in milliseconds.
      */
     timeout?: number;
+    /**
+     * Specifies the parent span for this specific operation.
+     */
+    parentSpan?: RequestSpan;
 }
 /**
  * @category Management
@@ -676,6 +706,10 @@ export interface ResumeFunctionOptions {
      * The timeout for this operation, represented in milliseconds.
      */
     timeout?: number;
+    /**
+     * Specifies the parent span for this specific operation.
+     */
+    parentSpan?: RequestSpan;
 }
 /**
  * @category Management
@@ -685,6 +719,10 @@ export interface FunctionsStatusOptions {
      * The timeout for this operation, represented in milliseconds.
      */
     timeout?: number;
+    /**
+     * Specifies the parent span for this specific operation.
+     */
+    parentSpan?: RequestSpan;
 }
 /**
  * EventingFunctionManager provides an interface for managing the
@@ -699,6 +737,10 @@ export declare class EventingFunctionManager {
      * @internal
      */
     constructor(cluster: Cluster);
+    /**
+     * @internal
+     */
+    get observabilityInstruments(): ObservabilityInstruments;
     /**
      * Creates or updates an eventing function.
      *

package/dist/eventingfunctionmanager.js

@@ -27,6 +27,9 @@ exports.EventingFunctionManager = exports.EventingState = exports.EventingFuncti
 const utilities_1 = require("./utilities");
 const bindingutilities_1 = require("./bindingutilities");
 const errs = __importStar(require("./errors"));
+const observability_1 = require("./observability");
+const observabilityhandler_1 = require("./observabilityhandler");
+const observabilitytypes_1 = require("./observabilitytypes");
 /**
  * Represents the various dcp boundary options for eventing functions.
  *
@@ -691,6 +694,12 @@ class EventingFunctionManager {
     constructor(cluster) {
         this._cluster = cluster;
     }
+    /**
+     * @internal
+     */
+    get observabilityInstruments() {
+        return this._cluster.observabilityInstruments;
+    }
     /**
      * Creates or updates an eventing function.
      *
@@ -706,19 +715,26 @@ class EventingFunctionManager {
         if (!options) {
             options = {};
         }
-        const timeout = options.timeout || this._cluster.managementTimeout;
-        return utilities_1.PromiseHelper.wrap((wrapCallback) => {
-            this._cluster.conn.managementEventingUpsertFunction({
-                function: EventingFunction._toCppData(functionDefinition),
-                timeout: timeout,
-            }, (cppErr) => {
-                const err = (0, bindingutilities_1.errorFromCpp)(cppErr);
+        const obsReqHandler = new observabilityhandler_1.ObservableRequestHandler(observabilitytypes_1.EventingFunctionMgmtOp.EventingUpsertFunction, this.observabilityInstruments, options === null || options === void 0 ? void 0 : options.parentSpan);
+        obsReqHandler.setRequestHttpAttributes();
+        try {
+            const timeout = options.timeout || this._cluster.managementTimeout;
+            return utilities_1.PromiseHelper.wrapAsync(async () => {
+                const [err, _] = await (0, observability_1.wrapObservableBindingCall)(this._cluster.conn.managementEventingUpsertFunction.bind(this._cluster.conn), {
+                    function: EventingFunction._toCppData(functionDefinition),
+                    timeout: timeout,
+                }, obsReqHandler);
                 if (err) {
-                    return wrapCallback(err, null);
+                    obsReqHandler.endWithError(err);
+                    throw err;
                 }
-                wrapCallback(err);
-            });
-        }, callback);
+                obsReqHandler.end();
+            }, callback);
+        }
+        catch (err) {
+            obsReqHandler.endWithError(err);
+            throw err;
+        }
     }
     /**
      * Deletes an eventing function.
@@ -735,19 +751,26 @@ class EventingFunctionManager {
         if (!options) {
             options = {};
         }
-        const timeout = options.timeout || this._cluster.managementTimeout;
-        return utilities_1.PromiseHelper.wrap((wrapCallback) => {
-            this._cluster.conn.managementEventingDropFunction({
-                name: name,
-                timeout: timeout,
-            }, (cppErr) => {
-                const err = (0, bindingutilities_1.errorFromCpp)(cppErr);
+        const obsReqHandler = new observabilityhandler_1.ObservableRequestHandler(observabilitytypes_1.EventingFunctionMgmtOp.EventingDropFunction, this.observabilityInstruments, options === null || options === void 0 ? void 0 : options.parentSpan);
+        obsReqHandler.setRequestHttpAttributes();
+        try {
+            const timeout = options.timeout || this._cluster.managementTimeout;
+            return utilities_1.PromiseHelper.wrapAsync(async () => {
+                const [err, _] = await (0, observability_1.wrapObservableBindingCall)(this._cluster.conn.managementEventingDropFunction.bind(this._cluster.conn), {
+                    name: name,
+                    timeout: timeout,
+                }, obsReqHandler);
                 if (err) {
-                    return wrapCallback(err, null);
+                    obsReqHandler.endWithError(err);
+                    throw err;
                 }
-                wrapCallback(err);
-            });
-        }, callback);
+                obsReqHandler.end();
+            }, callback);
+        }
+        catch (err) {
+            obsReqHandler.endWithError(err);
+            throw err;
+        }
     }
     /**
      * Fetches all eventing functions.
@@ -763,19 +786,26 @@ class EventingFunctionManager {
         if (!options) {
             options = {};
         }
-        const timeout = options.timeout || this._cluster.managementTimeout;
-        return utilities_1.PromiseHelper.wrap((wrapCallback) => {
-            this._cluster.conn.managementEventingGetAllFunctions({
-                timeout: timeout,
-            }, (cppErr, resp) => {
-                const err = (0, bindingutilities_1.errorFromCpp)(cppErr);
+        const obsReqHandler = new observabilityhandler_1.ObservableRequestHandler(observabilitytypes_1.EventingFunctionMgmtOp.EventingGetAllFunctions, this.observabilityInstruments, options === null || options === void 0 ? void 0 : options.parentSpan);
+        obsReqHandler.setRequestHttpAttributes();
+        try {
+            const timeout = options.timeout || this._cluster.managementTimeout;
+            return utilities_1.PromiseHelper.wrapAsync(async () => {
+                const [err, resp] = await (0, observability_1.wrapObservableBindingCall)(this._cluster.conn.managementEventingGetAllFunctions.bind(this._cluster.conn), {
+                    timeout: timeout,
+                }, obsReqHandler);
                 if (err) {
-                    return wrapCallback(err, null);
+                    obsReqHandler.endWithError(err);
+                    throw err;
                 }
-                const functions = resp.functions.map((functionData) => EventingFunction._fromCppData(functionData));
-                wrapCallback(null, functions);
-            });
-        }, callback);
+                obsReqHandler.end();
+                return resp.functions.map((functionData) => EventingFunction._fromCppData(functionData));
+            }, callback);
+        }
+        catch (err) {
+            obsReqHandler.endWithError(err);
+            throw err;
+        }
     }
     /**
      * Fetches a specific eventing function.
@@ -792,20 +822,27 @@ class EventingFunctionManager {
         if (!options) {
             options = {};
         }
-        const timeout = options.timeout || this._cluster.managementTimeout;
-        return utilities_1.PromiseHelper.wrap((wrapCallback) => {
-            this._cluster.conn.managementEventingGetFunction({
-                name: name,
-                timeout: timeout,
-            }, (cppErr, resp) => {
-                const err = (0, bindingutilities_1.errorFromCpp)(cppErr);
+        const obsReqHandler = new observabilityhandler_1.ObservableRequestHandler(observabilitytypes_1.EventingFunctionMgmtOp.EventingGetFunction, this.observabilityInstruments, options === null || options === void 0 ? void 0 : options.parentSpan);
+        obsReqHandler.setRequestHttpAttributes();
+        try {
+            const timeout = options.timeout || this._cluster.managementTimeout;
+            return utilities_1.PromiseHelper.wrapAsync(async () => {
+                const [err, resp] = await (0, observability_1.wrapObservableBindingCall)(this._cluster.conn.managementEventingGetFunction.bind(this._cluster.conn), {
+                    name: name,
+                    timeout: timeout,
+                }, obsReqHandler);
                 if (err) {
-                    return wrapCallback(err, null);
+                    obsReqHandler.endWithError(err);
+                    throw err;
                 }
-                const eventingFunction = EventingFunction._fromCppData(resp.function);
-                wrapCallback(null, eventingFunction);
-            });
-        }, callback);
+                obsReqHandler.end();
+                return EventingFunction._fromCppData(resp.function);
+            }, callback);
+        }
+        catch (err) {
+            obsReqHandler.endWithError(err);
+            throw err;
+        }
     }
     /**
      * Deploys an eventing function.
@@ -822,19 +859,26 @@ class EventingFunctionManager {
         if (!options) {
             options = {};
         }
-        const timeout = options.timeout || this._cluster.managementTimeout;
-        return utilities_1.PromiseHelper.wrap((wrapCallback) => {
-            this._cluster.conn.managementEventingDeployFunction({
-                name: name,
-                timeout: timeout,
-            }, (cppErr) => {
-                const err = (0, bindingutilities_1.errorFromCpp)(cppErr);
+        const obsReqHandler = new observabilityhandler_1.ObservableRequestHandler(observabilitytypes_1.EventingFunctionMgmtOp.EventingDeployFunction, this.observabilityInstruments, options === null || options === void 0 ? void 0 : options.parentSpan);
+        obsReqHandler.setRequestHttpAttributes();
+        try {
+            const timeout = options.timeout || this._cluster.managementTimeout;
+            return utilities_1.PromiseHelper.wrapAsync(async () => {
+                const [err, _] = await (0, observability_1.wrapObservableBindingCall)(this._cluster.conn.managementEventingDeployFunction.bind(this._cluster.conn), {
+                    name: name,
+                    timeout: timeout,
+                }, obsReqHandler);
                 if (err) {
-                    return wrapCallback(err, null);
+                    obsReqHandler.endWithError(err);
+                    throw err;
                 }
-                wrapCallback(err);
-            });
-        }, callback);
+                obsReqHandler.end();
+            }, callback);
+        }
+        catch (err) {
+            obsReqHandler.endWithError(err);
+            throw err;
+        }
     }
     /**
      * Undeploys an eventing function.
@@ -851,19 +895,26 @@ class EventingFunctionManager {
         if (!options) {
             options = {};
         }
-        const timeout = options.timeout || this._cluster.managementTimeout;
-        return utilities_1.PromiseHelper.wrap((wrapCallback) => {
-            this._cluster.conn.managementEventingUndeployFunction({
-                name: name,
-                timeout: timeout,
-            }, (cppErr) => {
-                const err = (0, bindingutilities_1.errorFromCpp)(cppErr);
+        const obsReqHandler = new observabilityhandler_1.ObservableRequestHandler(observabilitytypes_1.EventingFunctionMgmtOp.EventingUndeployFunction, this.observabilityInstruments, options === null || options === void 0 ? void 0 : options.parentSpan);
+        obsReqHandler.setRequestHttpAttributes();
+        try {
+            const timeout = options.timeout || this._cluster.managementTimeout;
+            return utilities_1.PromiseHelper.wrapAsync(async () => {
+                const [err, _] = await (0, observability_1.wrapObservableBindingCall)(this._cluster.conn.managementEventingUndeployFunction.bind(this._cluster.conn), {
+                    name: name,
+                    timeout: timeout,
+                }, obsReqHandler);
                 if (err) {
-                    return wrapCallback(err, null);
+                    obsReqHandler.endWithError(err);
+                    throw err;
                 }
-                wrapCallback(err);
-            });
-        }, callback);
+                obsReqHandler.end();
+            }, callback);
+        }
+        catch (err) {
+            obsReqHandler.endWithError(err);
+            throw err;
+        }
     }
     /**
      * Pauses an eventing function.
@@ -880,19 +931,26 @@ class EventingFunctionManager {
         if (!options) {
             options = {};
         }
-        const timeout = options.timeout || this._cluster.managementTimeout;
-        return utilities_1.PromiseHelper.wrap((wrapCallback) => {
-            this._cluster.conn.managementEventingPauseFunction({
-                name: name,
-                timeout: timeout,
-            }, (cppErr) => {
-                const err = (0, bindingutilities_1.errorFromCpp)(cppErr);
+        const obsReqHandler = new observabilityhandler_1.ObservableRequestHandler(observabilitytypes_1.EventingFunctionMgmtOp.EventingPauseFunction, this.observabilityInstruments, options === null || options === void 0 ? void 0 : options.parentSpan);
+        obsReqHandler.setRequestHttpAttributes();
+        try {
+            const timeout = options.timeout || this._cluster.managementTimeout;
+            return utilities_1.PromiseHelper.wrapAsync(async () => {
+                const [err, _] = await (0, observability_1.wrapObservableBindingCall)(this._cluster.conn.managementEventingPauseFunction.bind(this._cluster.conn), {
+                    name: name,
+                    timeout: timeout,
+                }, obsReqHandler);
                 if (err) {
-                    return wrapCallback(err, null);
+                    obsReqHandler.endWithError(err);
+                    throw err;
                 }
-                wrapCallback(err);
-            });
-        }, callback);
+                obsReqHandler.end();
+            }, callback);
+        }
+        catch (err) {
+            obsReqHandler.endWithError(err);
+            throw err;
+        }
     }
     /**
      * Resumes an eventing function.
@@ -909,19 +967,26 @@ class EventingFunctionManager {
         if (!options) {
             options = {};
         }
-        const timeout = options.timeout || this._cluster.managementTimeout;
-        return utilities_1.PromiseHelper.wrap((wrapCallback) => {
-            this._cluster.conn.managementEventingResumeFunction({
-                name: name,
-                timeout: timeout,
-            }, (cppErr) => {
-                const err = (0, bindingutilities_1.errorFromCpp)(cppErr);
+        const obsReqHandler = new observabilityhandler_1.ObservableRequestHandler(observabilitytypes_1.EventingFunctionMgmtOp.EventingResumeFunction, this.observabilityInstruments, options === null || options === void 0 ? void 0 : options.parentSpan);
+        obsReqHandler.setRequestHttpAttributes();
+        try {
+            const timeout = options.timeout || this._cluster.managementTimeout;
+            return utilities_1.PromiseHelper.wrapAsync(async () => {
+                const [err, _] = await (0, observability_1.wrapObservableBindingCall)(this._cluster.conn.managementEventingResumeFunction.bind(this._cluster.conn), {
+                    name: name,
+                    timeout: timeout,
+                }, obsReqHandler);
                 if (err) {
-                    return wrapCallback(err, null);
+                    obsReqHandler.endWithError(err);
+                    throw err;
                 }
-                wrapCallback(err);
-            });
-        }, callback);
+                obsReqHandler.end();
+            }, callback);
+        }
+        catch (err) {
+            obsReqHandler.endWithError(err);
+            throw err;
+        }
     }
     /**
      * Fetches the status of all eventing functions.
@@ -937,19 +1002,26 @@ class EventingFunctionManager {
         if (!options) {
             options = {};
         }
-        const timeout = options.timeout || this._cluster.managementTimeout;
-        return utilities_1.PromiseHelper.wrap((wrapCallback) => {
-            this._cluster.conn.managementEventingGetStatus({
-                timeout: timeout,
-            }, (cppErr, resp) => {
-                const err = (0, bindingutilities_1.errorFromCpp)(cppErr);
+        const obsReqHandler = new observabilityhandler_1.ObservableRequestHandler(observabilitytypes_1.EventingFunctionMgmtOp.EventingGetStatus, this.observabilityInstruments, options === null || options === void 0 ? void 0 : options.parentSpan);
+        obsReqHandler.setRequestHttpAttributes();
+        try {
+            const timeout = options.timeout || this._cluster.managementTimeout;
+            return utilities_1.PromiseHelper.wrapAsync(async () => {
+                const [err, resp] = await (0, observability_1.wrapObservableBindingCall)(this._cluster.conn.managementEventingGetStatus.bind(this._cluster.conn), {
+                    timeout: timeout,
+                }, obsReqHandler);
                 if (err) {
-                    return wrapCallback(err, null);
+                    obsReqHandler.endWithError(err);
+                    throw err;
                 }
-                const state = EventingState._fromCppData(resp.status);
-                wrapCallback(null, state);
-            });
-        }, callback);
+                obsReqHandler.end();
+                return EventingState._fromCppData(resp.status);
+            }, callback);
+        }
+        catch (err) {
+            obsReqHandler.endWithError(err);
+            throw err;
+        }
     }
 }
 exports.EventingFunctionManager = EventingFunctionManager;