@neottia/repository-store 0.2.0

package/dist/transaction/recovery.js

@@ -0,0 +1,138 @@
+import { lstatSync, readdirSync, renameSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { RecoveryError } from '../errors.js';
+import { readManagedFileIfExists } from '../files.js';
+import { publishTransition } from './apply.js';
+import { cleanupIncompleteJournal, cleanupJournal, readArtifact, readManifest, transactionRoot, validateArtifacts, } from './journal.js';
+import { emitTransactionFault } from '../internal/fault-injection.js';
+import { assertSafeRegular, syncDirectory } from '../internal/filesystem.js';
+import { getPathState, getRootState } from '../internal/model.js';
+import { recoverExactPublication } from '../internal/publication.js';
+import { assertLiveLease, checkControl } from '../lease.js';
+import { resolveManagedPath, validateRelativePath } from '../paths.js';
+const STATE_NAME = /^([0-9a-f]{64})\.(prepare|active|committed|cleanup)$/u;
+export async function recoverCanonicalTransactions(root, lease, options = {}) {
+    assertLiveLease(root, lease);
+    checkControl(options);
+    const state = requireRootState(root);
+    const transactions = transactionRoot(state.authorityRoot, state.managedRootId);
+    const report = { rolledBack: [], cleanedPrepared: [], cleanedCommitted: [] };
+    for (const name of readdirSync(transactions).sort()) {
+        checkControl(options);
+        const match = STATE_NAME.exec(name);
+        if (match === null)
+            continue;
+        const transactionId = match[1];
+        const phase = match[2];
+        const directory = join(transactions, name);
+        const stat = lstatSync(directory);
+        if (stat.isSymbolicLink() || !stat.isDirectory())
+            throw malformed(`Unsafe transaction state path: ${directory}`);
+        if (phase === 'prepare' || phase === 'cleanup') {
+            cleanupIncompleteJournal(directory, transactionId, {
+                maxJournalBytes: state.limits.maxJournalBytes,
+                maxArtifactBytes: Math.max(state.limits.maxBeforeImageBytes, state.limits.maxTemporaryBytes),
+            });
+            if (phase === 'prepare')
+                report.cleanedPrepared.push(transactionId);
+            else
+                report.cleanedCommitted.push(transactionId);
+            continue;
+        }
+        const manifest = readAndValidateManifest(root, directory, transactionId);
+        if (phase === 'active') {
+            await recoverActiveDirectory(root, lease, directory, options);
+            report.rolledBack.push(manifest.transactionId);
+        }
+        else {
+            const cleanup = transitionToCleanup(directory, transactionId);
+            cleanupJournal(cleanup, manifest);
+            report.cleanedCommitted.push(manifest.transactionId);
+        }
+    }
+    return report;
+}
+export async function recoverActiveDirectory(root, lease, directory, options) {
+    const state = requireRootState(root);
+    const transactionId = directory.split(/[\\/]/u).at(-1)?.split('.')[0];
+    if (transactionId === undefined)
+        throw malformed('Active transaction path has no identity.');
+    const manifest = readAndValidateManifest(root, directory, transactionId);
+    for (const entry of [...manifest.entries].reverse()) {
+        checkControl(options);
+        const path = resolveManagedPath(root, entry.path);
+        const pathState = getPathState(path);
+        if (pathState === undefined)
+            throw malformed('Recovered path is not a repository-store handle.');
+        recoverExactPublication(pathState.absolutePath, manifest.transactionId, [entry.originalRevision, entry.intendedRevision], state.limits.maxFileBytes);
+        const current = await readManagedFileIfExists(root, lease, path, options);
+        const revision = current?.revision ?? null;
+        if (revision === entry.originalRevision)
+            continue;
+        if (revision !== entry.intendedRevision)
+            throw new RecoveryError('Canonical state differs from both journal revisions.', 'RECOVERY_AMBIGUOUS', {
+                transactionId: manifest.transactionId,
+                path: entry.path,
+                currentRevision: revision,
+                originalRevision: entry.originalRevision,
+                intendedRevision: entry.intendedRevision,
+            });
+        const original = entry.beforeArtifact === null
+            ? null
+            : readArtifact(directory, entry.beforeArtifact, state.limits.maxBeforeImageBytes);
+        const identity = current === undefined ? undefined : lstatSync(pathState.absolutePath);
+        if (identity !== undefined)
+            assertSafeRegular(identity, pathState.absolutePath);
+        publishTransition(pathState.absolutePath, original, manifest.transactionId, current === undefined
+            ? undefined
+            : {
+                identity: identity,
+                revision: current.revision,
+                maxBytes: state.limits.maxFileBytes,
+            });
+    }
+    for (const entry of manifest.entries) {
+        const path = resolveManagedPath(root, entry.path);
+        const current = await readManagedFileIfExists(root, lease, path, options);
+        if ((current?.revision ?? null) !== entry.originalRevision)
+            throw new RecoveryError('Rollback verification did not restore original revision.', 'RECOVERY_AMBIGUOUS', {
+                transactionId: manifest.transactionId,
+                path: entry.path,
+            });
+    }
+    const cleanup = transitionToCleanup(directory, manifest.transactionId);
+    cleanupJournal(cleanup, manifest);
+}
+function readAndValidateManifest(root, directory, transactionId) {
+    const state = requireRootState(root);
+    const manifest = readManifest(directory, state.limits.maxJournalBytes);
+    if (manifest.transactionId !== transactionId ||
+        manifest.authorityId !== state.authorityId ||
+        manifest.managedRootId !== state.managedRootId)
+        throw malformed('Transaction identity does not match its authority, managed root, or directory name.');
+    for (const entry of manifest.entries)
+        validateRelativePath(entry.path);
+    validateArtifacts(directory, manifest, {
+        maxBeforeImageBytes: state.limits.maxBeforeImageBytes,
+        maxTemporaryBytes: state.limits.maxTemporaryBytes,
+    });
+    return manifest;
+}
+function transitionToCleanup(directory, transactionId) {
+    const cleanup = join(dirname(directory), `${transactionId}.cleanup`);
+    renameSync(directory, cleanup);
+    emitTransactionFault('cleanup-state-renamed');
+    syncDirectory(dirname(directory));
+    emitTransactionFault('cleanup-state-synced');
+    return cleanup;
+}
+function requireRootState(root) {
+    const state = getRootState(root);
+    if (state === undefined)
+        throw malformed('Managed root is not a repository-store handle.');
+    return state;
+}
+function malformed(message) {
+    return new RecoveryError(message, 'RECOVERY_MALFORMED');
+}
+//# sourceMappingURL=recovery.js.map

package/dist/transaction/recovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.js","sourceRoot":"","sources":["../../src/transaction/recovery.ts"],"names":[],"mappings":"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"}

package/dist/transaction/types.d.ts

@@ -0,0 +1,45 @@
+import type { ManagedPath } from '../internal/model.js';
+import type { OperationControl } from '../lease.js';
+import type { ByteRevision } from '../revision.js';
+export type CanonicalOperation = {
+    readonly kind: 'write';
+    readonly path: ManagedPath;
+    readonly bytes: Uint8Array;
+    readonly expected: 'absent' | ByteRevision;
+} | {
+    readonly kind: 'remove';
+    readonly path: ManagedPath;
+    readonly expected: ByteRevision;
+} | {
+    readonly kind: 'move';
+    readonly from: ManagedPath;
+    readonly to: ManagedPath;
+    readonly expectedSource: ByteRevision;
+    readonly expectedDestination: 'absent' | ByteRevision;
+};
+export interface ApplyCanonicalBatchOptions extends OperationControl {
+    readonly inventory?: readonly ManagedPath[];
+}
+export interface RecoveryReport {
+    readonly rolledBack: readonly string[];
+    readonly cleanedPrepared: readonly string[];
+    readonly cleanedCommitted: readonly string[];
+}
+export interface JournalEntry {
+    readonly path: string;
+    readonly originalRevision: ByteRevision | null;
+    readonly intendedRevision: ByteRevision | null;
+    readonly beforeArtifact: string | null;
+    readonly stagedArtifact: string | null;
+    readonly bytes: number;
+}
+export interface JournalManifest {
+    readonly version: 1;
+    readonly transactionId: string;
+    readonly authorityId: string;
+    readonly managedRootId: string;
+    readonly entries: readonly JournalEntry[];
+    readonly createdAt: string;
+    readonly digest: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/transaction/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/transaction/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGnD,MAAM,MAAM,kBAAkB,GAC1B;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,YAAY,CAAC;CAC5C,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;CACjC,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,YAAY,CAAC;IACtC,QAAQ,CAAC,mBAAmB,EAAE,QAAQ,GAAG,YAAY,CAAC;CACvD,CAAC;AAGN,MAAM,WAAW,0BAA2B,SAAQ,gBAAgB;IAElE,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;CAC7C;AAGD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9C;AAGD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,gBAAgB,EAAE,YAAY,GAAG,IAAI,CAAC;IAC/C,QAAQ,CAAC,gBAAgB,EAAE,YAAY,GAAG,IAAI,CAAC;IAC/C,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAGD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB"}

package/dist/transaction/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/transaction/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/transaction/types.ts"],"names":[],"mappings":""}

package/native/rename_noreplace.cc

@@ -0,0 +1,145 @@
+#include <node_api.h>
+
+#include <cerrno>
+#include <cstring>
+
+#ifdef __linux__
+#include <fcntl.h>
+#include <linux/fs.h>
+#include <linux/magic.h>
+#include <stdio.h>
+#include <sys/vfs.h>
+#endif
+
+namespace {
+
+const char* ErrnoCode(int value) {
+  switch (value) {
+    case EEXIST:
+      return "EEXIST";
+    case ENOENT:
+      return "ENOENT";
+    case EXDEV:
+      return "EXDEV";
+    case ENOSYS:
+      return "ENOSYS";
+    case ENOTSUP:
+      return "ENOTSUP";
+    case EINVAL:
+      return "EINVAL";
+    case EPERM:
+      return "EPERM";
+    case EACCES:
+      return "EACCES";
+    default:
+      return "EIO";
+  }
+}
+
+void ThrowErrno(napi_env env, int value) {
+  napi_value message;
+  napi_create_string_utf8(env, std::strerror(value), NAPI_AUTO_LENGTH, &message);
+  napi_value error;
+  napi_create_error(env, nullptr, message, &error);
+  napi_value code;
+  napi_create_string_utf8(env, ErrnoCode(value), NAPI_AUTO_LENGTH, &code);
+  napi_set_named_property(env, error, "code", code);
+  napi_throw(env, error);
+}
+
+bool ReadPath(napi_env env, napi_value value, char** output) {
+  size_t length = 0;
+  if (napi_get_value_string_utf8(env, value, nullptr, 0, &length) != napi_ok) return false;
+  *output = new char[length + 1];
+  size_t copied = 0;
+  if (napi_get_value_string_utf8(env, value, *output, length + 1, &copied) != napi_ok) {
+    delete[] *output;
+    *output = nullptr;
+    return false;
+  }
+  return true;
+}
+
+napi_value RenameNoReplace(napi_env env, napi_callback_info info) {
+  size_t argc = 2;
+  napi_value argv[2];
+  napi_get_cb_info(env, info, &argc, argv, nullptr, nullptr);
+  if (argc != 2) {
+    napi_throw_type_error(env, nullptr, "renameNoReplace requires source and destination paths");
+    return nullptr;
+  }
+  char* source = nullptr;
+  char* destination = nullptr;
+  if (!ReadPath(env, argv[0], &source) || !ReadPath(env, argv[1], &destination)) {
+    delete[] source;
+    delete[] destination;
+    napi_throw_type_error(env, nullptr, "renameNoReplace paths must be strings");
+    return nullptr;
+  }
+#ifdef __linux__
+  const int result = renameat2(AT_FDCWD, source, AT_FDCWD, destination, RENAME_NOREPLACE);
+  const int saved_errno = errno;
+#else
+  const int result = -1;
+  const int saved_errno = ENOSYS;
+#endif
+  delete[] source;
+  delete[] destination;
+  if (result != 0) {
+    ThrowErrno(env, saved_errno);
+    return nullptr;
+  }
+  napi_value undefined;
+  napi_get_undefined(env, &undefined);
+  return undefined;
+}
+
+napi_value SupportsLocalPath(napi_env env, napi_callback_info info) {
+  size_t argc = 1;
+  napi_value argv[1];
+  napi_get_cb_info(env, info, &argc, argv, nullptr, nullptr);
+  char* path = nullptr;
+  if (argc != 1 || !ReadPath(env, argv[0], &path)) {
+    napi_throw_type_error(env, nullptr, "supportsLocalPath requires one path");
+    return nullptr;
+  }
+  bool supported = false;
+#ifdef __linux__
+  struct statfs state;
+  if (statfs(path, &state) != 0) {
+    const int saved_errno = errno;
+    delete[] path;
+    ThrowErrno(env, saved_errno);
+    return nullptr;
+  }
+  switch (state.f_type) {
+    case EXT4_SUPER_MAGIC:
+    case XFS_SUPER_MAGIC:
+    case BTRFS_SUPER_MAGIC:
+    case TMPFS_MAGIC:
+    case OVERLAYFS_SUPER_MAGIC:
+      supported = true;
+      break;
+    default:
+      supported = false;
+  }
+#endif
+  delete[] path;
+  napi_value result;
+  napi_get_boolean(env, supported, &result);
+  return result;
+}
+
+napi_value Initialize(napi_env env, napi_value exports) {
+  napi_value rename_function;
+  napi_create_function(env, "renameNoReplace", NAPI_AUTO_LENGTH, RenameNoReplace, nullptr, &rename_function);
+  napi_set_named_property(env, exports, "renameNoReplace", rename_function);
+  napi_value supports_function;
+  napi_create_function(env, "supportsLocalPath", NAPI_AUTO_LENGTH, SupportsLocalPath, nullptr, &supports_function);
+  napi_set_named_property(env, exports, "supportsLocalPath", supports_function);
+  return exports;
+}
+
+}  // namespace
+
+NAPI_MODULE(NODE_GYP_MODULE_NAME, Initialize)

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@neottia/repository-store",
+  "version": "0.2.0",
+  "description": "Crash-recoverable repository-local canonical file and disposable SQLite storage primitives",
+  "author": "Dragos Cirjan",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dragoscirjan/neottia.git",
+    "directory": "packages/repository-store"
+  },
+  "bugs": {
+    "url": "https://github.com/dragoscirjan/neottia/issues"
+  },
+  "homepage": "https://github.com/dragoscirjan/neottia#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "testing": [
+        "dist/testing.d.ts"
+      ]
+    }
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "default": "./dist/testing.js"
+    }
+  },
+  "files": [
+    "dist",
+    "native",
+    "scripts/install-native.mjs",
+    "binding.gyp",
+    "README.md",
+    "LICENSE"
+  ],
+  "gypfile": true,
+  "engines": {
+    "node": ">=22.16.0"
+  },
+  "dependencies": {
+    "node-gyp": "^11.5.0"
+  },
+  "devDependencies": {
+    "@templ-project/tsconfig": "^0.2.2",
+    "@types/node": "^25.0.3",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.11"
+  },
+  "scripts": {
+    "build": "pnpm run build:native && node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.build.json",
+    "build:native": "node-gyp rebuild",
+    "install": "node scripts/install-native.mjs",
+    "test": "pnpm run test:node && pnpm run test:bun && pnpm run test:cross-runtime",
+    "test:node": "pnpm run build && vitest run --root ../.. packages/repository-store/src/repository-store.spec.ts packages/repository-store/src/sqlite/cache.spec.ts packages/repository-store/src/sqlite/node-adapter.spec.ts",
+    "test:bun": "pnpm run build && bun test ./src/sqlite/bun-adapter.bun.test.ts ./src/publication.bun.test.ts",
+    "test:cross-runtime": "pnpm run build && vitest run --root ../.. packages/repository-store/src/sqlite/cross-runtime.spec.ts",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/scripts/install-native.mjs

@@ -0,0 +1,10 @@
+import { spawnSync } from 'node:child_process';
+
+if (process.platform === 'linux') {
+  const command = process.platform === 'win32' ? 'node-gyp.cmd' : 'node-gyp';
+  const result = spawnSync(command, ['rebuild'], { stdio: 'inherit', shell: true });
+  if (result.status !== 0)
+    console.warn(
+      '@neottia/repository-store: native exact-publication backend was not built; destructive filesystem mutations will fail with UNSUPPORTED_RUNTIME.',
+    );
+}