@orkestrel/database 0.0.14 → 0.0.15

package/dist/src/core/index.cjs

@@ -144,7 +144,7 @@ var DatabaseError = class extends Error {
 * ```
 */
 function isDatabaseError(value) {
-	return value instanceof DatabaseError;
+	return (0, _orkestrel_contract.isInstance)(value, DatabaseError);
 }
 //#endregion
 //#region src/core/validators.ts
@@ -155,7 +155,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 (0, _orkestrel_contract.isString)(value) || (0, _orkestrel_contract.isFiniteNumber)(value);
 }
 /**
 * Checks whether a value is a portable column schema.
@@ -168,13 +168,11 @@ function isKey(value) {
 * @returns True if `value` is a complete {@link ColumnSchema}; false otherwise
 */
 function isColumnSchema(value) {
-	try {
+	return (0, _orkestrel_contract.holds)(() => {
 		const column = (0, _orkestrel_contract.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") && (0, _orkestrel_contract.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") && (0, _orkestrel_contract.isBoolean)(column.optional) && (0, _orkestrel_contract.isBoolean)(column.nullable);
+	});
 }
 /**
 * Checks whether a value is a portable table schema.
@@ -187,17 +185,15 @@ function isColumnSchema(value) {
 * @returns True if `value` is a complete {@link TableSchema}; false otherwise
 */
 function isTableSchema(value) {
-	try {
+	return (0, _orkestrel_contract.holds)(() => {
 		const table = (0, _orkestrel_contract.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") || !(0, _orkestrel_contract.isString)(table.name) || table.name.length === 0 || !(0, _orkestrel_contract.isString)(table.primary) || table.primary.length === 0 || !(0, _orkestrel_contract.arrayOf)(isColumnSchema)(table.columns) || !(0, _orkestrel_contract.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) => (0, _orkestrel_contract.isArray)(index) && index.length > 0 && index.every((column) => (0, _orkestrel_contract.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.
@@ -210,14 +206,12 @@ function isTableSchema(value) {
 * @returns True if `value` is a table-schema collection with unique table names; false otherwise
 */
 function isDriverSchema(value) {
-	try {
+	return (0, _orkestrel_contract.holds)(() => {
 		const schema = (0, _orkestrel_contract.cloneJSONValue)(value);
-		if (!Array.isArray(schema) || !schema.every(isTableSchema)) return false;
+		if (!(0, _orkestrel_contract.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.
@@ -230,22 +224,20 @@ function isDriverSchema(value) {
 * @returns True if `value` is a complete {@link MigrationStep}; false otherwise
 */
 function isMigrationStep(value) {
-	try {
+	return (0, _orkestrel_contract.holds)(() => {
 		const step = (0, _orkestrel_contract.cloneJSONRecord)(value);
-		if (typeof step.operation !== "string") return false;
+		if (!(0, _orkestrel_contract.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") && (0, _orkestrel_contract.isString)(step.table) && step.table.length > 0;
+			case "column.add": return keys.length === 3 && keys.includes("operation") && keys.includes("table") && keys.includes("column") && (0, _orkestrel_contract.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") && (0, _orkestrel_contract.isString)(step.table) && step.table.length > 0 && (0, _orkestrel_contract.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") && (0, _orkestrel_contract.isString)(step.table) && step.table.length > 0 && (0, _orkestrel_contract.isArray)(step.index) && step.index.length > 0 && step.index.every((column) => (0, _orkestrel_contract.isString)(column) && column.length > 0);
 			default: return false;
 		}
-	} catch {
-		return false;
-	}
+	});
 }
 /**
 * Checks whether a value is an ordered migration plan.
@@ -258,13 +250,11 @@ function isMigrationStep(value) {
 * @returns True if `value` is a complete {@link Migration}; false otherwise
 */
 function isMigration(value) {
-	try {
+	return (0, _orkestrel_contract.holds)(() => {
 		const migration = (0, _orkestrel_contract.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") && (0, _orkestrel_contract.isFiniteNumber)(migration.from) && (0, _orkestrel_contract.isFiniteNumber)(migration.to) && (0, _orkestrel_contract.isArray)(migration.steps) && migration.steps.every(isMigrationStep);
+	});
 }
 /**
 * Checks whether a value is persisted driver metadata.
@@ -279,13 +269,11 @@ function isMigration(value) {
 * @returns True if `value` is complete {@link DriverMetadata}; false otherwise
 */
 function isDriverMetadata(value) {
-	try {
+	return (0, _orkestrel_contract.holds)(() => {
 		const metadata = (0, _orkestrel_contract.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") && (0, _orkestrel_contract.isFiniteNumber)(metadata.version) && isDriverSchema(metadata.schema);
+	});
 }
 /**
 * Checks whether a value is one atomic migration request.
@@ -298,13 +286,11 @@ function isDriverMetadata(value) {
 * @returns True if `value` is a complete {@link MigrationInput}; false otherwise
 */
 function isMigrationInput(value) {
-	try {
+	return (0, _orkestrel_contract.holds)(() => {
 		const input = (0, _orkestrel_contract.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
@@ -325,7 +311,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
@@ -349,7 +335,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
@@ -373,7 +359,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
@@ -396,14 +382,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 && (!(0, _orkestrel_contract.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: (0, _orkestrel_contract.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 && (!(0, _orkestrel_contract.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: (0, _orkestrel_contract.isFiniteNumber)(offset) ? offset : String(offset)
 	});
 }
 /**
@@ -421,14 +407,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 : (0, _orkestrel_contract.isBoolean)(value) ? 2 : (0, _orkestrel_contract.isNumber)(value) ? 3 : (0, _orkestrel_contract.isString)(value) ? 4 : 5);
 	if (leftRank !== rightRank) return leftRank < rightRank ? -1 : 1;
-	if (typeof left === "number" && typeof right === "number") {
+	if ((0, _orkestrel_contract.isNumber)(left) && (0, _orkestrel_contract.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 ((0, _orkestrel_contract.isString)(left) && (0, _orkestrel_contract.isString)(right)) return left < right ? -1 : left > right ? 1 : 0;
+	if ((0, _orkestrel_contract.isBoolean)(left) && (0, _orkestrel_contract.isBoolean)(right)) return left === right ? 0 : left ? 1 : -1;
 	return 0;
 }
 /**
@@ -467,13 +453,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 ((0, _orkestrel_contract.isNumber)(currentLeft) && (0, _orkestrel_contract.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 = (0, _orkestrel_contract.isArray)(currentLeft);
+			const rightArray = (0, _orkestrel_contract.isArray)(currentRight);
 			const leftRecord = (0, _orkestrel_contract.isRecord)(currentLeft);
 			const rightRecord = (0, _orkestrel_contract.isRecord)(currentRight);
 			if (leftArray !== rightArray || leftRecord !== rightRecord) return false;
@@ -838,8 +824,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) => (0, _orkestrel_contract.isBoolean)(value))) return "boolean";
+			if (shape.values.every((value) => (0, _orkestrel_contract.isNumber)(value))) return shape.values.every((value) => (0, _orkestrel_contract.isInteger)(value)) ? "integer" : "real";
 			return "text";
 		case "optional":
 		case "nullable": return shapeToColumnStorage(shape.inner);
@@ -988,7 +974,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 (!(0, _orkestrel_contract.isFiniteNumber)(from) || !(0, _orkestrel_contract.isFiniteNumber)(to)) throw new DatabaseError("MIGRATION", "Migration versions must be finite", {
 		from,
 		to
 	});
@@ -1292,7 +1278,7 @@ async function* scanDriver(factory) {
 	} catch (error) {
 		yield {
 			check: "open-close",
-			message: error instanceof Error ? error.message : String(error),
+			message: (0, _orkestrel_contract.isError)(error) ? error.message : String(error),
 			context: { error }
 		};
 	}
@@ -1313,7 +1299,7 @@ async function* scanDriver(factory) {
 	} catch (error) {
 		yield {
 			check: "read-missing",
-			message: error instanceof Error ? error.message : String(error),
+			message: (0, _orkestrel_contract.isError)(error) ? error.message : String(error),
 			context: { error }
 		};
 	}
@@ -1389,7 +1375,7 @@ async function* scanDriver(factory) {
 	} catch (error) {
 		yield {
 			check: "write-read",
-			message: error instanceof Error ? error.message : String(error),
+			message: (0, _orkestrel_contract.isError)(error) ? error.message : String(error),
 			context: { error }
 		};
 	}
@@ -1430,7 +1416,7 @@ async function* scanDriver(factory) {
 	} catch (error) {
 		yield {
 			check: "insert-atomic",
-			message: error instanceof Error ? error.message : String(error),
+			message: (0, _orkestrel_contract.isError)(error) ? error.message : String(error),
 			context: { error }
 		};
 	}
@@ -1470,7 +1456,7 @@ async function* scanDriver(factory) {
 	} catch (error) {
 		yield {
 			check: "delete",
-			message: error instanceof Error ? error.message : String(error),
+			message: (0, _orkestrel_contract.isError)(error) ? error.message : String(error),
 			context: { error }
 		};
 	}
@@ -1533,7 +1519,7 @@ async function* scanDriver(factory) {
 	} catch (error) {
 		yield {
 			check: "mutation-abort",
-			message: error instanceof Error ? error.message : String(error),
+			message: (0, _orkestrel_contract.isError)(error) ? error.message : String(error),
 			context: { error }
 		};
 	}
@@ -1592,7 +1578,7 @@ async function* scanDriver(factory) {
 	} catch (error) {
 		yield {
 			check: "order",
-			message: error instanceof Error ? error.message : String(error),
+			message: (0, _orkestrel_contract.isError)(error) ? error.message : String(error),
 			context: { error }
 		};
 	}
@@ -1636,7 +1622,7 @@ async function* scanDriver(factory) {
 	} catch (error) {
 		yield {
 			check: "clear",
-			message: error instanceof Error ? error.message : String(error),
+			message: (0, _orkestrel_contract.isError)(error) ? error.message : String(error),
 			context: { error }
 		};
 	}
@@ -1685,7 +1671,7 @@ async function* scanDriver(factory) {
 	} catch (error) {
 		yield {
 			check: "snapshot",
-			message: error instanceof Error ? error.message : String(error),
+			message: (0, _orkestrel_contract.isError)(error) ? error.message : String(error),
 			context: { error }
 		};
 	}
@@ -1723,7 +1709,7 @@ async function* scanDriver(factory) {
 	} catch (error) {
 		yield {
 			check: "snapshot-nested",
-			message: error instanceof Error ? error.message : String(error),
+			message: (0, _orkestrel_contract.isError)(error) ? error.message : String(error),
 			context: { error }
 		};
 	}
@@ -1749,7 +1735,7 @@ async function* scanDriver(factory) {
 	} catch (error) {
 		yield {
 			check: "non-id-primary",
-			message: error instanceof Error ? error.message : String(error),
+			message: (0, _orkestrel_contract.isError)(error) ? error.message : String(error),
 			context: { error }
 		};
 	}
@@ -1780,7 +1766,7 @@ async function* scanDriver(factory) {
 	} catch (error) {
 		yield {
 			check: "nested-roundtrip",
-			message: error instanceof Error ? error.message : String(error),
+			message: (0, _orkestrel_contract.isError)(error) ? error.message : String(error),
 			context: { error }
 		};
 	}
@@ -1845,7 +1831,7 @@ async function* scanDriver(factory) {
 	} catch (error) {
 		yield {
 			check: "migrate",
-			message: error instanceof Error ? error.message : String(error),
+			message: (0, _orkestrel_contract.isError)(error) ? error.message : String(error),
 			context: { error }
 		};
 	}
@@ -1910,7 +1896,7 @@ async function* scanDriver(factory) {
 	} catch (error) {
 		yield {
 			check: "stream",
-			message: error instanceof Error ? error.message : String(error),
+			message: (0, _orkestrel_contract.isError)(error) ? error.message : String(error),
 			context: { error }
 		};
 	}
@@ -1971,7 +1957,7 @@ async function* scanDriver(factory) {
 	} catch (error) {
 		yield {
 			check: "transaction",
-			message: error instanceof Error ? error.message : String(error),
+			message: (0, _orkestrel_contract.isError)(error) ? error.message : String(error),
 			context: { error }
 		};
 	}
@@ -2010,7 +1996,7 @@ async function* scanDriver(factory) {
 	} catch (error) {
 		yield {
 			check: "metadata-stamp",
-			message: error instanceof Error ? error.message : String(error),
+			message: (0, _orkestrel_contract.isError)(error) ? error.message : String(error),
 			context: { error }
 		};
 	}
@@ -2065,7 +2051,7 @@ async function* scanDriver(factory) {
 	} catch (error) {
 		yield {
 			check: "snapshot-scoped",
-			message: error instanceof Error ? error.message : String(error),
+			message: (0, _orkestrel_contract.isError)(error) ? error.message : String(error),
 			context: { error }
 		};
 	}