@orkestrel/database 0.0.14 → 0.0.15

package/dist/src/core/index.js

@@ -1,4 +1,4 @@
-import { cloneJSONRecord, cloneJSONValue, compileGuard, compileSchema, createContract, isArray, isRecord, isString, objectShape, parseNumber, resolveField } from "@orkestrel/contract";
+import { arrayOf, cloneJSONRecord, cloneJSONValue, compileGuard, compileSchema, createContract, holds, isArray, isBoolean, isError, isFiniteNumber, isInstance, isInteger, isNumber, isRecord, isString, objectShape, parseNumber, resolveField } from "@orkestrel/contract";
 import { Emitter } from "@orkestrel/emitter";
 //#region src/core/constants.ts
 /**
@@ -143,7 +143,7 @@ var DatabaseError = class extends Error {
 * ```
 */
 function isDatabaseError(value) {
-	return value instanceof DatabaseError;
+	return isInstance(value, DatabaseError);
 }
 //#endregion
 //#region src/core/validators.ts
@@ -154,7 +154,7 @@ function isDatabaseError(value) {
 * @returns True if `value` is a string or a finite number; false otherwise
 */
 function isKey(value) {
-	return typeof value === "string" || typeof value === "number" && Number.isFinite(value);
+	return isString(value) || isFiniteNumber(value);
 }
 /**
 * Checks whether a value is a portable column schema.
@@ -167,13 +167,11 @@ function isKey(value) {
 * @returns True if `value` is a complete {@link ColumnSchema}; false otherwise
 */
 function isColumnSchema(value) {
-	try {
+	return holds(() => {
 		const column = cloneJSONRecord(value);
 		const keys = Object.keys(column);
-		return keys.length === 4 && keys.includes("name") && keys.includes("storage") && keys.includes("optional") && keys.includes("nullable") && typeof column.name === "string" && column.name.length > 0 && (column.storage === "text" || column.storage === "integer" || column.storage === "real" || column.storage === "boolean" || column.storage === "json" || column.storage === "blob") && typeof column.optional === "boolean" && typeof column.nullable === "boolean";
-	} catch {
-		return false;
-	}
+		return keys.length === 4 && keys.includes("name") && keys.includes("storage") && keys.includes("optional") && keys.includes("nullable") && isString(column.name) && column.name.length > 0 && (column.storage === "text" || column.storage === "integer" || column.storage === "real" || column.storage === "boolean" || column.storage === "json" || column.storage === "blob") && isBoolean(column.optional) && isBoolean(column.nullable);
+	});
 }
 /**
 * Checks whether a value is a portable table schema.
@@ -186,17 +184,15 @@ function isColumnSchema(value) {
 * @returns True if `value` is a complete {@link TableSchema}; false otherwise
 */
 function isTableSchema(value) {
-	try {
+	return holds(() => {
 		const table = cloneJSONRecord(value);
 		const keys = Object.keys(table);
-		if (keys.length !== 4 || !keys.includes("name") || !keys.includes("primary") || !keys.includes("columns") || !keys.includes("indexes") || typeof table.name !== "string" || table.name.length === 0 || typeof table.primary !== "string" || table.primary.length === 0 || !Array.isArray(table.columns) || !Array.isArray(table.indexes) || !table.columns.every(isColumnSchema)) return false;
+		if (keys.length !== 4 || !keys.includes("name") || !keys.includes("primary") || !keys.includes("columns") || !keys.includes("indexes") || !isString(table.name) || table.name.length === 0 || !isString(table.primary) || table.primary.length === 0 || !arrayOf(isColumnSchema)(table.columns) || !isArray(table.indexes)) return false;
 		const names = table.columns.map((column) => column.name);
-		if (new Set(names).size !== names.length || !names.includes(table.primary) || !table.indexes.every((index) => Array.isArray(index) && index.length > 0 && index.every((column) => typeof column === "string" && names.includes(column)))) return false;
+		if (new Set(names).size !== names.length || !names.includes(table.primary) || !table.indexes.every((index) => isArray(index) && index.length > 0 && index.every((column) => isString(column) && names.includes(column)))) return false;
 		const indexes = table.indexes.map((index) => JSON.stringify(index));
 		return new Set(indexes).size === indexes.length;
-	} catch {
-		return false;
-	}
+	});
 }
 /**
 * Checks whether a value is a complete portable driver schema.
@@ -209,14 +205,12 @@ function isTableSchema(value) {
 * @returns True if `value` is a table-schema collection with unique table names; false otherwise
 */
 function isDriverSchema(value) {
-	try {
+	return holds(() => {
 		const schema = cloneJSONValue(value);
-		if (!Array.isArray(schema) || !schema.every(isTableSchema)) return false;
+		if (!arrayOf(isTableSchema)(schema)) return false;
 		const names = schema.map((table) => table.name);
 		return new Set(names).size === names.length;
-	} catch {
-		return false;
-	}
+	});
 }
 /**
 * Checks whether a value is one ordered migration step.
@@ -229,22 +223,20 @@ function isDriverSchema(value) {
 * @returns True if `value` is a complete {@link MigrationStep}; false otherwise
 */
 function isMigrationStep(value) {
-	try {
+	return holds(() => {
 		const step = cloneJSONRecord(value);
-		if (typeof step.operation !== "string") return false;
+		if (!isString(step.operation)) return false;
 		const keys = Object.keys(step);
 		switch (step.operation) {
 			case "table.add": return keys.length === 2 && keys.includes("operation") && keys.includes("table") && isTableSchema(step.table);
-			case "table.remove": return keys.length === 2 && keys.includes("operation") && keys.includes("table") && typeof step.table === "string" && step.table.length > 0;
-			case "column.add": return keys.length === 3 && keys.includes("operation") && keys.includes("table") && keys.includes("column") && typeof step.table === "string" && step.table.length > 0 && isColumnSchema(step.column);
-			case "column.remove": return keys.length === 3 && keys.includes("operation") && keys.includes("table") && keys.includes("column") && typeof step.table === "string" && step.table.length > 0 && typeof step.column === "string" && step.column.length > 0;
+			case "table.remove": return keys.length === 2 && keys.includes("operation") && keys.includes("table") && isString(step.table) && step.table.length > 0;
+			case "column.add": return keys.length === 3 && keys.includes("operation") && keys.includes("table") && keys.includes("column") && isString(step.table) && step.table.length > 0 && isColumnSchema(step.column);
+			case "column.remove": return keys.length === 3 && keys.includes("operation") && keys.includes("table") && keys.includes("column") && isString(step.table) && step.table.length > 0 && isString(step.column) && step.column.length > 0;
 			case "index.add":
-			case "index.remove": return keys.length === 3 && keys.includes("operation") && keys.includes("table") && keys.includes("index") && typeof step.table === "string" && step.table.length > 0 && Array.isArray(step.index) && step.index.length > 0 && step.index.every((column) => typeof column === "string" && column.length > 0);
+			case "index.remove": return keys.length === 3 && keys.includes("operation") && keys.includes("table") && keys.includes("index") && isString(step.table) && step.table.length > 0 && isArray(step.index) && step.index.length > 0 && step.index.every((column) => isString(column) && column.length > 0);
 			default: return false;
 		}
-	} catch {
-		return false;
-	}
+	});
 }
 /**
 * Checks whether a value is an ordered migration plan.
@@ -257,13 +249,11 @@ function isMigrationStep(value) {
 * @returns True if `value` is a complete {@link Migration}; false otherwise
 */
 function isMigration(value) {
-	try {
+	return holds(() => {
 		const migration = cloneJSONRecord(value);
 		const keys = Object.keys(migration);
-		return keys.length === 3 && keys.includes("from") && keys.includes("to") && keys.includes("steps") && typeof migration.from === "number" && Number.isFinite(migration.from) && typeof migration.to === "number" && Number.isFinite(migration.to) && Array.isArray(migration.steps) && migration.steps.every(isMigrationStep);
-	} catch {
-		return false;
-	}
+		return keys.length === 3 && keys.includes("from") && keys.includes("to") && keys.includes("steps") && isFiniteNumber(migration.from) && isFiniteNumber(migration.to) && isArray(migration.steps) && migration.steps.every(isMigrationStep);
+	});
 }
 /**
 * Checks whether a value is persisted driver metadata.
@@ -278,13 +268,11 @@ function isMigration(value) {
 * @returns True if `value` is complete {@link DriverMetadata}; false otherwise
 */
 function isDriverMetadata(value) {
-	try {
+	return holds(() => {
 		const metadata = cloneJSONRecord(value);
 		const keys = Object.keys(metadata);
-		return keys.length === 2 && keys.includes("version") && keys.includes("schema") && typeof metadata.version === "number" && Number.isFinite(metadata.version) && isDriverSchema(metadata.schema);
-	} catch {
-		return false;
-	}
+		return keys.length === 2 && keys.includes("version") && keys.includes("schema") && isFiniteNumber(metadata.version) && isDriverSchema(metadata.schema);
+	});
 }
 /**
 * Checks whether a value is one atomic migration request.
@@ -297,13 +285,11 @@ function isDriverMetadata(value) {
 * @returns True if `value` is a complete {@link MigrationInput}; false otherwise
 */
 function isMigrationInput(value) {
-	try {
+	return holds(() => {
 		const input = cloneJSONRecord(value);
 		const keys = Object.keys(input);
 		return (keys.length === 1 || keys.length === 2) && keys.includes("plan") && (keys.length === 1 || keys.includes("metadata")) && isMigration(input.plan) && (input.metadata === void 0 || isDriverMetadata(input.metadata));
-	} catch {
-		return false;
-	}
+	});
 }
 //#endregion
 //#region src/core/cloners.ts
@@ -324,7 +310,7 @@ function cloneDriverMetadata(value) {
 		if (isDriverMetadata(metadata)) return metadata;
 		throw new DatabaseError("VALIDATION", "Driver metadata is invalid", { path: "metadata" });
 	} catch (error) {
-		if (error instanceof DatabaseError) throw error;
+		if (isDatabaseError(error)) throw error;
 		throw new DatabaseError("VALIDATION", "Driver metadata is invalid", {
 			path: "metadata",
 			cause: error
@@ -348,7 +334,7 @@ function cloneDriverSchema(value) {
 		if (isDriverSchema(schema)) return schema;
 		throw new DatabaseError("VALIDATION", "Driver schema is invalid", { path: "schema" });
 	} catch (error) {
-		if (error instanceof DatabaseError) throw error;
+		if (isDatabaseError(error)) throw error;
 		throw new DatabaseError("VALIDATION", "Driver schema is invalid", {
 			path: "schema",
 			cause: error
@@ -372,7 +358,7 @@ function cloneMigrationInput(value) {
 		if (isMigrationInput(input)) return input;
 		throw new DatabaseError("VALIDATION", "Migration input is invalid", { path: "migration" });
 	} catch (error) {
-		if (error instanceof DatabaseError) throw error;
+		if (isDatabaseError(error)) throw error;
 		throw new DatabaseError("VALIDATION", "Migration input is invalid", {
 			path: "migration",
 			cause: error
@@ -395,14 +381,14 @@ function cloneMigrationInput(value) {
 */
 function validatePage(input) {
 	const limit = input?.limit;
-	if (limit !== void 0 && (!Number.isInteger(limit) || limit < 0)) throw new DatabaseError("VALIDATION", "Query limit must be a nonnegative integer", {
+	if (limit !== void 0 && (!isInteger(limit) || limit < 0)) throw new DatabaseError("VALIDATION", "Query limit must be a nonnegative integer", {
 		field: "limit",
-		value: Number.isFinite(limit) ? limit : String(limit)
+		value: isFiniteNumber(limit) ? limit : String(limit)
 	});
 	const offset = input?.offset;
-	if (offset !== void 0 && (!Number.isInteger(offset) || offset < 0)) throw new DatabaseError("VALIDATION", "Query offset must be a nonnegative integer", {
+	if (offset !== void 0 && (!isInteger(offset) || offset < 0)) throw new DatabaseError("VALIDATION", "Query offset must be a nonnegative integer", {
 		field: "offset",
-		value: Number.isFinite(offset) ? offset : String(offset)
+		value: isFiniteNumber(offset) ? offset : String(offset)
 	});
 }
 /**
@@ -420,14 +406,14 @@ function validatePage(input) {
 * @returns `-1`, `0`, or `1`
 */
 function compareValues(left, right) {
-	const [leftRank = 5, rightRank = 5] = [left, right].map((value) => value === void 0 ? 0 : value === null ? 1 : typeof value === "boolean" ? 2 : typeof value === "number" ? 3 : typeof value === "string" ? 4 : 5);
+	const [leftRank = 5, rightRank = 5] = [left, right].map((value) => value === void 0 ? 0 : value === null ? 1 : isBoolean(value) ? 2 : isNumber(value) ? 3 : isString(value) ? 4 : 5);
 	if (leftRank !== rightRank) return leftRank < rightRank ? -1 : 1;
-	if (typeof left === "number" && typeof right === "number") {
+	if (isNumber(left) && isNumber(right)) {
 		if (Number.isNaN(left) || Number.isNaN(right)) return Number.isNaN(left) ? Number.isNaN(right) ? 0 : 1 : -1;
 		return left < right ? -1 : left > right ? 1 : 0;
 	}
-	if (typeof left === "string" && typeof right === "string") return left < right ? -1 : left > right ? 1 : 0;
-	if (typeof left === "boolean" && typeof right === "boolean") return left === right ? 0 : left ? 1 : -1;
+	if (isString(left) && isString(right)) return left < right ? -1 : left > right ? 1 : 0;
+	if (isBoolean(left) && isBoolean(right)) return left === right ? 0 : left ? 1 : -1;
 	return 0;
 }
 /**
@@ -466,13 +452,13 @@ function equalsValue(left, right) {
 			const pair = pending.pop();
 			if (pair === void 0) continue;
 			const [currentLeft, currentRight] = pair;
-			if (typeof currentLeft === "number" && typeof currentRight === "number") {
+			if (isNumber(currentLeft) && isNumber(currentRight)) {
 				if (Number.isNaN(currentLeft) && Number.isNaN(currentRight) || currentLeft === currentRight) continue;
 				return false;
 			}
 			if (currentLeft === currentRight) continue;
-			const leftArray = Array.isArray(currentLeft);
-			const rightArray = Array.isArray(currentRight);
+			const leftArray = isArray(currentLeft);
+			const rightArray = isArray(currentRight);
 			const leftRecord = isRecord(currentLeft);
 			const rightRecord = isRecord(currentRight);
 			if (leftArray !== rightArray || leftRecord !== rightRecord) return false;
@@ -837,8 +823,8 @@ function shapeToColumnStorage(shape) {
 		case "number": return shape.integer === true ? "integer" : "real";
 		case "boolean": return "boolean";
 		case "literal":
-			if (shape.values.every((value) => typeof value === "boolean")) return "boolean";
-			if (shape.values.every((value) => typeof value === "number")) return shape.values.every((value) => Number.isInteger(value)) ? "integer" : "real";
+			if (shape.values.every((value) => isBoolean(value))) return "boolean";
+			if (shape.values.every((value) => isNumber(value))) return shape.values.every((value) => isInteger(value)) ? "integer" : "real";
 			return "text";
 		case "optional":
 		case "nullable": return shapeToColumnStorage(shape.inner);
@@ -987,7 +973,7 @@ function checkAbort(signal) {
 * ```
 */
 function planMigration(deployed, declared, from = 0, to = 1) {
-	if (!Number.isFinite(from) || !Number.isFinite(to)) throw new DatabaseError("MIGRATION", "Migration versions must be finite", {
+	if (!isFiniteNumber(from) || !isFiniteNumber(to)) throw new DatabaseError("MIGRATION", "Migration versions must be finite", {
 		from,
 		to
 	});
@@ -1291,7 +1277,7 @@ async function* scanDriver(factory) {
 	} catch (error) {
 		yield {
 			check: "open-close",
-			message: error instanceof Error ? error.message : String(error),
+			message: isError(error) ? error.message : String(error),
 			context: { error }
 		};
 	}
@@ -1312,7 +1298,7 @@ async function* scanDriver(factory) {
 	} catch (error) {
 		yield {
 			check: "read-missing",
-			message: error instanceof Error ? error.message : String(error),
+			message: isError(error) ? error.message : String(error),
 			context: { error }
 		};
 	}
@@ -1388,7 +1374,7 @@ async function* scanDriver(factory) {
 	} catch (error) {
 		yield {
 			check: "write-read",
-			message: error instanceof Error ? error.message : String(error),
+			message: isError(error) ? error.message : String(error),
 			context: { error }
 		};
 	}
@@ -1429,7 +1415,7 @@ async function* scanDriver(factory) {
 	} catch (error) {
 		yield {
 			check: "insert-atomic",
-			message: error instanceof Error ? error.message : String(error),
+			message: isError(error) ? error.message : String(error),
 			context: { error }
 		};
 	}
@@ -1469,7 +1455,7 @@ async function* scanDriver(factory) {
 	} catch (error) {
 		yield {
 			check: "delete",
-			message: error instanceof Error ? error.message : String(error),
+			message: isError(error) ? error.message : String(error),
 			context: { error }
 		};
 	}
@@ -1532,7 +1518,7 @@ async function* scanDriver(factory) {
 	} catch (error) {
 		yield {
 			check: "mutation-abort",
-			message: error instanceof Error ? error.message : String(error),
+			message: isError(error) ? error.message : String(error),
 			context: { error }
 		};
 	}
@@ -1591,7 +1577,7 @@ async function* scanDriver(factory) {
 	} catch (error) {
 		yield {
 			check: "order",
-			message: error instanceof Error ? error.message : String(error),
+			message: isError(error) ? error.message : String(error),
 			context: { error }
 		};
 	}
@@ -1635,7 +1621,7 @@ async function* scanDriver(factory) {
 	} catch (error) {
 		yield {
 			check: "clear",
-			message: error instanceof Error ? error.message : String(error),
+			message: isError(error) ? error.message : String(error),
 			context: { error }
 		};
 	}
@@ -1684,7 +1670,7 @@ async function* scanDriver(factory) {
 	} catch (error) {
 		yield {
 			check: "snapshot",
-			message: error instanceof Error ? error.message : String(error),
+			message: isError(error) ? error.message : String(error),
 			context: { error }
 		};
 	}
@@ -1722,7 +1708,7 @@ async function* scanDriver(factory) {
 	} catch (error) {
 		yield {
 			check: "snapshot-nested",
-			message: error instanceof Error ? error.message : String(error),
+			message: isError(error) ? error.message : String(error),
 			context: { error }
 		};
 	}
@@ -1748,7 +1734,7 @@ async function* scanDriver(factory) {
 	} catch (error) {
 		yield {
 			check: "non-id-primary",
-			message: error instanceof Error ? error.message : String(error),
+			message: isError(error) ? error.message : String(error),
 			context: { error }
 		};
 	}
@@ -1779,7 +1765,7 @@ async function* scanDriver(factory) {
 	} catch (error) {
 		yield {
 			check: "nested-roundtrip",
-			message: error instanceof Error ? error.message : String(error),
+			message: isError(error) ? error.message : String(error),
 			context: { error }
 		};
 	}
@@ -1844,7 +1830,7 @@ async function* scanDriver(factory) {
 	} catch (error) {
 		yield {
 			check: "migrate",
-			message: error instanceof Error ? error.message : String(error),
+			message: isError(error) ? error.message : String(error),
 			context: { error }
 		};
 	}
@@ -1909,7 +1895,7 @@ async function* scanDriver(factory) {
 	} catch (error) {
 		yield {
 			check: "stream",
-			message: error instanceof Error ? error.message : String(error),
+			message: isError(error) ? error.message : String(error),
 			context: { error }
 		};
 	}
@@ -1970,7 +1956,7 @@ async function* scanDriver(factory) {
 	} catch (error) {
 		yield {
 			check: "transaction",
-			message: error instanceof Error ? error.message : String(error),
+			message: isError(error) ? error.message : String(error),
 			context: { error }
 		};
 	}
@@ -2009,7 +1995,7 @@ async function* scanDriver(factory) {
 	} catch (error) {
 		yield {
 			check: "metadata-stamp",
-			message: error instanceof Error ? error.message : String(error),
+			message: isError(error) ? error.message : String(error),
 			context: { error }
 		};
 	}
@@ -2064,7 +2050,7 @@ async function* scanDriver(factory) {
 	} catch (error) {
 		yield {
 			check: "snapshot-scoped",
-			message: error instanceof Error ? error.message : String(error),
+			message: isError(error) ? error.message : String(error),
 			context: { error }
 		};
 	}