@neottia/repository-store 0.2.0 → 0.3.0

package/native/windows_backend.cc

@@ -0,0 +1,179 @@
+#include "platform_backend.h"
+
+#define WIN32_LEAN_AND_MEAN
+#ifndef NOMINMAX
+#define NOMINMAX
+#endif
+#include <windows.h>
+
+#include <cerrno>
+#include <cstddef>
+#include <cstdint>
+#include <cstring>
+#include <cwchar>
+#include <string>
+#include <vector>
+
+namespace neottia::repository_store {
+namespace {
+
+int WindowsError(DWORD error) {
+  switch (error) {
+    case ERROR_FILE_EXISTS:
+    case ERROR_ALREADY_EXISTS:
+      return EEXIST;
+    case ERROR_FILE_NOT_FOUND:
+    case ERROR_PATH_NOT_FOUND:
+      return ENOENT;
+    case ERROR_NOT_SAME_DEVICE:
+      return EXDEV;
+    case ERROR_ACCESS_DENIED:
+      return EACCES;
+    case ERROR_SHARING_VIOLATION:
+    case ERROR_LOCK_VIOLATION:
+      return EBUSY;
+    case ERROR_INVALID_HANDLE:
+      return EBADF;
+    case ERROR_CALL_NOT_IMPLEMENTED:
+      return ENOSYS;
+    case ERROR_NOT_SUPPORTED:
+      return ENOTSUP;
+    case ERROR_INVALID_NAME:
+    case ERROR_BAD_PATHNAME:
+    case ERROR_INVALID_PARAMETER:
+      return EINVAL;
+    default:
+      return EIO;
+  }
+}
+
+int Utf8Path(const char* path, std::wstring* output) {
+  if (path == nullptr) return EINVAL;
+  const int required =
+      MultiByteToWideChar(CP_UTF8, MB_ERR_INVALID_CHARS, path, -1, nullptr, 0);
+  if (required == 0) return WindowsError(GetLastError());
+  std::vector<wchar_t> buffer(static_cast<std::size_t>(required));
+  if (MultiByteToWideChar(CP_UTF8, MB_ERR_INVALID_CHARS, path, -1,
+                          buffer.data(), required) == 0)
+    return WindowsError(GetLastError());
+  output->assign(buffer.data());
+  return 0;
+}
+
+int AbsolutePath(const char* path, std::wstring* output) {
+  std::wstring decoded;
+  const int decode_error = Utf8Path(path, &decoded);
+  if (decode_error != 0) return decode_error;
+  const DWORD required = GetFullPathNameW(decoded.c_str(), 0, nullptr, nullptr);
+  if (required == 0) return WindowsError(GetLastError());
+  std::vector<wchar_t> buffer(static_cast<std::size_t>(required));
+  const DWORD copied =
+      GetFullPathNameW(decoded.c_str(), required, buffer.data(), nullptr);
+  if (copied == 0 || copied >= required)
+    return copied == 0 ? WindowsError(GetLastError()) : EINVAL;
+  output->assign(buffer.data(), copied);
+  return 0;
+}
+
+std::wstring ExtendedPath(const std::wstring& path) {
+  if (path.rfind(L"\\\\?\\", 0) == 0) return path;
+  if (path.rfind(L"\\\\", 0) == 0) return L"\\\\?\\UNC\\" + path.substr(2);
+  return L"\\\\?\\" + path;
+}
+
+bool IsNtfs(const wchar_t* filesystem_name) {
+  return _wcsicmp(filesystem_name, L"NTFS") == 0;
+}
+
+}  // namespace
+
+const char* Platform() { return "win32"; }
+
+int RenameNoReplace(const char* source, const char* destination) {
+  std::wstring source_path;
+  int error = AbsolutePath(source, &source_path);
+  if (error != 0) return error;
+  std::wstring destination_path;
+  error = AbsolutePath(destination, &destination_path);
+  if (error != 0) return error;
+
+  const std::wstring extended_source = ExtendedPath(source_path);
+  const std::wstring extended_destination = ExtendedPath(destination_path);
+  HANDLE handle =
+      CreateFileW(extended_source.c_str(), DELETE | FILE_READ_ATTRIBUTES,
+                  FILE_SHARE_READ | FILE_SHARE_WRITE | FILE_SHARE_DELETE,
+                  nullptr, OPEN_EXISTING,
+                  FILE_ATTRIBUTE_NORMAL | FILE_FLAG_BACKUP_SEMANTICS |
+                      FILE_FLAG_OPEN_REPARSE_POINT,
+                  nullptr);
+  if (handle == INVALID_HANDLE_VALUE) return WindowsError(GetLastError());
+
+  FILE_ATTRIBUTE_TAG_INFO attributes = {};
+  if (!GetFileInformationByHandleEx(handle, FileAttributeTagInfo, &attributes,
+                                    sizeof(attributes))) {
+    error = WindowsError(GetLastError());
+    CloseHandle(handle);
+    return error;
+  }
+  if ((attributes.FileAttributes & FILE_ATTRIBUTE_REPARSE_POINT) != 0) {
+    CloseHandle(handle);
+    return EINVAL;
+  }
+
+  const std::size_t name_bytes = extended_destination.size() * sizeof(wchar_t);
+  if (name_bytes >
+      static_cast<std::size_t>(MAXDWORD) - sizeof(FILE_RENAME_INFO)) {
+    CloseHandle(handle);
+    return EINVAL;
+  }
+  std::vector<std::uint8_t> storage(sizeof(FILE_RENAME_INFO) + name_bytes);
+  auto* rename = reinterpret_cast<FILE_RENAME_INFO*>(storage.data());
+  rename->Flags = 0;
+  rename->RootDirectory = nullptr;
+  rename->FileNameLength = static_cast<DWORD>(name_bytes);
+  std::memcpy(rename->FileName, extended_destination.data(), name_bytes);
+
+  if (!SetFileInformationByHandle(handle, FileRenameInfoEx, rename,
+                                  static_cast<DWORD>(storage.size()))) {
+    error = WindowsError(GetLastError());
+    CloseHandle(handle);
+    return error;
+  }
+  if (!CloseHandle(handle)) return WindowsError(GetLastError());
+  return 0;
+}
+
+int SupportsLocalPath(const char* path, bool* supported) {
+  *supported = false;
+  std::wstring absolute;
+  int error = AbsolutePath(path, &absolute);
+  if (error != 0) return error;
+
+  const std::wstring extended = ExtendedPath(absolute);
+  const DWORD attributes = GetFileAttributesW(extended.c_str());
+  if (attributes == INVALID_FILE_ATTRIBUTES)
+    return WindowsError(GetLastError());
+  if ((attributes & FILE_ATTRIBUTE_REPARSE_POINT) != 0) return 0;
+
+  wchar_t volume_path[MAX_PATH + 1] = {};
+  if (!GetVolumePathNameW(absolute.c_str(), volume_path, MAX_PATH + 1))
+    return WindowsError(GetLastError());
+  if (GetDriveTypeW(volume_path) != DRIVE_FIXED) return 0;
+
+  DWORD filesystem_flags = 0;
+  wchar_t filesystem_name[MAX_PATH + 1] = {};
+  if (!GetVolumeInformationW(volume_path, nullptr, 0, nullptr, nullptr,
+                             &filesystem_flags, filesystem_name, MAX_PATH + 1))
+    return WindowsError(GetLastError());
+  const DWORD required =
+      FILE_SUPPORTS_HARD_LINKS | FILE_SUPPORTS_OPEN_BY_FILE_ID;
+  *supported =
+      IsNtfs(filesystem_name) && (filesystem_flags & required) == required;
+  return 0;
+}
+
+// Node and Bun own the Windows CRT descriptor table. The TypeScript adapter
+// uses their fsyncSync implementation, which can safely reach the owning table.
+int SyncDescriptor(int) { return ENOSYS; }
+
+}  // namespace neottia::repository_store

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neottia/repository-store",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Crash-recoverable repository-local canonical file and disposable SQLite storage primitives",
   "author": "Dragos Cirjan",
   "license": "MIT",
@@ -50,13 +50,13 @@
     "node": ">=22.16.0"
   },
   "dependencies": {
-    "node-gyp": "^11.5.0"
+    "node-gyp": "^13.0.2"
   },
   "devDependencies": {
-    "@templ-project/tsconfig": "^0.2.2",
-    "@types/node": "^25.0.3",
+    "@templ-project/tsconfig": "^0.4.2",
+    "@types/node": "^26.6.4",
     "typescript": "^5.9.3",
-    "vitest": "^4.1.11"
+    "vitest": "^5.0.3"
   },
   "scripts": {
     "build": "pnpm run build:native && node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.build.json",

package/scripts/install-native.mjs

@@ -1,10 +1,10 @@
 import { spawnSync } from 'node:child_process';
 
-if (process.platform === 'linux') {
+if (process.platform === 'linux' || process.platform === 'darwin' || process.platform === 'win32') {
   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.',
+      '@neottia/repository-store: native platform backend was not built; destructive filesystem mutations will fail with UNSUPPORTED_RUNTIME.',
     );
 }

package/dist/internal/native-publication.d.ts

@@ -1,9 +0,0 @@
-export interface NativePublicationBackend {
-    renameNoReplace(source: string, destination: string): void;
-    supportsLocalPath(path: string): boolean;
-}
-export declare function requireNativePublicationBackend(): NativePublicationBackend;
-export declare function nativeRenameNoReplace(backend: NativePublicationBackend, source: string, destination: string): void;
-export declare function assertNativePublicationPath(backend: NativePublicationBackend, path: string): void;
-export declare function setNativePublicationBackendForTests(backend: NativePublicationBackend | null | undefined): void;
-//# sourceMappingURL=native-publication.d.ts.map

package/dist/internal/native-publication.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"native-publication.d.ts","sourceRoot":"","sources":["../../src/internal/native-publication.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,wBAAwB;IACvC,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3D,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1C;AAOD,wBAAgB,+BAA+B,IAAI,wBAAwB,CAuB1E;AAGD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,wBAAwB,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAQlH;AAGD,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,wBAAwB,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAOjG;AAGD,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAE9G"}

package/dist/internal/native-publication.js

@@ -1,65 +0,0 @@
-import { createRequire } from 'node:module';
-import { fileURLToPath } from 'node:url';
-import { UnsupportedRuntimeError } from '../errors.js';
-let injectedBackend;
-let loadedBackend;
-let loadFailure;
-export function requireNativePublicationBackend() {
-    if (injectedBackend !== undefined) {
-        if (injectedBackend !== null)
-            return injectedBackend;
-        throw unsupported('Native publication backend is disabled for this operation.');
-    }
-    if (process.platform !== 'linux')
-        throw unsupported(`Exact destructive publication is unsupported on ${process.platform}.`);
-    if (loadedBackend !== undefined)
-        return loadedBackend;
-    if (loadFailure !== undefined)
-        throw unsupported('Native publication backend could not be loaded.', loadFailure);
-    try {
-        const require = createRequire(import.meta.url);
-        const packageRoot = fileURLToPath(new URL('../../', import.meta.url));
-        const candidate = require(`${packageRoot}build/Release/repository_store_native.node`);
-        if (typeof candidate.renameNoReplace !== 'function' || typeof candidate.supportsLocalPath !== 'function')
-            throw new Error('Native addon does not expose the complete publication contract.');
-        loadedBackend = candidate;
-        return loadedBackend;
-    }
-    catch (error) {
-        loadFailure = error;
-        throw unsupported('Native publication backend could not be loaded.', error);
-    }
-}
-export function nativeRenameNoReplace(backend, source, destination) {
-    try {
-        backend.renameNoReplace(source, destination);
-    }
-    catch (error) {
-        if (['EINVAL', 'EXDEV', 'ENOSYS', 'ENOTSUP', 'EOPNOTSUPP'].some((code) => hasCode(error, code)))
-            throw unsupported(`Native no-replace move is unsupported for ${source}.`, error);
-        throw error;
-    }
-}
-export function assertNativePublicationPath(backend, path) {
-    try {
-        if (backend.supportsLocalPath(path))
-            return;
-    }
-    catch (error) {
-        throw unsupported(`Native filesystem capability check failed for ${path}.`, error);
-    }
-    throw unsupported(`Exact destructive publication requires a supported Linux local filesystem: ${path}.`);
-}
-export function setNativePublicationBackendForTests(backend) {
-    injectedBackend = backend;
-}
-function hasCode(error, code) {
-    return typeof error === 'object' && error !== null && 'code' in error && error.code === code;
-}
-function unsupported(message, cause) {
-    const error = new UnsupportedRuntimeError(message);
-    if (cause !== undefined)
-        Object.defineProperty(error, 'cause', { value: cause });
-    return error;
-}
-//# sourceMappingURL=native-publication.js.map

package/dist/internal/native-publication.js.map

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