couchbase 4.4.6-dev.1 → 4.5.0

package/dist/binding.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="node" />
+/// <reference types="node" />
 export type CppMilliseconds = number;
 export type CppSeconds = number;
 export type CppBytes = string | Buffer;
@@ -17,6 +18,13 @@ export interface CppDnsConfig {
     port?: number;
     dnsSrvTimeout?: number;
 }
+export interface CppAppTelemetryConfig {
+    enabled?: boolean;
+    endpoint?: string;
+    backoff?: number;
+    pingInterval?: number;
+    pingTimeout?: number;
+}
 export interface CppDocumentId {
     bucket: string;
     scope: string;
@@ -140,6 +148,14 @@ export declare enum CppReadPreference {
 }
 export declare enum CppVectorQueryCombination {
 }
+export declare enum CppTransactionsFailureType {
+}
+export declare enum CppTransactionsExternalException {
+}
+export declare enum CppTransactionsTransactionGetMultiMode {
+}
+export declare enum CppTransactionsTransactionGetMultiReplicasFromPreferredServerGroupMode {
+}
 export interface CppManagementAnalyticsDataset {
     name: string;
     dataverse_name: string;
@@ -511,6 +527,7 @@ export interface CppGetAllReplicasResponseEntry {
 export interface CppGetAllReplicasRequest {
     id: CppDocumentId;
     timeout?: CppMilliseconds;
+    read_preference: CppReadPreference;
 }
 export interface CppUpsertResponse {
     cas: CppCas;
@@ -548,6 +565,7 @@ export interface CppGetAnyReplicaResponse {
 export interface CppGetAnyReplicaRequest {
     id: CppDocumentId;
     timeout?: CppMilliseconds;
+    read_preference: CppReadPreference;
 }
 export interface CppAppendResponse {
     cas: CppCas;
@@ -728,6 +746,7 @@ export interface CppLookupInAllReplicasRequest {
     id: CppDocumentId;
     specs: CppImplSubdocCommand[];
     timeout?: CppMilliseconds;
+    read_preference: CppReadPreference;
 }
 export interface CppAnalyticsResponse {
     meta: CppAnalyticsResponseAnalyticsMetaData;
@@ -1049,6 +1068,7 @@ export interface CppLookupInAnyReplicaRequest {
     id: CppDocumentId;
     specs: CppImplSubdocCommand[];
     timeout?: CppMilliseconds;
+    read_preference: CppReadPreference;
 }
 export interface CppMutateInResponse {
     cas: CppCas;
@@ -2602,12 +2622,48 @@ export interface CppBindingAutogen {
         combination_and: CppVectorQueryCombination;
         combination_or: CppVectorQueryCombination;
     };
+    transactions_failure_type: {
+        FAIL: CppTransactionsFailureType;
+        EXPIRY: CppTransactionsFailureType;
+        COMMIT_AMBIGUOUS: CppTransactionsFailureType;
+    };
+    transactions_external_exception: {
+        UNKNOWN: CppTransactionsExternalException;
+        ACTIVE_TRANSACTION_RECORD_ENTRY_NOT_FOUND: CppTransactionsExternalException;
+        ACTIVE_TRANSACTION_RECORD_FULL: CppTransactionsExternalException;
+        ACTIVE_TRANSACTION_RECORD_NOT_FOUND: CppTransactionsExternalException;
+        DOCUMENT_ALREADY_IN_TRANSACTION: CppTransactionsExternalException;
+        DOCUMENT_EXISTS_EXCEPTION: CppTransactionsExternalException;
+        DOCUMENT_NOT_FOUND_EXCEPTION: CppTransactionsExternalException;
+        NOT_SET: CppTransactionsExternalException;
+        FEATURE_NOT_AVAILABLE_EXCEPTION: CppTransactionsExternalException;
+        TRANSACTION_ABORTED_EXTERNALLY: CppTransactionsExternalException;
+        PREVIOUS_OPERATION_FAILED: CppTransactionsExternalException;
+        FORWARD_COMPATIBILITY_FAILURE: CppTransactionsExternalException;
+        PARSING_FAILURE: CppTransactionsExternalException;
+        ILLEGAL_STATE_EXCEPTION: CppTransactionsExternalException;
+        COUCHBASE_EXCEPTION: CppTransactionsExternalException;
+        SERVICE_NOT_AVAILABLE_EXCEPTION: CppTransactionsExternalException;
+        REQUEST_CANCELED_EXCEPTION: CppTransactionsExternalException;
+        CONCURRENT_OPERATIONS_DETECTED_ON_SAME_DOCUMENT: CppTransactionsExternalException;
+        COMMIT_NOT_PERMITTED: CppTransactionsExternalException;
+        ROLLBACK_NOT_PERMITTED: CppTransactionsExternalException;
+        TRANSACTION_ALREADY_ABORTED: CppTransactionsExternalException;
+        TRANSACTION_ALREADY_COMMITTED: CppTransactionsExternalException;
+        DOCUMENT_UNRETRIEVABLE_EXCEPTION: CppTransactionsExternalException;
+    };
+    transactions_transaction_get_multi_mode: {
+        prioritise_latency: CppTransactionsTransactionGetMultiMode;
+        disable_read_skew_detection: CppTransactionsTransactionGetMultiMode;
+        prioritise_read_skew_detection: CppTransactionsTransactionGetMultiMode;
+    };
+    transactions_transaction_get_multi_replicas_from_preferred_server_group_mode: {
+        prioritise_latency: CppTransactionsTransactionGetMultiReplicasFromPreferredServerGroupMode;
+        disable_read_skew_detection: CppTransactionsTransactionGetMultiReplicasFromPreferredServerGroupMode;
+        prioritise_read_skew_detection: CppTransactionsTransactionGetMultiReplicasFromPreferredServerGroupMode;
+    };
 }
 export type CppErrc = CppErrcCommon | CppErrcKeyValue | CppErrcQuery | CppErrcAnalytics | CppErrcSearch | CppErrcView | CppErrcManagement | CppErrcFieldLevelEncryption | CppErrcNetwork;
-export declare enum CppTxnFailureType {
-}
-export declare enum CppTxnExternalException {
-}
 export interface CppErrorBase {
     code: CppErrc;
 }
@@ -2709,18 +2765,21 @@ export interface CppTxnOperationFailed extends CppErrorBase {
     ctx: CppTransactionErrorContext;
     should_not_retry: boolean;
     should_not_rollback: boolean;
-    cause: CppTxnExternalException;
+    cause: CppTransactionsExternalException;
+    message?: string;
 }
 export interface CppTxnOpException extends CppErrorBase {
     ctxtype: 'transaction_op_exception';
     ctx: CppTransactionOpErrorContext | undefined;
-    cause: CppTxnExternalException;
+    cause: CppTransactionsExternalException;
+    message?: string;
 }
 export interface CppTxnError extends CppErrorBase {
     ctxtype: 'transaction_exception';
     result: CppTransactionResult;
-    cause: CppTxnExternalException;
-    type: CppTxnFailureType;
+    cause: CppTransactionsExternalException;
+    type: CppTransactionsFailureType;
+    message?: string;
 }
 export interface CppTransactionErrorContext {
     code: CppErrc;
@@ -2732,7 +2791,7 @@ export interface CppTransactionOpErrorContext {
 }
 export type CppError = CppGenericError | CppKeyValueError | CppViewError | CppQueryError | CppSearchError | CppAnalyticsError | CppHttpError | CppTxnOperationFailed | CppTxnOpException | CppTxnError;
 export interface CppConnection extends CppConnectionAutogen {
-    connect(connStr: string, credentials: CppClusterCredentials, dnsOptions: CppDnsConfig | null, callback: (err: CppError | null) => void): void;
+    connect(connStr: string, credentials: CppClusterCredentials, dnsOptions: CppDnsConfig | null, appTelemetryOptions: CppAppTelemetryConfig | null, callback: (err: CppError | null) => void): void;
     shutdown(callback: (err: CppError | null) => void): void;
     openBucket(bucketName: string, callback: (err: CppError | null) => void): void;
     diagnostics(options: {
@@ -2830,6 +2889,12 @@ export interface CppTransactionGetResult {
     links: CppTransactionLinks;
     metadata: CppTransactionGetMetaData;
 }
+export interface CppTransactionGetMultiResult {
+    content: (CppEncodedValue | undefined)[];
+}
+export interface CppTransactionGetMultiReplicasFromPreferredServerGroupResult {
+    content: (CppEncodedValue | undefined)[];
+}
 export interface CppTransactionResult {
     transaction_id: string;
     unstaging_complete: boolean;
@@ -2843,6 +2908,17 @@ export interface CppTransaction {
     get(options: {
         id: CppDocumentId;
     }, callback: (err: CppError | null, result: CppTransactionGetResult | null) => void): void;
+    getReplicaFromPreferredServerGroup(options: {
+        id: CppDocumentId;
+    }, callback: (err: CppError | null, result: CppTransactionGetResult | null) => void): void;
+    getMulti(options: {
+        ids: CppDocumentId[];
+        mode?: CppTransactionsTransactionGetMultiMode;
+    }, callback: (err: CppError | null, result: CppTransactionGetMultiResult | null) => void): void;
+    getMultiReplicasFromPreferredServerGroup(options: {
+        ids: CppDocumentId[];
+        mode?: CppTransactionsTransactionGetMultiReplicasFromPreferredServerGroupMode;
+    }, callback: (err: CppError | null, result: CppTransactionGetMultiReplicasFromPreferredServerGroupResult | null) => void): void;
     insert(options: {
         id: CppDocumentId;
         content: CppEncodedValue;
@@ -2909,35 +2985,6 @@ export interface CppBinding extends CppBindingAutogen {
         xattr: number;
         expand_macros: number;
     };
-    txn_failure_type: {
-        fail: CppTxnFailureType;
-        expiry: CppTxnFailureType;
-        commit_ambiguous: CppTxnFailureType;
-    };
-    txn_external_exception: {
-        unknown: CppTxnExternalException;
-        active_transaction_record_entry_not_found: CppTxnExternalException;
-        active_transaction_record_full: CppTxnExternalException;
-        active_transaction_record_not_found: CppTxnExternalException;
-        document_already_in_transaction: CppTxnExternalException;
-        document_exists_exception: CppTxnExternalException;
-        document_not_found_exception: CppTxnExternalException;
-        not_set: CppTxnExternalException;
-        feature_not_available_exception: CppTxnExternalException;
-        transaction_aborted_externally: CppTxnExternalException;
-        previous_operation_failed: CppTxnExternalException;
-        forward_compatibility_failure: CppTxnExternalException;
-        parsing_failure: CppTxnExternalException;
-        illegal_state_exception: CppTxnExternalException;
-        couchbase_exception: CppTxnExternalException;
-        service_not_available_exception: CppTxnExternalException;
-        request_canceled_exception: CppTxnExternalException;
-        concurrent_operations_detected_on_same_document: CppTxnExternalException;
-        commit_not_permitted: CppTxnExternalException;
-        rollback_not_permitted: CppTxnExternalException;
-        transaction_already_aborted: CppTxnExternalException;
-        transaction_already_committed: CppTxnExternalException;
-    };
 }
 declare const binding: CppBinding;
 export default binding;

package/dist/binding.js

@@ -3,7 +3,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CppTxnExternalException = exports.CppTxnFailureType = exports.CppVectorQueryCombination = exports.CppReadPreference = exports.CppReplicateTo = exports.CppPersistTo = exports.CppStoreSemantics = exports.CppImplSubdocOpcode = exports.CppKeyValueStatusCode = exports.CppErrcNetwork = exports.CppErrcFieldLevelEncryption = exports.CppErrcManagement = exports.CppErrcView = exports.CppErrcSearch = exports.CppErrcAnalytics = exports.CppErrcQuery = exports.CppErrcKeyValue = exports.CppErrcCommon = exports.CppDurabilityLevel = exports.CppAnalyticsResponseAnalyticsStatus = exports.CppViewSortOrder = exports.CppViewScanConsistency = exports.CppViewOnError = exports.CppServiceType = exports.CppSearchScanConsistency = exports.CppSearchHighlightStyle = exports.CppQueryScanConsistency = exports.CppQueryProfile = exports.CppDiagPingState = exports.CppDiagEndpointState = exports.CppDiagClusterState = exports.CppDesignDocumentNamespace = exports.CppAnalyticsScanConsistency = exports.CppProtocolSubdocOpcode = exports.CppRetryReason = exports.CppManagementRbacAuthDomain = exports.CppManagementEventingFunctionProcessingStatus = exports.CppManagementEventingFunctionDeploymentStatus = exports.CppManagementEventingFunctionStatus = exports.CppManagementEventingFunctionBucketAccess = exports.CppManagementEventingFunctionLogLevel = exports.CppManagementEventingFunctionLanguageCompatibility = exports.CppManagementEventingFunctionDcpBoundary = exports.CppManagementClusterBucketStorageBackend = exports.CppManagementClusterBucketConflictResolution = exports.CppManagementClusterBucketEvictionPolicy = exports.CppManagementClusterBucketCompression = exports.CppManagementClusterBucketType = exports.CppManagementAnalyticsCouchbaseLinkEncryptionLevel = exports.zeroCas = void 0;
+exports.CppTransactionsExternalException = exports.CppTransactionsFailureType = exports.CppVectorQueryCombination = exports.CppReadPreference = exports.CppReplicateTo = exports.CppPersistTo = exports.CppStoreSemantics = exports.CppImplSubdocOpcode = exports.CppKeyValueStatusCode = exports.CppErrcNetwork = exports.CppErrcFieldLevelEncryption = exports.CppErrcManagement = exports.CppErrcView = exports.CppErrcSearch = exports.CppErrcAnalytics = exports.CppErrcQuery = exports.CppErrcKeyValue = exports.CppErrcCommon = exports.CppDurabilityLevel = exports.CppAnalyticsResponseAnalyticsStatus = exports.CppViewSortOrder = exports.CppViewScanConsistency = exports.CppViewOnError = exports.CppServiceType = exports.CppSearchScanConsistency = exports.CppSearchHighlightStyle = exports.CppQueryScanConsistency = exports.CppQueryProfile = exports.CppDiagPingState = exports.CppDiagEndpointState = exports.CppDiagClusterState = exports.CppDesignDocumentNamespace = exports.CppAnalyticsScanConsistency = exports.CppProtocolSubdocOpcode = exports.CppRetryReason = exports.CppManagementRbacAuthDomain = exports.CppManagementEventingFunctionProcessingStatus = exports.CppManagementEventingFunctionDeploymentStatus = exports.CppManagementEventingFunctionStatus = exports.CppManagementEventingFunctionBucketAccess = exports.CppManagementEventingFunctionLogLevel = exports.CppManagementEventingFunctionLanguageCompatibility = exports.CppManagementEventingFunctionDcpBoundary = exports.CppManagementClusterBucketStorageBackend = exports.CppManagementClusterBucketConflictResolution = exports.CppManagementClusterBucketEvictionPolicy = exports.CppManagementClusterBucketCompression = exports.CppManagementClusterBucketType = exports.CppManagementAnalyticsCouchbaseLinkEncryptionLevel = exports.zeroCas = void 0;
+exports.CppTransactionsTransactionGetMultiReplicasFromPreferredServerGroupMode = exports.CppTransactionsTransactionGetMultiMode = void 0;
 /*
 eslint
 jsdoc/require-jsdoc: off,
@@ -153,12 +154,18 @@ var CppReadPreference;
 var CppVectorQueryCombination;
 (function (CppVectorQueryCombination) {
 })(CppVectorQueryCombination || (exports.CppVectorQueryCombination = CppVectorQueryCombination = {}));
-var CppTxnFailureType;
-(function (CppTxnFailureType) {
-})(CppTxnFailureType || (exports.CppTxnFailureType = CppTxnFailureType = {}));
-var CppTxnExternalException;
-(function (CppTxnExternalException) {
-})(CppTxnExternalException || (exports.CppTxnExternalException = CppTxnExternalException = {}));
+var CppTransactionsFailureType;
+(function (CppTransactionsFailureType) {
+})(CppTransactionsFailureType || (exports.CppTransactionsFailureType = CppTransactionsFailureType = {}));
+var CppTransactionsExternalException;
+(function (CppTransactionsExternalException) {
+})(CppTransactionsExternalException || (exports.CppTransactionsExternalException = CppTransactionsExternalException = {}));
+var CppTransactionsTransactionGetMultiMode;
+(function (CppTransactionsTransactionGetMultiMode) {
+})(CppTransactionsTransactionGetMultiMode || (exports.CppTransactionsTransactionGetMultiMode = CppTransactionsTransactionGetMultiMode = {}));
+var CppTransactionsTransactionGetMultiReplicasFromPreferredServerGroupMode;
+(function (CppTransactionsTransactionGetMultiReplicasFromPreferredServerGroupMode) {
+})(CppTransactionsTransactionGetMultiReplicasFromPreferredServerGroupMode || (exports.CppTransactionsTransactionGetMultiReplicasFromPreferredServerGroupMode = CppTransactionsTransactionGetMultiReplicasFromPreferredServerGroupMode = {}));
 // CN_PREBUILD_PATH_OVERRIDE is meant to help for webpack scenarios.  Webpack's EnvironmentPlugin
 // can be used to set the path of the desired prebuild which will allow the node-loader package
 // to pull in the corresponding prebuild.

package/dist/bindingutilities.d.ts

@@ -1,15 +1,15 @@
 import { AnalyticsScanConsistency, AnalyticsStatus } from './analyticstypes';
 import { AnalyticsEncryptionLevel, CouchbaseAnalyticsEncryptionSettings } from './analyticsindexmanager';
-import { CppAnalyticsResponseAnalyticsStatus, CppAnalyticsScanConsistency, CppDesignDocumentNamespace, CppDiagEndpointState, CppDiagPingState, CppDurabilityLevel, CppError, CppManagementAnalyticsCouchbaseLinkEncryptionLevel, CppManagementAnalyticsCouchbaseLinkEncryptionSettings, CppManagementClusterBucketCompression, CppManagementClusterBucketConflictResolution, CppManagementClusterBucketEvictionPolicy, CppManagementClusterBucketStorageBackend, CppManagementClusterBucketType, CppManagementEventingFunctionBucketAccess, CppManagementEventingFunctionDcpBoundary, CppManagementEventingFunctionDeploymentStatus, CppManagementEventingFunctionLanguageCompatibility, CppManagementEventingFunctionLogLevel, CppManagementEventingFunctionProcessingStatus, CppManagementEventingFunctionStatus, CppManagementRbacAuthDomain, CppMutationState, CppPersistTo, CppPrefixScan, CppQueryProfile, CppQueryScanConsistency, CppRangeScan, CppReplicateTo, CppSamplingScan, CppSearchHighlightStyle, CppSearchScanConsistency, CppServiceType, CppStoreSemantics, CppTransactionKeyspace, CppTxnExternalException, CppTxnOpException, CppVectorQueryCombination, CppViewScanConsistency, CppViewSortOrder } from './binding';
+import { CppAnalyticsResponseAnalyticsStatus, CppAnalyticsScanConsistency, CppDesignDocumentNamespace, CppDiagEndpointState, CppDiagPingState, CppDurabilityLevel, CppError, CppManagementAnalyticsCouchbaseLinkEncryptionLevel, CppManagementAnalyticsCouchbaseLinkEncryptionSettings, CppManagementClusterBucketCompression, CppManagementClusterBucketConflictResolution, CppManagementClusterBucketEvictionPolicy, CppManagementClusterBucketStorageBackend, CppManagementClusterBucketType, CppManagementEventingFunctionBucketAccess, CppManagementEventingFunctionDcpBoundary, CppManagementEventingFunctionDeploymentStatus, CppManagementEventingFunctionLanguageCompatibility, CppManagementEventingFunctionLogLevel, CppManagementEventingFunctionProcessingStatus, CppManagementEventingFunctionStatus, CppManagementRbacAuthDomain, CppMutationState, CppPersistTo, CppPrefixScan, CppQueryProfile, CppQueryScanConsistency, CppRangeScan, CppReadPreference, CppReplicateTo, CppSamplingScan, CppSearchHighlightStyle, CppSearchScanConsistency, CppServiceType, CppStoreSemantics, CppTransactionKeyspace, CppTransactionsExternalException, CppTransactionsTransactionGetMultiMode, CppTransactionsTransactionGetMultiReplicasFromPreferredServerGroupMode, CppTxnOpException, CppVectorQueryCombination, CppViewScanConsistency, CppViewSortOrder } from './binding';
 import { BucketType, CompressionMode, ConflictResolutionType, EvictionPolicy, StorageBackend } from './bucketmanager';
 import { EndpointState, PingState } from './diagnosticstypes';
 import { ErrorContext } from './errorcontexts';
-import { DurabilityLevel, ServiceType, StoreSemantics } from './generaltypes';
+import { DurabilityLevel, ReadPreference, ServiceType, StoreSemantics } from './generaltypes';
 import { MutationState } from './mutationstate';
 import { QueryProfileMode, QueryScanConsistency } from './querytypes';
 import { PrefixScan, RangeScan, SamplingScan } from './rangeScan';
 import { HighlightStyle, SearchScanConsistency } from './searchtypes';
-import { TransactionKeyspace } from './transactions';
+import { TransactionGetMultiMode, TransactionGetMultiReplicasFromPreferredServerGroupMode, TransactionKeyspace } from './transactions';
 import { VectorQueryCombination } from './vectorsearch';
 import { DesignDocumentNamespace, ViewOrdering, ViewScanConsistency } from './viewtypes';
 import { EventingFunctionBucketAccess, EventingFunctionDcpBoundary, EventingFunctionDeploymentStatus, EventingFunctionLanguageCompatibility, EventingFunctionLogLevel, EventingFunctionProcessingStatus, EventingFunctionStatus } from './eventingfunctionmanager';
@@ -88,7 +88,7 @@ export declare function endpointStateFromCpp(service: CppDiagEndpointState): End
 /**
  * @internal
  */
-export declare function txnExternalExceptionStringFromCpp(cause: CppTxnExternalException): string;
+export declare function txnExternalExceptionStringFromCpp(cause: CppTransactionsExternalException, message?: string): string;
 /**
  * @internal
  */
@@ -241,3 +241,15 @@ export declare function authDomainToCpp(domain: string): CppManagementRbacAuthDo
  * @internal
  */
 export declare function authDomainFromCpp(domain: CppManagementRbacAuthDomain): string;
+/**
+ * @internal
+ */
+export declare function readPreferenceToCpp(preference: ReadPreference | undefined): CppReadPreference;
+/**
+ * @internal
+ */
+export declare function transactionGetMultiModeToCpp(mode: TransactionGetMultiMode | undefined): CppTransactionsTransactionGetMultiMode | undefined;
+/**
+ * @internal
+ */
+export declare function transactionGetMultiReplicasFromPreferredServerGroupModeToCpp(mode: TransactionGetMultiReplicasFromPreferredServerGroupMode | undefined): CppTransactionsTransactionGetMultiReplicasFromPreferredServerGroupMode | undefined;