@orkestrel/database 0.0.7 → 0.0.9

package/dist/src/server/index.d.cts

@@ -1,26 +1,26 @@
-import { AggregateOperation } from '../core/index.ts';
-import { AggregateOperation as AggregateOperation_2 } from '../../core/index.ts';
-import { ColumnSchema } from '../core/index.ts';
-import { ColumnStorage } from '../core/index.ts';
-import { Condition } from '../core/index.ts';
-import { DriverInterface } from '../core/index.ts';
-import { DriverInterface as DriverInterface_2 } from '../../core/index.ts';
-import { DriverMetadata } from '../../core/index.ts';
+import { AggregateOperation } from '@orkestrel/database';
+import { AggregateOperation as AggregateOperation_2 } from '@orkestrel/database';
+import { ColumnSchema } from '@orkestrel/database';
+import { ColumnStorage } from '@orkestrel/database';
+import { Condition } from '@orkestrel/database';
+import { DriverInterface } from '@orkestrel/database';
+import { DriverInterface as DriverInterface_2 } from '@orkestrel/database';
+import { DriverMetadata } from '@orkestrel/database';
 import { FieldPath } from '@orkestrel/contract';
-import { Key } from '../../core/index.ts';
-import { MigrationInput } from '../../core/index.ts';
-import { MigrationStep } from '../core/index.ts';
-import { OperationOptions } from '../../core/index.ts';
-import { Order } from '../core/index.ts';
-import { QueryInput } from '../core/index.ts';
-import { QueryInput as QueryInput_2 } from '../../core/index.ts';
-import { Row } from '../core/index.ts';
-import { Row as Row_2 } from '../../core/index.ts';
+import { Key } from '@orkestrel/database';
+import { MigrationInput } from '@orkestrel/database';
+import { MigrationStep } from '@orkestrel/database';
+import { OperationOptions } from '@orkestrel/database';
+import { Order } from '@orkestrel/database';
+import { QueryInput } from '@orkestrel/database';
+import { QueryInput as QueryInput_2 } from '@orkestrel/database';
+import { Row } from '@orkestrel/database';
+import { Row as Row_2 } from '@orkestrel/database';
 import { SQLiteRow } from '@orkestrel/sqlite';
 import { SQLiteValue } from '@orkestrel/sqlite';
-import { StorageInterface } from '../../core/index.ts';
-import { TableSchema } from '../core/index.ts';
-import { TableSchema as TableSchema_2 } from '../../core/index.ts';
+import { StorageInterface } from '@orkestrel/database';
+import { TableSchema } from '@orkestrel/database';
+import { TableSchema as TableSchema_2 } from '@orkestrel/database';
 
 /**
  * Compile an {@link AggregateOperation} over a {@link FieldPath}.
@@ -545,9 +545,11 @@ export declare function inferValueStorage(value: unknown): ColumnStorage;
  * 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
@@ -643,6 +645,35 @@ export declare class JSONDriver implements DriverInterface_2 {
     migrate(input: MigrationInput): Promise<void>;
 }
 
+/**
+ * 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
+ * ```
+ */
+export declare function matchesAbsentPath(error: unknown): boolean;
+
 /**
  * Determine whether SQLite can execute an aggregate exactly like the core engine.
  *

package/dist/src/server/index.d.ts

@@ -1,26 +1,26 @@
-import { AggregateOperation } from '../core/index.ts';
-import { AggregateOperation as AggregateOperation_2 } from '../../core/index.ts';
-import { ColumnSchema } from '../core/index.ts';
-import { ColumnStorage } from '../core/index.ts';
-import { Condition } from '../core/index.ts';
-import { DriverInterface } from '../core/index.ts';
-import { DriverInterface as DriverInterface_2 } from '../../core/index.ts';
-import { DriverMetadata } from '../../core/index.ts';
+import { AggregateOperation } from '@orkestrel/database';
+import { AggregateOperation as AggregateOperation_2 } from '@orkestrel/database';
+import { ColumnSchema } from '@orkestrel/database';
+import { ColumnStorage } from '@orkestrel/database';
+import { Condition } from '@orkestrel/database';
+import { DriverInterface } from '@orkestrel/database';
+import { DriverInterface as DriverInterface_2 } from '@orkestrel/database';
+import { DriverMetadata } from '@orkestrel/database';
 import { FieldPath } from '@orkestrel/contract';
-import { Key } from '../../core/index.ts';
-import { MigrationInput } from '../../core/index.ts';
-import { MigrationStep } from '../core/index.ts';
-import { OperationOptions } from '../../core/index.ts';
-import { Order } from '../core/index.ts';
-import { QueryInput } from '../core/index.ts';
-import { QueryInput as QueryInput_2 } from '../../core/index.ts';
-import { Row } from '../core/index.ts';
-import { Row as Row_2 } from '../../core/index.ts';
+import { Key } from '@orkestrel/database';
+import { MigrationInput } from '@orkestrel/database';
+import { MigrationStep } from '@orkestrel/database';
+import { OperationOptions } from '@orkestrel/database';
+import { Order } from '@orkestrel/database';
+import { QueryInput } from '@orkestrel/database';
+import { QueryInput as QueryInput_2 } from '@orkestrel/database';
+import { Row } from '@orkestrel/database';
+import { Row as Row_2 } from '@orkestrel/database';
 import { SQLiteRow } from '@orkestrel/sqlite';
 import { SQLiteValue } from '@orkestrel/sqlite';
-import { StorageInterface } from '../../core/index.ts';
-import { TableSchema } from '../core/index.ts';
-import { TableSchema as TableSchema_2 } from '../../core/index.ts';
+import { StorageInterface } from '@orkestrel/database';
+import { TableSchema } from '@orkestrel/database';
+import { TableSchema as TableSchema_2 } from '@orkestrel/database';
 
 /**
  * Compile an {@link AggregateOperation} over a {@link FieldPath}.
@@ -545,9 +545,11 @@ export declare function inferValueStorage(value: unknown): ColumnStorage;
  * 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
@@ -643,6 +645,35 @@ export declare class JSONDriver implements DriverInterface_2 {
     migrate(input: MigrationInput): Promise<void>;
 }
 
+/**
+ * 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
+ * ```
+ */
+export declare function matchesAbsentPath(error: unknown): boolean;
+
 /**
  * Determine whether SQLite can execute an aggregate exactly like the core engine.
  *

package/dist/src/server/index.js

@@ -55,6 +55,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.
 *
@@ -1024,9 +1055,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
@@ -1438,7 +1471,7 @@ var JSONDriver = class {
 		try {
 			raw = await 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 DatabaseError("DRIVER", "Failed to read the JSON database file", {
 				path: this.#path,
 				cause: error
@@ -1616,7 +1649,7 @@ var JSONDriver = class {
 			try {
 				await rm(temp, { force: true });
 			} catch (cleanup) {
-				throw new DatabaseError("DRIVER", "Failed to persist and clean the database file", {
+				if (!matchesAbsentPath(cleanup)) throw new DatabaseError("DRIVER", "Failed to persist and clean the database file", {
 					path: this.#path,
 					temp,
 					cause,
@@ -2450,6 +2483,6 @@ function createSQLiteDriver(options) {
 	return new SQLiteDriver(options);
 }
 //#endregion
-export { EXACT_COLUMN_STORAGE, EXACT_RANGE_COLUMN_STORAGE, JSONDriver, METADATA_TABLE, SQLiteDriver, compileAggregateSQL, compileColumnSQL, compileConditionSQL, compileFieldSQL, compileJSONTypeSQL, compileOrder, compilePage, compileQuerySQL, compileWhere, createJSONDriver, createSQLiteDriver, decodeRow, decodeValue, deriveSQLiteIndexName, encodeRow, encodeValue, escapeLike, extractValues, findColumnStorage, inferValueStorage, matchesAggregateExactly, matchesConditionExactly, matchesDeclaredStorage, matchesOrderExactly, matchesQueryExactly, matchesSQLiteAffinity, quoteIdentifier, schemaToIndexes, schemaToTable, stepToSQL };
+export { EXACT_COLUMN_STORAGE, EXACT_RANGE_COLUMN_STORAGE, JSONDriver, METADATA_TABLE, SQLiteDriver, compileAggregateSQL, compileColumnSQL, compileConditionSQL, compileFieldSQL, compileJSONTypeSQL, compileOrder, compilePage, compileQuerySQL, compileWhere, createJSONDriver, createSQLiteDriver, decodeRow, decodeValue, deriveSQLiteIndexName, encodeRow, encodeValue, escapeLike, extractValues, findColumnStorage, inferValueStorage, matchesAbsentPath, matchesAggregateExactly, matchesConditionExactly, matchesDeclaredStorage, matchesOrderExactly, matchesQueryExactly, matchesSQLiteAffinity, quoteIdentifier, schemaToIndexes, schemaToTable, stepToSQL };
 
 //# sourceMappingURL=index.js.map