@prosopo/database 4.2.6 → 4.2.8

package/dist/databases/provider.js

@@ -1,5 +1,6 @@
 import { MongoDatabase } from "../base/mongo.js";
-import { ProsopoDBError } from "@prosopo/common";
+import { clientRecordCache } from "./clientRecordCache.js";
+import { ProsopoError } from "@prosopo/common";
 import { CaptchaStates, CaptchaStatus, CaptchaType, DatasetWithIdsAndTreeSchema, DecisionMachineKind, StoredStatusNames, UserCommitmentSchema, isBlockingCaptchaResult } from "@prosopo/types";
 import { AudioCaptchaRecordSchema, CaptchaRecordSchema, ClientRecordSchema, DatasetRecordSchema, DecisionMachineArtifactRecordSchema, IconOrderCaptchaRecordSchema, PoWCaptchaRecordSchema, PuzzleCaptchaRecordSchema, SESSION_PROJECTION, ScheduledTaskRecordSchema, ScheduledTaskSchema, SessionRecordSchema, SolutionRecordSchema, SpamEmailDomainRecordSchema, UserCommitmentRecordSchema, UserSolutionRecordSchema } from "@prosopo/types-database";
 import { isHex } from "@polkadot/util/is";
@@ -121,18 +122,28 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 		this.tables = tables;
 	}
 	getTables() {
-		if (!this.tables) throw new ProsopoDBError("DATABASE.TABLES_UNDEFINED", {
-			context: { failedFuncName: this.getTables.name },
-			logger: this.logger
+		if (!this.tables) throw new ProsopoError({
+			code: "DB_UNAVAILABLE",
+			errorSite: "DBSE-5",
+			message: "Tables undefined",
+			context: { failedFuncName: this.getTables.name }
 		});
 		return this.tables;
 	}
 	getRedisAccessRulesConnection() {
-		if (null === this.redisAccessRulesConnection) throw new ProsopoDBError("DATABASE.REDIS_ACCESS_RULES_CONNECTION_UNDEFINED");
+		if (null === this.redisAccessRulesConnection) throw new ProsopoError({
+			code: "DB_UNAVAILABLE",
+			errorSite: "DBSE-6",
+			message: "Redis access rules connection undefined"
+		});
 		return this.redisAccessRulesConnection;
 	}
 	getRedisConnection() {
-		if (null === this.redisConnection) throw new ProsopoDBError("DATABASE.REDIS_ACCESS_RULES_CONNECTION_UNDEFINED");
+		if (null === this.redisConnection) throw new ProsopoError({
+			code: "DB_UNAVAILABLE",
+			errorSite: "DBSE-7",
+			message: "Redis access rules connection undefined"
+		});
 		return this.redisConnection;
 	}
 	async ensureIndexes() {
@@ -161,7 +172,11 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 		this.indexesEnsured = true;
 	}
 	getUserAccessRulesStorage() {
-		if (null === this.userAccessRulesStorage) throw new ProsopoDBError("DATABASE.USER_ACCESS_RULES_STORAGE_UNDEFINED");
+		if (null === this.userAccessRulesStorage) throw new ProsopoError({
+			code: "DB_UNAVAILABLE",
+			errorSite: "DBSE-8",
+			message: "User access rules storage undefined"
+		});
 		return this.userAccessRulesStorage;
 	}
 	/**
@@ -216,12 +231,12 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 			} })));
 			this.logger.debug(() => ({ msg: "Dataset stored in database" }));
 		} catch (err) {
-			throw new ProsopoDBError("DATABASE.DATASET_LOAD_FAILED", {
-				context: {
-					failedFuncName: this.storeDataset.name,
-					error: err
-				},
-				logger: this.logger
+			throw new ProsopoError({
+				code: "DB_QUERY_FAILED",
+				errorSite: "DBSE-9",
+				message: "Data set load failed",
+				cause: err,
+				context: { failedFuncName: this.storeDataset.name }
 			});
 		}
 	}
@@ -273,10 +288,15 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 				})
 			};
 		}
-		throw new ProsopoDBError("DATABASE.DATASET_GET_FAILED", { context: {
-			failedFuncName: this.getDataset.name,
-			datasetId
-		} });
+		throw new ProsopoError({
+			code: "DB_QUERY_FAILED",
+			errorSite: "DBSE-10",
+			message: "Failed to get dataset",
+			context: {
+				failedFuncName: this.getDataset.name,
+				datasetId
+			}
+		});
 	}
 	/**
 	* @description Get random captchas that are solved or not solved
@@ -285,10 +305,15 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 	* @param {number}   size       the number of records to be returned
 	*/
 	async getRandomCaptcha(solved, datasetId, size) {
-		if (!isHex(datasetId)) throw new ProsopoDBError("DATABASE.INVALID_HASH", { context: {
-			failedFuncName: this.getRandomCaptcha.name,
-			datasetId
-		} });
+		if (!isHex(datasetId)) throw new ProsopoError({
+			code: "INVALID_DATA",
+			errorSite: "DBSE-11",
+			message: "Invalid hash",
+			context: {
+				failedFuncName: this.getRandomCaptcha.name,
+				datasetId
+			}
+		});
 		const sampleSize = size ? Math.abs(Math.trunc(size)) : 1;
 		const projection = {
 			_id: 0,
@@ -324,12 +349,17 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 			if (fallback.length > 0) return fallback.map(({ _id, ...keep }) => keep);
 		}
 		if (docs.length > 0) return docs;
-		throw new ProsopoDBError("DATABASE.CAPTCHA_GET_FAILED", { context: {
-			failedFuncName: this.getRandomCaptcha.name,
-			solved,
-			datasetId,
-			size
-		} });
+		throw new ProsopoError({
+			code: "DB_QUERY_FAILED",
+			errorSite: "DBSE-12",
+			message: "Failed to get captcha",
+			context: {
+				failedFuncName: this.getRandomCaptcha.name,
+				solved,
+				datasetId,
+				size
+			}
+		});
 	}
 	/**
 	* @description Get captchas by id
@@ -344,10 +374,15 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 			items: 1
 		}).lean();
 		if (docs?.length) return docs.map(({ _id, ...keepAttrs }) => keepAttrs);
-		throw new ProsopoDBError("DATABASE.CAPTCHA_GET_FAILED", { context: {
-			failedFuncName: this.getCaptchaById.name,
-			captchaId
-		} });
+		throw new ProsopoError({
+			code: "DB_QUERY_FAILED",
+			errorSite: "DBSE-13",
+			message: "Failed to get captcha",
+			context: {
+				failedFuncName: this.getCaptchaById.name,
+				captchaId
+			}
+		});
 	}
 	/**
 	* @description Update a captcha
@@ -355,18 +390,26 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 	* @param {string}   datasetId  the id of the data set
 	*/
 	async updateCaptcha(captcha, datasetId) {
-		if (!isHex(datasetId)) throw new ProsopoDBError("DATABASE.INVALID_HASH", { context: {
-			failedFuncName: this.updateCaptcha.name,
-			datasetId
-		} });
+		if (!isHex(datasetId)) throw new ProsopoError({
+			code: "INVALID_DATA",
+			errorSite: "DBSE-14",
+			message: "Invalid hash",
+			context: {
+				failedFuncName: this.updateCaptcha.name,
+				datasetId
+			}
+		});
 		try {
 			const filter = { datasetId };
 			await this.tables?.captcha.updateOne(filter, { $set: captcha }, { upsert: false });
 		} catch (err) {
-			throw new ProsopoDBError("DATABASE.CAPTCHA_UPDATE_FAILED", { context: {
-				failedFuncName: this.getDatasetDetails.name,
-				error: err
-			} });
+			throw new ProsopoError({
+				code: "DB_QUERY_FAILED",
+				errorSite: "DBSE-15",
+				message: "Failed to update captcha",
+				cause: err,
+				context: { failedFuncName: this.getDatasetDetails.name }
+			});
 		}
 	}
 	/**
@@ -389,17 +432,27 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 		return typeof datasetId === "string" ? datasetId : void 0;
 	}
 	async getDatasetDetails(datasetId) {
-		if (!isHex(datasetId)) throw new ProsopoDBError("DATABASE.INVALID_HASH", { context: {
-			failedFuncName: this.getDatasetDetails.name,
-			datasetId
-		} });
+		if (!isHex(datasetId)) throw new ProsopoError({
+			code: "INVALID_DATA",
+			errorSite: "DBSE-16",
+			message: "Invalid hash",
+			context: {
+				failedFuncName: this.getDatasetDetails.name,
+				datasetId
+			}
+		});
 		const filter = { datasetId };
 		const doc = await this.tables?.dataset.findOne(filter).lean();
 		if (doc) return doc;
-		throw new ProsopoDBError("DATABASE.DATASET_GET_FAILED", { context: {
-			failedFuncName: this.getDatasetDetails.name,
-			datasetId
-		} });
+		throw new ProsopoError({
+			code: "DB_QUERY_FAILED",
+			errorSite: "DBSE-17",
+			message: "Failed to get dataset",
+			context: {
+				failedFuncName: this.getDatasetDetails.name,
+				datasetId
+			}
+		});
 	}
 	/**
 	* @description Store a Dapp User's captcha solution commitment
@@ -488,15 +541,17 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 				$unset: { pendingStage: 1 }
 			}).then(() => {}));
 		} catch (error) {
-			const err = new ProsopoDBError("DATABASE.CAPTCHA_UPDATE_FAILED", {
+			const err = new ProsopoError({
+				code: "DB_QUERY_FAILED",
+				errorSite: "DBSE-18",
+				message: "Failed to update captcha",
+				cause: error,
 				context: {
-					error,
 					challenge,
 					userSubmitted,
 					serverChecked,
 					ipInfo
-				},
-				logger: this.logger
+				}
 			});
 			this.logger.error(() => ({
 				err: error,
@@ -511,9 +566,11 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 	* @returns {Promise<PoWCaptchaRecord | null>} A promise that resolves with the found record or null if not found.
 	*/
 	async getPowCaptchaRecordByChallenge(challenge) {
-		if (!this.tables) throw new ProsopoDBError("DATABASE.DATABASE_UNDEFINED", {
-			context: { failedFuncName: this.getPowCaptchaRecordByChallenge.name },
-			logger: this.logger
+		if (!this.tables) throw new ProsopoError({
+			code: "DB_QUERY_FAILED",
+			errorSite: "DBSE-19",
+			message: "Database client is not connected",
+			context: { failedFuncName: this.getPowCaptchaRecordByChallenge.name }
 		});
 		try {
 			const filter = { challenge };
@@ -552,12 +609,12 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 			}));
 			return null;
 		} catch (error) {
-			const err = new ProsopoDBError("DATABASE.CAPTCHA_GET_FAILED", {
-				context: {
-					error,
-					challenge
-				},
-				logger: this.logger
+			const err = new ProsopoError({
+				code: "DB_QUERY_FAILED",
+				errorSite: "DBSE-20",
+				message: "Failed to get captcha",
+				cause: error,
+				context: { challenge }
 			});
 			this.logger.error(() => ({
 				err,
@@ -594,12 +651,14 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 		if (isDisapproved) setStage.failedAtTimestamp = { $ifNull: ["$failedAtTimestamp", timestamp] };
 		try {
 			if ((await tables.powcaptcha.updateOne({ challenge }, [{ $set: setStage }], { updatePipeline: true })).matchedCount === 0) {
-				const err = new ProsopoDBError("DATABASE.CAPTCHA_GET_FAILED", {
+				const err = new ProsopoError({
+					code: "DB_QUERY_FAILED",
+					errorSite: "DBSE-21",
+					message: "Failed to get captcha",
 					context: {
 						challenge,
 						...setStage
-					},
-					logger: this.logger
+					}
 				});
 				this.logger.info(() => ({
 					err,
@@ -622,13 +681,15 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 				$unset: { pendingStage: 1 }
 			}).then(() => {}));
 		} catch (error) {
-			const err = new ProsopoDBError("DATABASE.CAPTCHA_UPDATE_FAILED", {
+			const err = new ProsopoError({
+				code: "DB_QUERY_FAILED",
+				errorSite: "DBSE-22",
+				message: "Failed to update captcha",
+				cause: error,
 				context: {
-					error,
 					challenge,
 					...setStage
-				},
-				logger: this.logger
+				}
 			});
 			this.logger.error(() => ({
 				err,
@@ -721,13 +782,15 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 			}));
 			collection.streamRecord(record, this.markInteractiveRecordStored(collection, challenge));
 		} catch (error) {
-			const err = new ProsopoDBError("DATABASE.CAPTCHA_UPDATE_FAILED", {
+			const err = new ProsopoError({
+				code: "DB_QUERY_FAILED",
+				errorSite: "DBSE-23",
+				message: "Failed to update captcha",
+				cause: error,
 				context: {
-					error,
 					challenge,
 					ipInfo
-				},
-				logger: this.logger
+				}
 			});
 			this.logger.error(() => ({
 				err: error,
@@ -779,9 +842,11 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 		});
 	}
 	async getInteractiveCaptchaRecordByChallenge(collection, challenge, failedFuncName) {
-		if (!this.tables) throw new ProsopoDBError("DATABASE.DATABASE_UNDEFINED", {
-			context: { failedFuncName },
-			logger: this.logger
+		if (!this.tables) throw new ProsopoError({
+			code: "DB_QUERY_FAILED",
+			errorSite: "DBSE-24",
+			message: "Database client is not connected",
+			context: { failedFuncName }
 		});
 		try {
 			const record = await this.tables[collection.table].findOne({ challenge }, {
@@ -817,12 +882,12 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 			}));
 			return null;
 		} catch (error) {
-			const err = new ProsopoDBError("DATABASE.CAPTCHA_GET_FAILED", {
-				context: {
-					error,
-					challenge
-				},
-				logger: this.logger
+			const err = new ProsopoError({
+				code: "DB_QUERY_FAILED",
+				errorSite: "DBSE-25",
+				message: "Failed to get captcha",
+				cause: error,
+				context: { challenge }
 			});
 			this.logger.error(() => ({
 				err,
@@ -870,12 +935,12 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 			}));
 			return won;
 		} catch (error) {
-			const err = new ProsopoDBError("DATABASE.CAPTCHA_UPDATE_FAILED", {
-				context: {
-					error,
-					challenge
-				},
-				logger: this.logger
+			const err = new ProsopoError({
+				code: "DB_QUERY_FAILED",
+				errorSite: "DBSE-26",
+				message: "Failed to update captcha",
+				cause: error,
+				context: { challenge }
 			});
 			this.logger.error(() => ({
 				err,
@@ -909,12 +974,14 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 		};
 		try {
 			if ((await tables[collection.table].updateOne({ challenge }, { $set: setStage })).matchedCount === 0) {
-				const err = new ProsopoDBError("DATABASE.CAPTCHA_GET_FAILED", {
+				const err = new ProsopoError({
+					code: "DB_QUERY_FAILED",
+					errorSite: "DBSE-27",
+					message: "Failed to get captcha",
 					context: {
 						challenge,
 						...setStage
-					},
-					logger: this.logger
+					}
 				});
 				this.logger.info(() => ({
 					err,
@@ -931,13 +998,15 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 			}));
 			this.streamInteractiveUpdate(collection, challenge);
 		} catch (error) {
-			const err = new ProsopoDBError("DATABASE.CAPTCHA_UPDATE_FAILED", {
+			const err = new ProsopoError({
+				code: "DB_QUERY_FAILED",
+				errorSite: "DBSE-28",
+				message: "Failed to update captcha",
+				cause: error,
 				context: {
-					error,
 					challenge,
 					...setStage
-				},
-				logger: this.logger
+				}
 			});
 			this.logger.error(() => ({
 				err,
@@ -1195,12 +1264,12 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 				$unset: { pendingStage: 1 }
 			}).then(() => {}));
 		} catch (err) {
-			throw new ProsopoDBError("DATABASE.SESSION_STORE_FAILED", {
-				context: {
-					error: err,
-					sessionId: sessionRecord.sessionId
-				},
-				logger: this.logger
+			throw new ProsopoError({
+				code: "DB_QUERY_FAILED",
+				errorSite: "DBSE-29",
+				message: "Failed to store session",
+				cause: err,
+				context: { sessionId: sessionRecord.sessionId }
 			});
 		}
 	}
@@ -1281,12 +1350,12 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 				pendingStage: true
 			}).lean() || void 0;
 		} catch (err) {
-			throw new ProsopoDBError("DATABASE.SESSION_CHECK_REMOVE_FAILED", {
-				context: {
-					error: err,
-					sessionId
-				},
-				logger: this.logger
+			throw new ProsopoError({
+				code: "DB_QUERY_FAILED",
+				errorSite: "DBSE-30",
+				message: "Failed to check and remove session",
+				cause: err,
+				context: { sessionId }
 			});
 		}
 	}
@@ -1301,12 +1370,12 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 				pendingStage: true
 			} })).modifiedCount > 0;
 		} catch (err) {
-			throw new ProsopoDBError("DATABASE.SESSION_GET_FAILED", {
-				context: {
-					error: err,
-					sessionId
-				},
-				logger: this.logger
+			throw new ProsopoError({
+				code: "DB_QUERY_FAILED",
+				errorSite: "DBSE-31",
+				message: "Failed to get session",
+				cause: err,
+				context: { sessionId }
 			});
 		}
 	}
@@ -1337,12 +1406,12 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 				}).catch(() => {});
 			}
 		} catch (err) {
-			throw new ProsopoDBError("DATABASE.SESSION_GET_FAILED", {
-				context: {
-					error: err,
-					sessionId
-				},
-				logger: this.logger
+			throw new ProsopoError({
+				code: "DB_QUERY_FAILED",
+				errorSite: "DBSE-32",
+				message: "Failed to get session",
+				cause: err,
+				context: { sessionId }
 			});
 		}
 	}
@@ -1362,13 +1431,15 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 				pendingStage: true
 			} }], { updatePipeline: true });
 		} catch (err) {
-			throw new ProsopoDBError("DATABASE.SESSION_GET_FAILED", {
+			throw new ProsopoError({
+				code: "DB_QUERY_FAILED",
+				errorSite: "DBSE-33",
+				message: "Failed to get session",
+				cause: err,
 				context: {
-					error: err,
 					sessionId,
 					stage
-				},
-				logger: this.logger
+				}
 			});
 		}
 	}
@@ -1395,12 +1466,12 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 		try {
 			return (await this.tables.session.updateOne({ sessionId }, [{ $set: setStage }], { updatePipeline: true })).matchedCount > 0;
 		} catch (err) {
-			throw new ProsopoDBError("DATABASE.SESSION_GET_FAILED", {
-				context: {
-					error: err,
-					sessionId
-				},
-				logger: this.logger
+			throw new ProsopoError({
+				code: "DB_QUERY_FAILED",
+				errorSite: "DBSE-34",
+				message: "Failed to get session",
+				cause: err,
+				context: { sessionId }
 			});
 		}
 	}
@@ -1421,12 +1492,12 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 		try {
 			return await this.tables.session.findOne(filter).lean() || void 0;
 		} catch (err) {
-			throw new ProsopoDBError("DATABASE.SESSION_GET_FAILED", {
-				context: {
-					error: err,
-					userSitekeyIpHash
-				},
-				logger: this.logger
+			throw new ProsopoError({
+				code: "DB_QUERY_FAILED",
+				errorSite: "DBSE-35",
+				message: "Failed to get session",
+				cause: err,
+				context: { userSitekeyIpHash }
 			});
 		}
 	}
@@ -1463,10 +1534,15 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 	* @description Store a Dapp User's pending record
 	*/
 	async storePendingImageCommitment(userAccount, requestHash, salt, deadlineTimestamp, requestedAtTimestamp, ipAddress, threshold, sessionId, ipInfo) {
-		if (!isHex(requestHash)) throw new ProsopoDBError("DATABASE.INVALID_HASH", { context: {
-			failedFuncName: this.storePendingImageCommitment.name,
-			requestHash
-		} });
+		if (!isHex(requestHash)) throw new ProsopoError({
+			code: "INVALID_DATA",
+			errorSite: "DBSE-36",
+			message: "Invalid hash",
+			context: {
+				failedFuncName: this.storePendingImageCommitment.name,
+				requestHash
+			}
+		});
 		const pendingRecord = {
 			userAccount,
 			pending: true,
@@ -1495,10 +1571,15 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 	* @description Get a user's pending record
 	*/
 	async getPendingImageCommitment(requestHash) {
-		if (!isHex(requestHash)) throw new ProsopoDBError("DATABASE.INVALID_HASH", { context: {
-			failedFuncName: this.getPendingImageCommitment.name,
-			requestHash
-		} });
+		if (!isHex(requestHash)) throw new ProsopoError({
+			code: "INVALID_DATA",
+			errorSite: "DBSE-37",
+			message: "Invalid hash",
+			context: {
+				failedFuncName: this.getPendingImageCommitment.name,
+				requestHash
+			}
+		});
 		const doc = await this.tables?.commitment.findOne({
 			requestHash,
 			pending: true
@@ -1514,19 +1595,29 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 			sessionId: doc.sessionId,
 			threshold: doc.threshold
 		};
-		throw new ProsopoDBError("DATABASE.PENDING_RECORD_NOT_FOUND", { context: {
-			failedFuncName: this.getPendingImageCommitment.name,
-			requestHash
-		} });
+		throw new ProsopoError({
+			code: "RECORD_NOT_FOUND",
+			errorSite: "DBSE-38",
+			message: "No pending record found",
+			context: {
+				failedFuncName: this.getPendingImageCommitment.name,
+				requestHash
+			}
+		});
 	}
 	/**
 	* @description Mark a pending request as used
 	*/
 	async updatePendingImageCommitmentStatus(requestHash) {
-		if (!isHex(requestHash)) throw new ProsopoDBError("DATABASE.INVALID_HASH", { context: {
-			failedFuncName: this.updatePendingImageCommitmentStatus.name,
-			requestHash
-		} });
+		if (!isHex(requestHash)) throw new ProsopoError({
+			code: "INVALID_DATA",
+			errorSite: "DBSE-39",
+			message: "Invalid hash",
+			context: {
+				failedFuncName: this.updatePendingImageCommitmentStatus.name,
+				requestHash
+			}
+		});
 		return (await this.getTables().commitment.updateOne({
 			requestHash,
 			pending: true
@@ -1542,7 +1633,11 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 		};
 		const docs = await this.tables?.captcha.find(filter).lean();
 		if (docs) return docs.map(({ _id, ...keepAttrs }) => keepAttrs);
-		throw new ProsopoDBError("DATABASE.CAPTCHA_GET_FAILED");
+		throw new ProsopoError({
+			code: "DB_QUERY_FAILED",
+			errorSite: "DBSE-40",
+			message: "Failed to get captcha"
+		});
 	}
 	/**
 	* @description Get all dapp user solutions by captchaIds
@@ -1551,7 +1646,11 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 		const filter = { captchaId: { $in: captchaId } };
 		const docs = await this.tables?.usersolution?.find(filter).lean();
 		if (docs) return docs.map(({ _id, ...keepAttrs }) => keepAttrs);
-		throw new ProsopoDBError("DATABASE.SOLUTION_GET_FAILED");
+		throw new ProsopoError({
+			code: "DB_QUERY_FAILED",
+			errorSite: "DBSE-41",
+			message: "Failed to get solution"
+		});
 	}
 	async getDatasetIdWithSolvedCaptchasOfSizeN(solvedCaptchaCount) {
 		const docs = await this.tables?.solution.aggregate([
@@ -1564,13 +1663,22 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 			{ $sample: { size: 1 } }
 		]);
 		if (docs?.length) return docs[0]._id;
-		throw new ProsopoDBError("DATABASE.DATASET_WITH_SOLUTIONS_GET_FAILED");
+		throw new ProsopoError({
+			code: "DATASET_INVALID",
+			errorSite: "DBSE-42",
+			message: "No datasets found with required number of solutions"
+		});
 	}
 	async getRandomSolvedCaptchasFromSingleDataset(datasetId, size) {
-		if (!isHex(datasetId)) throw new ProsopoDBError("DATABASE.INVALID_HASH", { context: {
-			failedFuncName: this.getRandomSolvedCaptchasFromSingleDataset.name,
-			datasetId
-		} });
+		if (!isHex(datasetId)) throw new ProsopoError({
+			code: "INVALID_DATA",
+			errorSite: "DBSE-43",
+			message: "Invalid hash",
+			context: {
+				failedFuncName: this.getRandomSolvedCaptchasFromSingleDataset.name,
+				datasetId
+			}
+		});
 		const sampleSize = size ? Math.abs(Math.trunc(size)) : 1;
 		const docs = await this.tables?.solution.aggregate([
 			{ $match: { datasetId } },
@@ -1582,11 +1690,16 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 			} }
 		]);
 		if (docs?.length) return docs;
-		throw new ProsopoDBError("DATABASE.SOLUTION_GET_FAILED", { context: {
-			failedFuncName: this.getRandomSolvedCaptchasFromSingleDataset.name,
-			datasetId,
-			size
-		} });
+		throw new ProsopoError({
+			code: "DB_QUERY_FAILED",
+			errorSite: "DBSE-44",
+			message: "Failed to get solution",
+			context: {
+				failedFuncName: this.getRandomSolvedCaptchasFromSingleDataset.name,
+				datasetId,
+				size
+			}
+		});
 	}
 	/**
 	* @description Get dapp user solution by ID
@@ -1596,10 +1709,15 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 		const filter = { commitmentId };
 		const doc = await this.tables?.usersolution?.findOne(filter, { _id: 0 }).lean();
 		if (doc) return doc;
-		throw new ProsopoDBError("DATABASE.SOLUTION_GET_FAILED", { context: {
-			failedFuncName: this.getCaptchaById.name,
-			commitmentId
-		} });
+		throw new ProsopoError({
+			code: "DB_QUERY_FAILED",
+			errorSite: "DBSE-45",
+			message: "Failed to get solution",
+			context: {
+				failedFuncName: this.getCaptchaById.name,
+				commitmentId
+			}
+		});
 	}
 	static {
 		this.DAPP_USER_COMMITMENT_PROJECTION = {
@@ -1669,10 +1787,13 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 				$unset: { pendingStage: 1 }
 			}).then(() => {}));
 		} catch (err) {
-			throw new ProsopoDBError("DATABASE.SOLUTION_APPROVE_FAILED", { context: {
-				error: err,
-				commitmentId
-			} });
+			throw new ProsopoError({
+				code: "DB_QUERY_FAILED",
+				errorSite: "DBSE-46",
+				message: "Failed to approve solution",
+				cause: err,
+				context: { commitmentId }
+			});
 		}
 	}
 	/**
@@ -1704,10 +1825,13 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 				$unset: { pendingStage: 1 }
 			}).then(() => {}));
 		} catch (err) {
-			throw new ProsopoDBError("DATABASE.SOLUTION_APPROVE_FAILED", { context: {
-				error: err,
-				commitmentId
-			} });
+			throw new ProsopoError({
+				code: "DB_QUERY_FAILED",
+				errorSite: "DBSE-47",
+				message: "Failed to approve solution",
+				cause: err,
+				context: { commitmentId }
+			});
 		}
 	}
 	/**
@@ -1718,10 +1842,13 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 		try {
 			await this.tables?.usersolution?.updateMany({ captchaId: { $in: captchaIds } }, { $set: { processed: true } }, { upsert: false }).lean();
 		} catch (err) {
-			throw new ProsopoDBError("DATABASE.SOLUTION_FLAG_FAILED", { context: {
-				error: err,
-				captchaIds
-			} });
+			throw new ProsopoError({
+				code: "DB_QUERY_FAILED",
+				errorSite: "DBSE-48",
+				message: "Failed to flag solution as processed",
+				cause: err,
+				context: { captchaIds }
+			});
 		}
 	}
 	/**
@@ -1733,10 +1860,13 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 			const distinctCommitmentIds = [...new Set(commitmentIds)];
 			await this.tables?.commitment?.updateMany({ id: { $in: distinctCommitmentIds } }, { $set: { processed: true } }, { upsert: false }).lean();
 		} catch (err) {
-			throw new ProsopoDBError("DATABASE.COMMITMENT_FLAG_FAILED", { context: {
-				error: err,
-				commitmentIds
-			} });
+			throw new ProsopoError({
+				code: "DB_QUERY_FAILED",
+				errorSite: "DBSE-49",
+				message: "Failed to flag commitment as processed",
+				cause: err,
+				context: { commitmentIds }
+			});
 		}
 	}
 	/**
@@ -1819,14 +1949,22 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 			await this.logger.debug(() => ({ msg: "No client updates to apply" }));
 			return;
 		}
-		await this.tables?.client.bulkWrite(ops);
+		try {
+			await this.tables?.client.bulkWrite(ops);
+		} finally {
+			clientRecordCache.clear();
+		}
 	}
 	/**
 	* @description Remove client records by account
 	*/
 	async removeClientRecords(accounts) {
 		if (!accounts || accounts.length === 0) return;
-		await this.tables?.client.deleteMany({ account: { $in: accounts } });
+		try {
+			await this.tables?.client.deleteMany({ account: { $in: accounts } });
+		} finally {
+			clientRecordCache.clear();
+		}
 	}
 	/**
 	* @description Get all client records
@@ -1838,13 +1976,18 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 	* @description Get a client record
 	*/
 	async getClientRecord(account) {
+		const cacheKey = `${this.url}|${account}`;
+		const cached = clientRecordCache.get(cacheKey);
+		if (cached) return cached;
 		const filter = { account };
 		const doc = await this.tables?.client.findOne(filter, {
 			account: 1,
 			settings: 1,
 			tier: 1
 		}).lean();
-		return doc ? doc : void 0;
+		if (!doc) return void 0;
+		clientRecordCache.set(cacheKey, doc);
+		return doc;
 	}
 	/**
 	* Stores a decision machine artifact with a unique scope identifier.
@@ -1930,13 +2073,23 @@ var ProviderDatabase = class ProviderDatabase extends MongoDatabase {
 		return (await this.tables?.decisionMachine.deleteMany({}))?.deletedCount ?? 0;
 	}
 	async getSpamEmailDomain(domain) {
-		if (!this.tables?.spamEmailDomain) throw new ProsopoDBError("DATABASE.DATABASE_IMPORT_FAILED", { context: { failedFuncName: this.getSpamEmailDomain.name } });
+		if (!this.tables?.spamEmailDomain) throw new ProsopoError({
+			code: "DB_QUERY_FAILED",
+			errorSite: "DBSE-50",
+			message: "Failed to import database engine",
+			context: { failedFuncName: this.getSpamEmailDomain.name }
+		});
 		const suffixCandidates = buildDomainSuffixCandidates(domain).slice(0, MAX_DOMAIN_SUFFIX_CANDIDATES);
 		const query = suffixCandidates.length > 0 ? { domain: { $in: suffixCandidates } } : { domain };
 		return await this.tables.spamEmailDomain.findOne(query).exec();
 	}
 	async bulkUpdateSpamEmailDomains(domains, upsert) {
-		if (!this.tables?.spamEmailDomain) throw new ProsopoDBError("DATABASE.DATABASE_IMPORT_FAILED", { context: { failedFuncName: this.bulkUpdateSpamEmailDomains.name } });
+		if (!this.tables?.spamEmailDomain) throw new ProsopoError({
+			code: "DB_QUERY_FAILED",
+			errorSite: "DBSE-51",
+			message: "Failed to import database engine",
+			context: { failedFuncName: this.bulkUpdateSpamEmailDomains.name }
+		});
 		const bulkOps = domains.map((op) => ({ updateOne: {
 			filter: op.filter,
 			update: { $set: op.update },