@harperfast/rocksdb-js 1.3.0 → 1.4.0

package/dist/index.d.cts

@@ -1415,13 +1415,16 @@ declare class RocksDatabase extends DBI<DBITransactional> {
 //#endregion
 //#region src/parse-transaction-log.d.ts
 interface LogEntry {
-  data: Buffer;
+  anomalies?: string[];
+  data?: Buffer;
   flags: number;
   length: number;
   timestamp?: number;
 }
 interface TransactionLog$1 {
+  anomalies: string[];
   entries: LogEntry[];
+  entryAnomalyCount: number;
   timestamp: number;
   size: number;
   version: number;
@@ -1431,7 +1434,9 @@ interface TransactionLog$1 {
 * @param path - The path to the transaction log file.
 * @returns The transaction log.
 */
-declare function parseTransactionLog(path: string): TransactionLog$1;
+declare function parseTransactionLog(path: string, options?: {
+  skipData?: boolean;
+}): TransactionLog$1;
 //#endregion
 //#region src/index.d.ts
 declare const versions: {

package/dist/index.d.mts

@@ -1415,13 +1415,16 @@ declare class RocksDatabase extends DBI<DBITransactional> {
 //#endregion
 //#region src/parse-transaction-log.d.ts
 interface LogEntry {
-  data: Buffer;
+  anomalies?: string[];
+  data?: Buffer;
   flags: number;
   length: number;
   timestamp?: number;
 }
 interface TransactionLog$1 {
+  anomalies: string[];
   entries: LogEntry[];
+  entryAnomalyCount: number;
   timestamp: number;
   size: number;
   version: number;
@@ -1431,7 +1434,9 @@ interface TransactionLog$1 {
 * @param path - The path to the transaction log file.
 * @returns The transaction log.
 */
-declare function parseTransactionLog(path: string): TransactionLog$1;
+declare function parseTransactionLog(path: string, options?: {
+  skipData?: boolean;
+}): TransactionLog$1;
 //#endregion
 //#region src/index.d.ts
 declare const versions: {

package/dist/index.mjs

@@ -570,6 +570,8 @@ const VALUE_BUFFER = createFixedBuffer(64 * 1024);
 const ITERATOR_STATE_BUFFER = Buffer.allocUnsafeSlow(8);
 const ITERATOR_STATE = new Uint32Array(ITERATOR_STATE_BUFFER.buffer, ITERATOR_STATE_BUFFER.byteOffset, 2);
 const MAX_KEY_SIZE = 1024 * 1024;
+const RESET_BUFFER_MODE = 1024;
+const REUSE_BUFFER_MODE = 512;
 const SAVE_BUFFER_SIZE = 8192;
 /**
 * A store wraps the `NativeDatabase` binding and database settings so that a
@@ -859,7 +861,7 @@ var Store = class {
 	encodeValue(value) {
 		if (value && value["binary-data"]) return value["binary-data"];
 		if (typeof this.encoder?.encode === "function") {
-			if (this.encoder.copyBuffers) return this.encoder.encode(value, 1536);
+			if (this.encoder.copyBuffers) return this.encoder.encode(value, REUSE_BUFFER_MODE | RESET_BUFFER_MODE);
 			const valueBuffer = this.encoder.encode(value);
 			if (typeof valueBuffer === "string") return Buffer.from(valueBuffer);
 			return valueBuffer;
@@ -1833,12 +1835,14 @@ var RocksDatabase = class RocksDatabase extends DBI {
 //#endregion
 //#region src/parse-transaction-log.ts
 const { TRANSACTION_LOG_TOKEN } = constants;
+const MIN_VALID_TIMESTAMP = Date.UTC(2026, 0, 27);
+const VALID_FLAGS_MASK = 1;
 /**
 * Loads an entire transaction log file into memory.
 * @param path - The path to the transaction log file.
 * @returns The transaction log.
 */
-function parseTransactionLog(path) {
+function parseTransactionLog(path, options = {}) {
 	let stats;
 	try {
 		stats = statSync(path);
@@ -1862,7 +1866,10 @@ function parseTransactionLog(path) {
 		const version = read(1).readUInt8(0);
 		if (version !== 1) throw new Error(`Unsupported transaction log file version: ${version}`);
 		const timestamp = read(8).readDoubleBE(0);
+		const anomalies = [];
+		if (!Number.isFinite(timestamp) || timestamp < MIN_VALID_TIMESTAMP) anomalies.push(`Header timestamp ${timestamp} predates 2026-01-27 (possible corruption)`);
 		const entries = [];
+		let entryAnomalyCount = 0;
 		while (fileOffset < size) {
 			const timestamp = read(8).readDoubleBE(0);
 			if (timestamp === 0) {
@@ -1872,15 +1879,25 @@ function parseTransactionLog(path) {
 			const length = read(4).readUInt32BE(0);
 			const flags = read(1).readUInt8(0);
 			const data = read(length);
-			entries.push({
+			const entryAnomalies = [];
+			if (!Number.isFinite(timestamp) || timestamp < MIN_VALID_TIMESTAMP) entryAnomalies.push(`timestamp ${timestamp} predates 2026-01-27 (possible corruption)`);
+			if ((flags & ~VALID_FLAGS_MASK) !== 0) entryAnomalies.push(`flags 0x${flags.toString(16).padStart(2, "0")} contains undefined bits (expected 0x00 or 0x01)`);
+			const entry = {
 				timestamp,
 				length,
 				flags,
-				data
-			});
+				data: options.skipData ? void 0 : Buffer.from(data)
+			};
+			if (entryAnomalies.length > 0) {
+				entry.anomalies = entryAnomalies;
+				entryAnomalyCount += entryAnomalies.length;
+			}
+			entries.push(entry);
 		}
 		return {
+			anomalies,
 			entries,
+			entryAnomalyCount,
 			timestamp,
 			size,
 			version
@@ -2073,7 +2090,7 @@ function loadLastPosition(transactionLog, readUncommitted) {
 //#region src/index.ts
 const versions = {
 	rocksdb: version,
-	"rocksdb-js": "1.3.0"
+	"rocksdb-js": "1.4.0"
 };
 
 //#endregion