@orkestrel/database 0.0.7 → 0.0.9

package/dist/src/server/index.cjs

@@ -56,6 +56,37 @@ var METADATA_TABLE = "_metadata";
 //#endregion
 //#region src/server/helpers.ts
 /**
+* Whether a caught filesystem error reports that nothing is there to read.
+*
+* @remarks
+* Two codes carry that meaning: `ENOENT` is a plain absence, and `ENOTDIR` is a
+* path whose parent is not a directory — an absence in the stronger sense, since
+* no file can exist at that name and no later write could find one. Hosts
+* disagree about which of the two they report for the second shape, so a driver
+* that reads only `ENOENT` opens on one host and fails closed on another over
+* the same tree.
+*
+* Every other code — a permission refusal, a symlink loop, an unreadable
+* existing file — is a real failure and stays one.
+*
+* A caught value that is not a coded `Error` is not a report about a path, so it
+* answers `false` rather than being read for a `code` any object could carry.
+*
+* @param error - The caught value to classify; any runtime is accepted
+* @returns `true` when the error reports that the path holds nothing
+*
+* @example
+* ```ts
+* matchesAbsentPath(Object.assign(new Error('gone'), { code: 'ENOENT' })) // true
+* matchesAbsentPath(Object.assign(new Error('denied'), { code: 'EACCES' })) // false
+* matchesAbsentPath('ENOENT') // false
+* ```
+*/
+function matchesAbsentPath(error) {
+	if (!(error instanceof Error) || !("code" in error)) return false;
+	return error.code === "ENOENT" || error.code === "ENOTDIR";
+}
+/**
 * Whether a value's runtime type matches a column's declared exact type —
 * the operand side of the declared-type-trust proof.
 *
@@ -1025,9 +1056,11 @@ var DriverIterator = class {
 * primary (the table contract), so the key is recovered on load with
 * {@link extractKey} and the file need not store it. The parsed JSON crosses the
 * boundary as `unknown` and is narrowed with {@link isRecord} / {@link extractKey},
-* never asserted (AGENTS §14). Only an `ENOENT` read starts empty; every other
-* read failure or invalid existing document fails closed without publication,
-* mutation, or automatic repair. It is scan-only — it implements none of
+* never asserted (AGENTS §14). A read that reports no document there starts empty —
+* `ENOENT` for a plain absence, and `ENOTDIR` for a path whose parent is not a
+* directory, which no later write could find either; every other read failure or
+* invalid existing document fails closed without publication, mutation, or
+* automatic repair. It is scan-only — it implements none of
 * the optional native `records` / `aggregate` hooks, so the core engine
 * over `scan` answers every query. For development, small datasets, and portable /
 * inspectable data; for large or concurrent workloads reach for a SQLite-backed
@@ -1439,7 +1472,7 @@ var JSONDriver = class {
 		try {
 			raw = await (0, node_fs_promises.readFile)(this.#path, "utf-8");
 		} catch (error) {
-			if (typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT") return;
+			if (matchesAbsentPath(error)) return void 0;
 			throw new _src_core.DatabaseError("DRIVER", "Failed to read the JSON database file", {
 				path: this.#path,
 				cause: error
@@ -1617,7 +1650,7 @@ var JSONDriver = class {
 			try {
 				await (0, node_fs_promises.rm)(temp, { force: true });
 			} catch (cleanup) {
-				throw new _src_core.DatabaseError("DRIVER", "Failed to persist and clean the database file", {
+				if (!matchesAbsentPath(cleanup)) throw new _src_core.DatabaseError("DRIVER", "Failed to persist and clean the database file", {
 					path: this.#path,
 					temp,
 					cause,
@@ -2476,6 +2509,7 @@ exports.escapeLike = escapeLike;
 exports.extractValues = extractValues;
 exports.findColumnStorage = findColumnStorage;
 exports.inferValueStorage = inferValueStorage;
+exports.matchesAbsentPath = matchesAbsentPath;
 exports.matchesAggregateExactly = matchesAggregateExactly;
 exports.matchesConditionExactly = matchesConditionExactly;
 exports.matchesDeclaredStorage = matchesDeclaredStorage;