aerospike/lib/status.js

Aerospike Client Library

// *****************************************************************************
// Copyright 2013-2024 Aerospike, Inc.
//
// Licensed under the Apache License, Version 2.0 (the 'License')
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an 'AS IS' BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
// *****************************************************************************

'use strict'

const as = require('bindings')('aerospike.node')

/**
 * @module aerospike/status
 *
 * @description Database operation error codes.
 */

exports.TXN_ALREADY_ABORTED = exports.AEROSPIKE_TXN_ALREADY_ABORTED = as.status.AEROSPIKE_TXN_ALREADY_ABORTED

exports.TXN_ALREADY_COMMITTED = exports.AEROSPIKE_TXN_ALREADY_COMMITTED = as.status.AEROSPIKE_TXN_ALREADY_COMMITTED

/**
 * Multi-record transaction failed.
 * @const {number}
 */
exports.TXN_FAILED = exports.AEROSPIKE_TXN_FAILED = as.status.AEROSPIKE_TXN_FAILED

/**
 * One or more keys failed in a batch.
 * @const {number}
 */
exports.BATCH_FAILED = exports.AEROSPIKE_BATCH_FAILED = as.status.AEROSPIKE_BATCH_FAILED

/**
 * No response received from server.
 * @const {number}
 */
exports.NO_RESPONSE = exports.AEROSPIKE_NO_RESPONSE = as.status.AEROSPIKE_NO_RESPONSE

/**
 * Max errors limit reached.
 * @const {number}
 */
exports.MAX_ERROR_RATE = exports.AEROSPIKE_MAX_ERROR_RATE = as.status.AEROSPIKE_MAX_ERROR_RATE

/**
 * Abort split batch retry and use normal node retry instead.
 * Used internally and should not be returned to user.
 * @const {number}
 */
exports.USE_NORMAL_RETRY = exports.AEROSPIKE_USE_NORMAL_RETRY = as.status.AEROSPIKE_USE_NORMAL_RETRY

/**
 * Max retries limit reached.
 * @const {number}
 */
exports.ERR_MAX_RETRIES_EXCEEDED = exports.AEROSPIKE_ERR_MAX_RETRIES_EXCEEDED = as.status.AEROSPIKE_ERR_MAX_RETRIES_EXCEEDED

/**
 * Async command delay queue is full.
 * @const {number}
 */
exports.ERR_ASYNC_QUEUE_FULL = exports.AEROSPIKE_ERR_ASYNC_QUEUE_FULL = as.status.AEROSPIKE_ERR_ASYNC_QUEUE_FULL

/**
 * Synchronous connection error.
 * @const {number}
 */
exports.ERR_CONNECTION = exports.AEROSPIKE_ERR_CONNECTION = as.status.AEROSPIKE_ERR_CONNECTION

/**
 * TLS related error
 * @const {number}
 */
exports.ERR_TLS_ERROR = exports.AEROSPIKE_ERR_TLS_ERROR = as.status.AEROSPIKE_ERR_TLS_ERROR

/**
 * Node invalid or could not be found.
 * @const {number}
 */
exports.ERR_INVALID_NODE = exports.AEROSPIKE_ERR_INVALID_NODE = as.status.AEROSPIKE_ERR_INVALID_NODE

/**
 * Asynchronous connection error.
 * @const {number}
 */
exports.ERR_NO_MORE_CONNECTIONS = exports.AEROSPIKE_ERR_NO_MORE_CONNECTIONS = as.status.AEROSPIKE_ERR_NO_MORE_CONNECTIONS

/**
 * Asynchronous connection error.
 * @const {number}
 */
exports.ERR_ASYNC_CONNECTION = exports.AEROSPIKE_ERR_ASYNC_CONNECTION = as.status.AEROSPIKE_ERR_ASYNC_CONNECTION

/**
 * Query or scan was aborted in user's callback.
 * @const {number}
 */
exports.ERR_CLIENT_ABORT = exports.AEROSPIKE_ERR_CLIENT_ABORT = as.status.AEROSPIKE_ERR_CLIENT_ABORT

/**
 * Host name could not be found in DNS lookup.
 * @const {number}
 */
exports.ERR_INVALID_HOST = exports.AEROSPIKE_ERR_INVALID_HOST = as.status.AEROSPIKE_ERR_INVALID_HOST

/**
 * No more records available when parsing batch, scan or query records.
 * @const {number}
 */
exports.NO_MORE_RECORDS = exports.AEROSPIKE_NO_MORE_RECORDS = as.status.AEROSPIKE_NO_MORE_RECORDS

/**
 * Invalid client API parameter.
 * @const {number}
 */
exports.ERR_PARAM = exports.AEROSPIKE_ERR_PARAM = as.status.AEROSPIKE_ERR_PARAM

/**
 * Generic client API usage error.
 * @const {number}
 */
exports.ERR_CLIENT = exports.AEROSPIKE_ERR_CLIENT = as.status.AEROSPIKE_ERR_CLIENT

/**
 * Generic success.
 * @const {number}
 */
exports.OK = exports.AEROSPIKE_OK = as.status.AEROSPIKE_OK

/**
 * Generic error returned by the server.
 * @const {number}
 */
exports.ERR_SERVER = exports.AEROSPIKE_ERR_SERVER = as.status.AEROSPIKE_ERR_SERVER

/**
 * Record does not exist in database. May be returned by read, or write with
 * policy <code>Aerospike.policy.exists.UPDATE</code>
 * @const {number}
 */
exports.ERR_RECORD_NOT_FOUND = exports.AEROSPIKE_ERR_RECORD_NOT_FOUND = as.status.AEROSPIKE_ERR_RECORD_NOT_FOUND

/**
 * Generation of record in database does not satisfy write policy.
 * @const {number}
 */
exports.ERR_RECORD_GENERATION = exports.AEROSPIKE_ERR_RECORD_GENERATION = as.status.AEROSPIKE_ERR_RECORD_GENERATION

/**
 * Request protocol invalid, or invalid protocol field.
 * @const {number}
 */
exports.ERR_REQUEST_INVALID = exports.AEROSPIKE_ERR_REQUEST_INVALID = as.status.AEROSPIKE_ERR_REQUEST_INVALID

/**
 * Record already exists. May be returned by write with policy
 * <code>Aerospike.policy.exists.CREATE</code>.
 * @const {number}
 */
exports.ERR_RECORD_EXISTS = exports.AEROSPIKE_ERR_RECORD_EXISTS = as.status.AEROSPIKE_ERR_RECORD_EXISTS

/**
 * Bin already exists on a create-only operation.
 * @const {number}
 */
exports.ERR_BIN_EXISTS = exports.AEROSPIKE_ERR_BIN_EXISTS = as.status.AEROSPIKE_ERR_BIN_EXISTS

/**
 * A cluster state change occurred during the request.
 * @const {number}
 */
exports.ERR_CLUSTER_CHANGE = exports.AEROSPIKE_ERR_CLUSTER_CHANGE = as.status.AEROSPIKE_ERR_CLUSTER_CHANGE

/**
 * The server node is running out of memory and/or storage device space
 * reserved for the specified namespace.
 * @const {number}
 */
exports.ERR_SERVER_FULL = exports.AEROSPIKE_ERR_SERVER_FULL = as.status.AEROSPIKE_ERR_SERVER_FULL

/**
 * Request timed out. Can be triggered by client or server.
 * @const {number}
 */
exports.ERR_TIMEOUT = exports.AEROSPIKE_ERR_TIMEOUT = as.status.AEROSPIKE_ERR_TIMEOUT

/**
 * Client is attempting an operation which is not allowed under current configuration.
 * @const {number}
 */
exports.ERR_ALWAYS_FORBIDDEN = exports.AEROSPIKE_ERR_ALWAYS_FORBIDDEN = as.status.AEROSPIKE_ERR_ALWAYS_FORBIDDEN

/**
 * Generic cluster discovery & connection error.
 * @const {number}
 */
exports.ERR_CLUSTER = exports.AEROSPIKE_ERR_CLUSTER = as.status.AEROSPIKE_ERR_CLUSTER

/**
 * Bin modification operation cannot be done on an existing bin due to its
 * value type.
 * @const {number}
 */
exports.ERR_BIN_INCOMPATIBLE_TYPE = exports.AEROSPIKE_ERR_BIN_INCOMPATIBLE_TYPE = as.status.AEROSPIKE_ERR_BIN_INCOMPATIBLE_TYPE

/**
 * Record being written (or updated) cannot fit in a storage write block.
 * @const {number}
 */
exports.ERR_RECORD_TOO_BIG = exports.AEROSPIKE_ERR_RECORD_TOO_BIG = as.status.AEROSPIKE_ERR_RECORD_TOO_BIG

/**
 * Too many concurrent requests for one record - a 'hot key' situation.
 * @const {number}
 */
exports.ERR_RECORD_BUSY = exports.AEROSPIKE_ERR_RECORD_BUSY = as.status.AEROSPIKE_ERR_RECORD_BUSY

/**
 * Scan aborted by user.
 * @const {number}
 */
exports.ERR_SCAN_ABORTED = exports.AEROSPIKE_ERR_SCAN_ABORTED = as.status.AEROSPIKE_ERR_SCAN_ABORTED

/**
 * Sometimes our doc, or our customers' wishes, get ahead of us. We may have
 * processed something that the server is not ready for (unsupported feature).
 * @const {number}
 */
exports.ERR_UNSUPPORTED_FEATURE = exports.AEROSPIKE_ERR_UNSUPPORTED_FEATURE = as.status.AEROSPIKE_ERR_UNSUPPORTED_FEATURE

/**
 * Bin not found on update-only operation.
 * @const {number}
 */
exports.ERR_BIN_NOT_FOUND = exports.AEROSPIKE_ERR_BIN_NOT_FOUND = as.status.AEROSPIKE_ERR_BIN_NOT_FOUND

/**
 * The server node's storage device(s) can't keep up with the write load.
 * @const {number}
 */
exports.ERR_DEVICE_OVERLOAD = exports.AEROSPIKE_ERR_DEVICE_OVERLOAD = as.status.AEROSPIKE_ERR_DEVICE_OVERLOAD

/**
 * Record key sent with transaction did not match key stored on server.
 * @const {number}
 */
exports.ERR_RECORD_KEY_MISMATCH = exports.AEROSPIKE_ERR_RECORD_KEY_MISMATCH = as.status.AEROSPIKE_ERR_RECORD_KEY_MISMATCH

/**
 * Namespace in request not found on server.
 * @const {number}
 */
exports.ERR_NAMESPACE_NOT_FOUND = exports.AEROSPIKE_ERR_NAMESPACE_NOT_FOUND = as.status.AEROSPIKE_ERR_NAMESPACE_NOT_FOUND

/**
 * Sent bin name that is too long or exceeded namespace's bin name quota.
 * @const {number}
 */
exports.ERR_BIN_NAME = exports.AEROSPIKE_ERR_BIN_NAME = as.status.AEROSPIKE_ERR_BIN_NAME

/**
 * Operation not allowed at this time.
 * @const {number}
 */
exports.ERR_FAIL_FORBIDDEN = exports.AEROSPIKE_ERR_FAIL_FORBIDDEN = as.status.AEROSPIKE_ERR_FAIL_FORBIDDEN

/**
 * Map/list element not found in UPDATE_ONLY write mode.
 * @const {number}
 */
exports.ERR_FAIL_ELEMENT_NOT_FOUND = exports.AEROSPIKE_ERR_FAIL_ELEMENT_NOT_FOUND = as.status.AEROSPIKE_ERR_FAIL_ELEMENT_NOT_FOUND

/**
 * Map/list element exists in CREATE_ONLY write mode.
 * @const {number}
 */
exports.ERR_FAIL_ELEMENT_EXISTS = exports.AEROSPIKE_ERR_FAIL_ELEMENT_EXISTS = as.status.AEROSPIKE_ERR_FAIL_ELEMENT_EXISTS

/**
 * Attempt to use an Enterprise feature on a Community server or a server
 * without the applicable feature key.
 * @const {number}
 */
exports.ERR_ENTERPRISE_ONLY = exports.AEROSPIKE_ERR_ENTERPRISE_ONLY = as.status.AEROSPIKE_ERR_ENTERPRISE_ONLY
// TODO: Remove ERR_FAIL_ENTERPRISE_ONLY - this is kept for backwards compatibility only.
exports.ERR_FAIL_ENTERPRISE_ONLY = exports.AEROSPIKE_ERR_FAIL_ENTERPRISE_ONLY = as.status.AEROSPIKE_ERR_ENTERPRISE_ONLY

/**
 * The operation cannot be applied to the current bin value on the server.
 * @const {number}
 */
exports.ERR_OP_NOT_APPLICABLE = exports.AEROSPIKE_ERR_OP_NOT_APPLICABLE = as.status.AEROSPIKE_ERR_OP_NOT_APPLICABLE

/**
 * The transaction was not performed because the exp was false.
 * @const {number}
 */
exports.FILTERED_OUT = exports.AEROSPIKE_FILTERED_OUT = as.status.AEROSPIKE_FILTERED_OUT

/**
 * Write command loses conflict to XDR.
 * @const {number}
 */
exports.LOST_CONFLICT = exports.AEROSPIKE_LOST_CONFLICT = as.status.AEROSPIKE_LOST_CONFLICT

exports.XDR_KEY_BUSY = exports.AEROSPIKE_XDR_KEY_BUSY = as.status.AEROSPIKE_XDR_KEY_BUSY

/**
 * There are no more records left for query.
 * @const {number}
 */
exports.QUERY_END = exports.AEROSPIKE_QUERY_END = as.status.AEROSPIKE_QUERY_END

/**
 * Security functionality not supported by connected server.
 * @const {number}
 */
exports.SECURITY_NOT_SUPPORTED = exports.AEROSPIKE_SECURITY_NOT_SUPPORTED = as.status.AEROSPIKE_SECURITY_NOT_SUPPORTED

/**
 * Security functionality not enabled by connected server.
 * @const {number}
 */
exports.SECURITY_NOT_ENABLED = exports.AEROSPIKE_SECURITY_NOT_ENABLED = as.status.AEROSPIKE_SECURITY_NOT_ENABLED

/**
 * Security type not supported by connected server.
 * @const {number}
 */
exports.SECURITY_SCHEME_NOT_SUPPORTED = exports.AEROSPIKE_SECURITY_SCHEME_NOT_SUPPORTED = as.status.AEROSPIKE_SECURITY_SCHEME_NOT_SUPPORTED

/**
 * Administration command is invalid.
 * @const {number}
 */
exports.INVALID_COMMAND = exports.AEROSPIKE_INVALID_COMMAND = as.status.AEROSPIKE_INVALID_COMMAND

/**
 * Administration field is invalid.
 * @const {number}
 */
exports.INVALID_FIELD = exports.AEROSPIKE_INVALID_FIELD = as.status.AEROSPIKE_INVALID_FIELD

/**
 * Security protocol not followed.
 * @const {number}
 */
exports.ILLEGAL_STATE = exports.AEROSPIKE_ILLEGAL_STATE = as.status.AEROSPIKE_ILLEGAL_STATE

/**
 * User name is invalid.
 * @const {number}
 */
exports.INVALID_USER = exports.AEROSPIKE_INVALID_USER = as.status.AEROSPIKE_INVALID_USER

/**
 * User was previously created.
 * @const {number}
 */
exports.USER_ALREADY_EXISTS = exports.AEROSPIKE_USER_ALREADY_EXISTS = as.status.AEROSPIKE_USER_ALREADY_EXISTS

/**
 * Password is invalid.
 * @const {number}
 */
exports.INVALID_PASSWORD = exports.AEROSPIKE_INVALID_PASSWORD = as.status.AEROSPIKE_INVALID_PASSWORD

/**
 * Password has expired.
 * @const {number}
 */
exports.EXPIRED_PASSWORD = exports.AEROSPIKE_EXPIRED_PASSWORD = as.status.AEROSPIKE_EXPIRED_PASSWORD

/**
 * Forbidden password (e.g. recently used).
 * @const {number}
 */
exports.FORBIDDEN_PASSWORD = exports.AEROSPIKE_FORBIDDEN_PASSWORD = as.status.AEROSPIKE_FORBIDDEN_PASSWORD

/**
 * Security credential is invalid.
 * @const {number}
 */
exports.INVALID_CREDENTIAL = exports.AEROSPIKE_INVALID_CREDENTIAL = as.status.AEROSPIKE_INVALID_CREDENTIAL

/**
 * Login session expired.
 * @const {number}
 */
exports.EXPIRED_SESSION = exports.AEROSPIKE_EXPIRED_SESSION = as.status.AEROSPIKE_EXPIRED_SESSION

/**
 * Role name is invalid.
 * @const {number}
 */
exports.INVALID_ROLE = exports.AEROSPIKE_INVALID_ROLE = as.status.AEROSPIKE_INVALID_ROLE

/**
 * Role name already exists.
 * @const {number}
 */
exports.ROLE_ALREADY_EXISTS = exports.AEROSPIKE_ROLE_ALREADY_EXISTS = as.status.AEROSPIKE_ROLE_ALREADY_EXISTS

/**
 * Privilege is invalid.
 * @const {number}
 */
exports.INVALID_PRIVILEGE = exports.AEROSPIKE_INVALID_PRIVILEGE = as.status.AEROSPIKE_INVALID_PRIVILEGE

/**
 * Specified IP whitelist is invalid.
 * @const {number}
 */
exports.INVALID_WHITELIST = exports.AEROSPIKE_INVALID_WHITELIST = as.status.AEROSPIKE_INVALID_WHITELIST

/**
 * Quotas not enabled on the server.
 * @const {number}
 */
exports.QUOTAS_NOT_ENABLED = exports.AEROSPIKE_QUOTAS_NOT_ENABLED = as.status.AEROSPIKE_QUOTAS_NOT_ENABLED

/**
 * Invalid quota specified.
 * @const {number}
 */
exports.INVALID_QUOTA = exports.AEROSPIKE_INVALID_QUOTA = as.status.AEROSPIKE_INVALID_QUOTA

/**
 * User must be authenticated before performing database operations.
 * @const {number}
 */
exports.NOT_AUTHENTICATED = exports.AEROSPIKE_NOT_AUTHENTICATED = as.status.AEROSPIKE_NOT_AUTHENTICATED

/**
 * User does not possess the required role to perform the database operation.
 * @const {number}
 */
exports.ROLE_VIOLATION = exports.AEROSPIKE_ROLE_VIOLATION = as.status.AEROSPIKE_ROLE_VIOLATION

exports.NOT_WHITELISTED = exports.AEROSPIKE_NOT_WHITELISTED = as.status.AEROSPIKE_NOT_WHITELISTED

exports.QUOTA_EXCEEDED = exports.AEROSPIKE_QUOTA_EXCEEDED = as.status.AEROSPIKE_QUOTA_EXCEEDED

/**
 * Generic UDF error.
 * @const {number}
 */
exports.ERR_UDF = exports.AEROSPIKE_ERR_UDF = as.status.AEROSPIKE_ERR_UDF

exports.MRT_BLOCKED = exports.AEROSPIKE_MRT_BLOCKED = as.status.AEROSPIKE_MRT_BLOCKED
exports.MRT_VERSION_MISMATCH = exports.AEROSPIKE_MRT_VERSION_MISMATCH = as.status.AEROSPIKE_MRT_VERSION_MISMATCH
exports.MRT_EXPIRED = exports.AEROSPIKE_MRT_EXPIRED = as.status.AEROSPIKE_MRT_EXPIRED
exports.MRT_TOO_MANY_WRITES = exports.AEROSPIKE_MRT_TOO_MANY_WRITES = as.status.AEROSPIKE_MRT_TOO_MANY_WRITES
exports.MRT_COMMITTED = exports.AEROSPIKE_MRT_COMMITTED = as.status.AEROSPIKE_MRT_COMMITTED
exports.MRT_ABORTED = exports.AEROSPIKE_MRT_ABORTED = as.status.AEROSPIKE_MRT_ABORTED
exports.MRT_ALREADY_LOCKED = exports.AEROSPIKE_MRT_ALREADY_LOCKED = as.status.AEROSPIKE_MRT_ALREADY_LOCKED
exports.MRT_MONITOR_EXISTS = exports.AEROSPIKE_MRT_MONITOR_EXISTS = as.status.AEROSPIKE_MRT_MONITOR_EXISTS

/**
 * Batch functionality has been disabled.
 * @const {number}
 */
exports.ERR_BATCH_DISABLED = exports.AEROSPIKE_ERR_BATCH_DISABLED = as.status.AEROSPIKE_ERR_BATCH_DISABLED

/**
 * Maximum number of batch requests has been exceeded.
 * @const {number}
 */
exports.ERR_BATCH_MAX_REQUESTS_EXCEEDED = exports.AEROSPIKE_ERR_BATCH_MAX_REQUESTS_EXCEEDED = as.status.AEROSPIKE_ERR_BATCH_MAX_REQUESTS_EXCEEDED

/**
 * All batch queues are full.
 * @const {number}
 */
exports.ERR_BATCH_QUEUES_FULL = exports.AEROSPIKE_ERR_BATCH_QUEUES_FULL = as.status.AEROSPIKE_ERR_BATCH_QUEUES_FULL

/**
 * Invalid/unsupported GeoJSON.
 * @const {number}
 */
exports.ERR_GEO_INVALID_GEOJSON = exports.AEROSPIKE_ERR_GEO_INVALID_GEOJSON = as.status.AEROSPIKE_ERR_GEO_INVALID_GEOJSON

/**
 * Index found.
 * @const {number}
 */
exports.ERR_INDEX_FOUND = exports.AEROSPIKE_ERR_INDEX_FOUND = as.status.AEROSPIKE_ERR_INDEX_FOUND

/**
 * Index not found.
 * @const {number}
 */
exports.ERR_INDEX_NOT_FOUND = exports.AEROSPIKE_ERR_INDEX_NOT_FOUND = as.status.AEROSPIKE_ERR_INDEX_NOT_FOUND

/**
 * Index is out of memory.
 * @const {number}
 */
exports.ERR_INDEX_OOM = exports.AEROSPIKE_ERR_INDEX_OOM = as.status.AEROSPIKE_ERR_INDEX_OOM

/**
 * Unable to read the index.
 * @const {number}
 */
exports.ERR_INDEX_NOT_READABLE = exports.AEROSPIKE_ERR_INDEX_NOT_READABLE = as.status.AEROSPIKE_ERR_INDEX_NOT_READABLE

/**
 * Generic secondary index (SI) error.
 * @const {number}
 */
exports.ERR_INDEX = exports.AEROSPIKE_ERR_INDEX = as.status.AEROSPIKE_ERR_INDEX

/**
 * Index name is too long.
 * @const {number}
 */
exports.ERR_INDEX_NAME_MAXLEN = exports.AEROSPIKE_ERR_INDEX_NAME_MAXLEN = as.status.AEROSPIKE_ERR_INDEX_NAME_MAXLEN

/**
 * System alrady has maximum allowed indices.
 * @const {number}
 */
exports.ERR_INDEX_MAXCOUNT = exports.AEROSPIKE_ERR_INDEX_MAXCOUNT = as.status.AEROSPIKE_ERR_INDEX_MAXCOUNT

/**
 * Query was aborted.
 * @const {number}
 */
exports.ERR_QUERY_ABORTED = exports.AEROSPIKE_ERR_QUERY_ABORTED = as.status.AEROSPIKE_ERR_QUERY_ABORTED

/**
 * Query processing queue is full.
 * @const {number}
 */
exports.ERR_QUERY_QUEUE_FULL = exports.AEROSPIKE_ERR_QUERY_QUEUE_FULL = as.status.AEROSPIKE_ERR_QUERY_QUEUE_FULL

/**
 * SI query timed out on server.
 * @const {number}
 */
exports.ERR_QUERY_TIMEOUT = exports.AEROSPIKE_ERR_QUERY_TIMEOUT = as.status.AEROSPIKE_ERR_QUERY_TIMEOUT

/**
 * Generic query error.
 * @const {number}
 */
exports.ERR_QUERY = exports.AEROSPIKE_ERR_QUERY = as.status.AEROSPIKE_ERR_QUERY

/**
 * UDF does not exist.
 * @const {number}
 */
exports.ERR_UDF_NOT_FOUND = exports.AEROSPIKE_ERR_UDF_NOT_FOUND = as.status.AEROSPIKE_ERR_UDF_NOT_FOUND

/**
 * LUA file does not exist.
 * @const {number}
 */
exports.ERR_LUA_FILE_NOT_FOUND = exports.AEROSPIKE_ERR_LUA_FILE_NOT_FOUND = as.status.AEROSPIKE_ERR_LUA_FILE_NOT_FOUND

// ========================================================================
// Functions
// ========================================================================

/**
 * Produces a human-readable error message for the given status code.
 */
exports.getMessage = function (code) {
  /* istanbul ignore next */
  switch (code) {
    case exports.TXN_ALREADY_ABORTED:
      return 'Transaction commit called, but the transaction was already aborted.'

    case exports.TXN_ALREADY_COMMITTED:
      return 'Transaction abort called, but the transaction was already committed.'

    case exports.TXN_FAILED:
      return 'Transaction failed.'

    case exports.BATCH_FAILED:
      return 'One or more keys failed in a batch.'

    case exports.NO_RESPONSE:
      return 'No response received from server.'

    case exports.MAX_ERROR_RATE:
      return 'Max errors limit reached.'

    case exports.USE_NORMAL_RETRY:
      return 'Abort split batch retry and use normal node retry instead. Used internally and should not be returned to user.'

    case exports.ERR_MAX_RETRIES_EXCEEDED:
      return 'Max retries limit reached.'

    case exports.ERR_ASYNC_QUEUE_FULL:
      return 'Async command delay queue is full.'

    case exports.ERR_CONNECTION:
      return 'Synchronous connection error.'

    case exports.ERR_TLS_ERROR:
      return 'TLS related error'

    case exports.ERR_INVALID_NODE:
      return 'Node invalid or could not be found.'

    case exports.ERR_NO_MORE_CONNECTIONS:
      return 'Max connections would be exceeded.'

    case exports.ERR_ASYNC_CONNECTION:
      return 'Asynchronous connection error.'

    case exports.ERR_CLIENT_ABORT:
      return 'Query or scan was aborted in user\'s callback.'

    case exports.ERR_INVALID_HOST:
      return 'Host name could not be found in DNS lookup.'

    case exports.NO_MORE_RECORDS:
      return 'No more records available when parsing batch, scan or query records.'

    case exports.ERR_PARAM:
      return 'Invalid client API parameter.'

    case exports.ERR_CLIENT:
      return 'Generic client API usage error.'

    case exports.OK:
      return 'Generic success.'

    case exports.ERR_SERVER:
      return 'Generic error returned by server.'

    case exports.ERR_RECORD_NOT_FOUND:
      return 'Record does not exist in database. May be returned by read, or write with policy Aerospike.policy.exists.UPDATE.'

    case exports.ERR_RECORD_GENERATION:
      return 'Generation of record in database does not satisfy write policy.'

    case exports.ERR_REQUEST_INVALID:
      return 'Request protocol invalid, or invalid protocol field.'

    case exports.ERR_RECORD_EXISTS:
      return 'Record already exists. May be returned by write with policy Aerospike.policy.exists.CREATE.'

    case exports.ERR_BIN_EXISTS:
      return 'Bin already exists on a create-only operation.'

    case exports.ERR_CLUSTER_CHANGE:
      return 'A cluster state change occurred during the request. This may also be returned by scan operations with the fail_on_cluster_change flag set.'

    case exports.ERR_SERVER_FULL:
      return 'The server node is running out of memory and/or storage device space reserved for the specified namespace.'

    case exports.ERR_TIMEOUT:
      return 'Request timed out. Can be triggered by client or server.'

    case exports.ERR_ALWAYS_FORBIDDEN:
      return 'Operation not allowed in current configuration.'

    case exports.ERR_CLUSTER:
      return 'Partition is unavailable.'

    case exports.ERR_BIN_INCOMPATIBLE_TYPE:
      return 'Bin modification operation can\'t be done on an existing bin due to its value type.'

    case exports.ERR_RECORD_TOO_BIG:
      return 'Record being (re-)written can\'t fit in a storage write block.'

    case exports.ERR_RECORD_BUSY:
      return 'Too many concurrent requests for one record - a "hot-key" situation.'

    case exports.ERR_SCAN_ABORTED:
      return 'Scan aborted by user.'

    case exports.ERR_UNSUPPORTED_FEATURE:
      return 'Sometimes our doc, or our customers wishes, get ahead of us. We may have processed something that the server is not ready for (unsupported feature).'

    case exports.ERR_BIN_NOT_FOUND:
      return 'Bin not found on update-only operation.'

    case exports.ERR_DEVICE_OVERLOAD:
      return 'The server node\'s storage device(s) can\'t keep up with the write load.'

    case exports.ERR_RECORD_KEY_MISMATCH:
      return 'Record key sent with command did not match key stored on server.'

    case exports.ERR_NAMESPACE_NOT_FOUND:
      return 'Namespace in request not found on server.'

    case exports.ERR_BIN_NAME:
      return 'Sent too-long bin name (should be impossible in this client) or exceeded namespace\'s bin name quota.'

    case exports.ERR_FAIL_FORBIDDEN:
      return 'Operation not allowed at this time.'

    case exports.ERR_FAIL_ELEMENT_NOT_FOUND:
      return 'Map element not found in UPDATE_ONLY write mode.'

    case exports.ERR_FAIL_ELEMENT_EXISTS:
      return 'Map element exists in CREATE_ONLY write mode.'

    case exports.ERR_ENTERPRISE_ONLY:
      return 'Attempt to use an Enterprise feature on a Community server or a server without the applicable feature key.'

    case exports.ERR_OP_NOT_APPLICABLE:
      return 'The operation cannot be applied to the current bin value on the server.'

    case exports.FILTERED_OUT:
      return 'The command was not performed because the filter expression was false.'

    case exports.LOST_CONFLICT:
      return 'Write command loses conflict to XDR.'

    case exports.XDR_KEY_BUSY:
      return 'Write can\'t complete until XDR finishes shipping.'

    case exports.QUERY_END:
      return 'There are no more records left for query.'

    case exports.SECURITY_NOT_SUPPORTED:
      return 'Security functionality not supported by connected server.'

    case exports.SECURITY_NOT_ENABLED:
      return 'Security functionality not enabled by connected server.'

    case exports.SECURITY_SCHEME_NOT_SUPPORTED:
      return 'Security scheme not supported.'

    case exports.INVALID_COMMAND:
      return 'Administration command is invalid.'

    case exports.INVALID_FIELD:
      return 'Administration field is invalid.'

    case exports.ILLEGAL_STATE:
      return 'Security protocol not followed.'

    case exports.INVALID_USER:
      return 'User name is invalid.'

    case exports.USER_ALREADY_EXISTS:
      return 'User was previously created.'

    case exports.INVALID_PASSWORD:
      return 'Password is invalid.'

    case exports.EXPIRED_PASSWORD:
      return 'Password has expired.'

    case exports.FORBIDDEN_PASSWORD:
      return 'Forbidden password (e.g. recently used).'

    case exports.INVALID_CREDENTIAL:
      return 'Security credential is invalid.'

    case exports.EXPIRED_SESSION:
      return 'Login session expired.'

    case exports.INVALID_ROLE:
      return 'Role name is invalid.'

    case exports.ROLE_ALREADY_EXISTS:
      return 'Role already exists.'

    case exports.INVALID_PRIVILEGE:
      return 'Privilege is invalid.'

    case exports.INVALID_WHITELIST:
      return 'Invalid IP whitelist.'

    case exports.QUOTAS_NOT_ENABLED:
      return 'Quotas not enabled on server.'

    case exports.INVALID_QUOTA:
      return 'Invalid quota.'

    case exports.NOT_AUTHENTICATED:
      return 'User must be authenticated before performing database operations.'

    case exports.ROLE_VIOLATION:
      return 'User does not possess the required role to perform the database operation.'

    case exports.NOT_WHITELISTED:
      return 'Command not allowed because sender IP not whitelisted.'

    case exports.QUOTA_EXCEEDED:
      return 'Quota exceeded.'

    case exports.ERR_UDF:
      return 'Generic UDF error.'

    case exports.MRT_BLOCKED:
      return 'Transaction record blocked by a different transaction.'

    case exports.MRT_VERSION_MISMATCH:
      return 'Transaction read version mismatch identified during commit. Some other command changed the record outside of the transaction.'

    case exports.MRT_EXPIRED:
      return 'Transaction deadline reached without a successful commit or abort.'

    case exports.MRT_TOO_MANY_WRITES:
      return 'Transaction write command limit (4096) exceeded.'

    case exports.MRT_COMMITTED:
      return 'Transaction was already committed.'

    case exports.MRT_ABORTED:
      return 'Transaction was already aborted.'

    case exports.MRT_ALREADY_LOCKED:
      return 'This record has been locked by a previous update in this transaction.'

    case exports.MRT_MONITOR_EXISTS:
      return 'This transaction has already started. Writing to the same transaction with independent threads is unsafe.'

    case exports.ERR_BATCH_DISABLED:
      return 'Batch functionality has been disabled.'

    case exports.ERR_BATCH_MAX_REQUESTS_EXCEEDED:
      return 'Batch max requests have been exceeded.'

    case exports.ERR_BATCH_QUEUES_FULL:
      return 'All batch queues are full.'

    case exports.ERR_GEO_INVALID_GEOJSON:
      return 'Invalid/Unsupported GeoJSON.'

    case exports.ERR_INDEX_FOUND:
      return 'Index found.'

    case exports.ERR_INDEX_NOT_FOUND:
      return 'Index not found.'

    case exports.ERR_INDEX_OOM:
      return 'Index is out of memory.'

    case exports.ERR_INDEX_NOT_READABLE:
      return 'Unable to read the index.'

    case exports.ERR_INDEX:
      return 'Generic secondary index error.'

    case exports.ERR_INDEX_NAME_MAXLEN:
      return 'Index name is too long.'

    case exports.ERR_INDEX_MAXCOUNT:
      return 'System already has maximum allowed indices.'

    case exports.ERR_QUERY_ABORTED:
      return 'Query was aborted.'

    case exports.ERR_QUERY_QUEUE_FULL:
      return 'Query processing queue is full.'

    case exports.ERR_QUERY_TIMEOUT:
      return 'Secondary index query timed out on server.'

    case exports.ERR_QUERY:
      return 'Generic query error.'

    case exports.ERR_UDF_NOT_FOUND:
      return 'UDF does not exist.'

    case exports.ERR_LUA_FILE_NOT_FOUND:
      return 'LUA file does not exist.'

    default: return `Unknown status message ${code}`
  }
}