@archildata/client 0.1.0

package/README.md

@@ -0,0 +1,126 @@
+# @archil/node
+
+High-performance Node.js bindings for the Archil distributed filesystem client.
+
+## Overview
+
+This package provides low-level N-API bindings to the Archil client library, exposing the `ArchilService` trait methods directly to JavaScript/TypeScript. It's designed for use cases where you need direct protocol access without FUSE overhead.
+
+## Installation
+
+```bash
+npm install @archil/node
+```
+
+## Usage
+
+```typescript
+import { ArchilClient } from '@archil/node';
+
+// Connect to Archil (authenticated via mount server)
+const client = await ArchilClient.connectAuthenticated({
+  mountServer: 'https://mount.archil.io',
+  mountName: 'my-account/my-disk',
+});
+
+// Get root directory attributes
+const rootAttrs = await client.getAttributes(1n);
+console.log('Root size:', rootAttrs.size);
+
+// List directory contents
+const entries = await client.readDirectory(1n);
+for (const entry of entries) {
+  console.log(`${entry.name} (inode: ${entry.inodeId})`);
+}
+
+// Read a file
+const lookup = await client.lookupInode(1n, 'myfile.txt');
+const data = await client.readInode(lookup.inodeId, 0n, 1024);
+console.log('File content:', data.toString());
+
+// Close when done
+await client.close();
+```
+
+## API
+
+### `ArchilClient`
+
+The main client class for interacting with Archil filesystems.
+
+#### Connection Methods
+
+- `connectDirect(config)` - Connect directly to a server (for testing)
+- `connectAuthenticated(config)` - Connect via mount server with authentication
+
+#### Metadata Operations
+
+- `getAttributes(inodeId, user?)` - Get inode attributes
+- `lookupInode(parentInodeId, name, user?)` - Lookup entry by name
+- `readDirectory(inodeId, offset?, cookie?, user?)` - List directory entries
+- `getExtendedAttribute(inodeId, name, user?)` - Get xattr value
+- `listExtendedAttributes(inodeId, user?)` - List xattr names
+
+#### Data Operations
+
+- `readInode(inodeId, offset, length, user?)` - Read file data
+
+#### Delegation Operations
+
+- `checkout(inodeId, force?, user?)` - Acquire write delegation
+- `checkin(inodeId, user?)` - Release delegation
+- `checkinAll()` - Release all delegations
+
+#### Mutation Operations
+
+- `conditionalCreate(parentInodeId, name, childInodeId, attributes, user?)` - Create file/directory
+- `setImmutable(inodeId)` - Mark subtree as immutable
+- `setMutable(inodeId)` - Mark subtree as mutable
+- `listImmutableSubtrees()` - List immutable roots
+
+### Types
+
+All inode IDs and file offsets use JavaScript `bigint` for 64-bit support:
+
+```typescript
+interface UnixUser {
+  uid: number;
+  gid: number;
+}
+
+interface InodeAttributes {
+  inodeId: bigint;
+  inodeType: 'File' | 'Directory' | 'Symlink' | ...;
+  size: bigint;
+  uid: number;
+  gid: number;
+  mode: number;
+  nlink: number;
+  ctimeMs: number;
+  atimeMs: number;
+  mtimeMs: number;
+  btimeMs: number;
+  rdev?: bigint;
+  symlinkTarget?: string;
+}
+
+interface DirectoryEntry {
+  name: string;
+  inodeId: bigint;
+  inodeType: string;
+}
+```
+
+## Building
+
+This package uses napi-rs for native bindings. To build from source:
+
+```bash
+cd rust-libs/archil-node
+npm install
+npm run build
+```
+
+## License
+
+Proprietary - Archil Inc.

package/index.d.ts

@@ -0,0 +1,332 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/* auto-generated by NAPI-RS */
+
+/**
+ * Initialize the Rust logger to output to stderr.
+ *
+ * @param level - Log level: "trace", "debug", "info", "warn", or "error"
+ *
+ * @example
+ * ```typescript
+ * import { initLogging } from '@archildata/client';
+ * initLogging('debug'); // Call once at startup
+ * ```
+ */
+export declare function initLogging(level?: string | undefined | null): void
+/** Unix user context for permission checks */
+export interface UnixUser {
+  uid: number
+  gid: number
+}
+/** Inode type enum exposed to JavaScript */
+export const enum JsInodeType {
+  File = 'File',
+  Directory = 'Directory',
+  Symlink = 'Symlink',
+  BlockDevice = 'BlockDevice',
+  CharacterDevice = 'CharacterDevice',
+  Fifo = 'Fifo',
+  Socket = 'Socket'
+}
+/**
+ * Inode attributes exposed to JavaScript
+ *
+ * Note: inode_id, size, and rdev use i64 which will be converted to/from
+ * JavaScript BigInt automatically by napi-rs when values exceed Number.MAX_SAFE_INTEGER.
+ */
+export interface InodeAttributes {
+  /** Inode ID (use BigInt in JS for values > 2^53) */
+  inodeId: number
+  /** Type of the inode (File, Directory, Symlink, etc.) */
+  inodeType: string
+  /** File size in bytes */
+  size: number
+  /** Owner user ID */
+  uid: number
+  /** Owner group ID */
+  gid: number
+  /** Unix permission mode */
+  mode: number
+  /** Number of hard links */
+  nlink: number
+  /** Change time (milliseconds since epoch) */
+  ctimeMs: number
+  /** Access time (milliseconds since epoch) */
+  atimeMs: number
+  /** Modification time (milliseconds since epoch) */
+  mtimeMs: number
+  /** Birth/creation time (milliseconds since epoch) */
+  btimeMs: number
+  /** Device ID for block/char devices */
+  rdev?: number
+  /** Symlink target if this is a symlink */
+  symlinkTarget?: string
+}
+/** Directory entry returned from readdir */
+export interface DirectoryEntry {
+  /** Name of the entry */
+  name: string
+  /** Inode ID of the entry */
+  inodeId: number
+  /** Type of the entry (File, Directory, etc.) */
+  inodeType: string
+}
+/** Lookup response containing inode info */
+export interface LookupResponse {
+  /** Inode ID of the found entry (-1 if not found) */
+  inodeId: number
+  /** Attributes of the found inode */
+  attributes: InodeAttributes
+}
+/** Connection configuration for direct server connections */
+export interface DirectConnectionConfig {
+  /** Server address (e.g., "localhost:8080") */
+  serverAddress: string
+  /** File system ID (optional, will be determined by server if not provided) */
+  fileSystemId?: number
+  /** Log level for Rust logging (e.g., "debug", "info", "warn", "error", "trace") */
+  logLevel?: string
+}
+/** Connection configuration for authenticated connections via mount server */
+export interface AuthenticatedConnectionConfig {
+  /** Mount server address */
+  mountServer: string
+  /** Disk name (e.g., "dsk-xxx" or "account/diskname") */
+  mountName: string
+  /** Optional auth token (uses IAM if not provided) */
+  authToken?: string
+  /** Optional STS region for IAM authentication */
+  stsRegion?: string
+}
+/**
+ * Simplified connection configuration using just region and disk name.
+ *
+ * This mirrors the CLI's `archil mount` command interface.
+ *
+ * Example usage:
+ * ```javascript
+ * const client = await ArchilClient.connect({
+ *   region: 'aws-us-east-1',
+ *   diskName: 'myaccount/mydisk'
+ * });
+ * ```
+ *
+ * To enable debug logging:
+ * ```javascript
+ * const client = await ArchilClient.connect({
+ *   region: 'aws-us-east-1',
+ *   diskName: 'myaccount/mydisk',
+ *   logLevel: 'debug'  // Enables Rust debug logs to stderr
+ * });
+ * ```
+ */
+export interface SimpleConnectionConfig {
+  /** Region identifier (e.g., "aws-us-east-1", "gcp-us-central1") */
+  region: string
+  /** Disk name - either "account/diskname" format or "dsk-xxx" disk ID */
+  diskName: string
+  /** Optional auth token (uses IAM if not provided) */
+  authToken?: string
+  /** Optional STS region for IAM authentication (defaults to region from the region parameter) */
+  stsRegion?: string
+  /** Log level for Rust logging (e.g., "debug", "info", "warn", "error", "trace") */
+  logLevel?: string
+}
+/** Inode ID range returned from reserve_inodes */
+export interface InodeRange {
+  /** Start of the reserved range (inclusive) */
+  start: number
+  /** End of the reserved range (exclusive) */
+  end: number
+}
+/** Delegation information for an inode */
+export interface DelegationInfo {
+  /** Inode ID that the delegation is for */
+  inodeId: number
+  /** State of the delegation: "Active", "Pending", or "Removing" */
+  state: string
+}
+/**
+ * Options for setattr operation
+ *
+ * All fields are optional - only provided fields will be updated.
+ * For atime/mtime: use timestamp in milliseconds, or -1 to set to current time.
+ */
+export interface SetAttrOptions {
+  /** New permission mode (e.g., 0o644) */
+  mode?: number
+  /** New owner user ID */
+  uid?: number
+  /** New owner group ID */
+  gid?: number
+  /** New file size (for truncate) */
+  size?: number
+  /** New access time in milliseconds since epoch (-1 for current time) */
+  atimeMs?: number
+  /** New modification time in milliseconds since epoch (-1 for current time) */
+  mtimeMs?: number
+  /** New change time in milliseconds since epoch */
+  ctimeMs?: number
+}
+/**
+ * ArchilClient provides low-level access to Archil filesystem operations.
+ *
+ * This client uses the headless client mode from archil-client-core to provide
+ * direct protocol access without FUSE mount infrastructure.
+ */
+export declare class ArchilClient {
+  /**
+   * Connect to an Archil server using a simplified configuration.
+   *
+   * This is the recommended way to connect and mirrors the CLI interface.
+   *
+   * @example
+   * ```typescript
+   * const client = await ArchilClient.connect({
+   *   region: 'aws-us-east-1',
+   *   diskName: 'myaccount/mydisk'
+   * });
+   * ```
+   */
+  static connect(config: SimpleConnectionConfig): Promise<ArchilClient>
+  /**
+   * Connect to an Archil server using direct connection.
+   *
+   * This is primarily for testing or internal use.
+   */
+  static connectDirect(config: DirectConnectionConfig): Promise<ArchilClient>
+  /**
+   * Close the client connection and release resources.
+   *
+   * This will sync all pending writes and release all delegations held by
+   * this client before closing. Returns the number of delegations that were released.
+   */
+  close(): Promise<number>
+  /** Get attributes for an inode (uses cache). */
+  getAttributes(inodeId: number, user?: UnixUser | undefined | null): Promise<InodeAttributes>
+  /** Lookup an entry by name in a directory (uses cache). */
+  lookupInode(parentInodeId: number, name: string, user?: UnixUser | undefined | null): Promise<LookupResponse>
+  /**
+   * Read directory entries.
+   *
+   * Uses the cache layer via snapshot_and_synchronize_directory to ensure
+   * the dirent cache is properly populated. This ensures that subsequent
+   * lookup_inode calls can find the entries returned here.
+   */
+  readDirectory(inodeId: number, offset?: number | undefined | null, cookie?: number | undefined | null, user?: UnixUser | undefined | null): Promise<Array<DirectoryEntry>>
+  /** Get an extended attribute value. */
+  getExtendedAttribute(inodeId: number, name: string, user?: UnixUser | undefined | null): Promise<Buffer | null>
+  /** List all extended attribute names. */
+  listExtendedAttributes(inodeId: number, user?: UnixUser | undefined | null): Promise<Array<string>>
+  /**
+   * Read data from a file (uses cache).
+   *
+   * Returns zero-copy Buffer when possible for optimal performance.
+   */
+  readInode(inodeId: number, offset: number, length: number, user?: UnixUser | undefined | null): Promise<Buffer>
+  /**
+   * Checkout (acquire delegation for) an inode for writing.
+   *
+   * This tracks the delegation locally so that subsequent write operations
+   * can proceed without additional server round-trips for permission checks.
+   */
+  checkout(inodeId: number, force?: boolean | undefined | null, user?: UnixUser | undefined | null): Promise<void>
+  /**
+   * Checkin (release delegation for) an inode.
+   *
+   * This syncs any pending writes and releases the local delegation tracking.
+   */
+  checkin(inodeId: number, user?: UnixUser | undefined | null): Promise<void>
+  /** Release all delegations held by this client. */
+  checkinAll(): Promise<number>
+  /**
+   * Sync all pending writes to the server.
+   *
+   * This flushes all buffered writes through the transaction scheduler,
+   * ensuring data durability before the method returns.
+   */
+  sync(): Promise<void>
+  /**
+   * Write data to a file.
+   *
+   * This performs a proper write operation using the transaction scheduler
+   * to batch and commit changes. Requires a delegation on the file
+   * (call checkout first).
+   *
+   * @example
+   * ```typescript
+   * // First checkout to get write delegation
+   * await client.checkout(inodeId, false, user);
+   * // Then write data
+   * await client.writeData(inodeId, 0n, Buffer.from('Hello World'), user);
+   * // Optionally checkin when done
+   * await client.checkin(inodeId, user);
+   * ```
+   */
+  writeData(inodeId: number, offset: number, data: Buffer, user?: UnixUser | undefined | null): Promise<void>
+  /**
+   * Set attributes on an inode.
+   *
+   * Updates file metadata like mode, timestamps, size, etc.
+   * Requires a delegation on the inode (call checkout first).
+   *
+   * For atime_ms and mtime_ms, use -1 to set to current time.
+   *
+   * @example
+   * ```typescript
+   * // First checkout to get write delegation
+   * await client.checkout(inodeId, false, user);
+   * // Update timestamps (touch)
+   * await client.setattr(inodeId, { atimeMs: -1, mtimeMs: -1 }, user);
+   * // Or change mode
+   * await client.setattr(inodeId, { mode: 0o755 }, user);
+   * // Checkin when done
+   * await client.checkin(inodeId, user);
+   * ```
+   */
+  setattr(inodeId: number, options: SetAttrOptions, user: UnixUser): Promise<InodeAttributes>
+  /**
+   * Unlink (delete) a file or empty directory.
+   *
+   * Removes the directory entry from the parent directory. Requires
+   * write permission on the parent directory.
+   */
+  unlink(parentInodeId: number, name: string, user?: UnixUser | undefined | null): Promise<void>
+  /**
+   * Rename (move) a file or directory.
+   *
+   * Atomically moves an entry from one location to another. If the destination
+   * exists, it will be replaced. Requires write permission on both parent directories.
+   *
+   * @example
+   * ```typescript
+   * // Move a file
+   * await client.rename(srcParentInodeId, 'oldname.txt', destParentInodeId, 'newname.txt', user);
+   * ```
+   */
+  rename(parentInodeId: number, name: string, newParentInodeId: number, newName: string, user?: UnixUser | undefined | null): Promise<void>
+  /**
+   * Create a new file or directory.
+   *
+   * Automatically chooses between unconditional create (if we have a delegation
+   * on the parent) and conditional create (if we need the server to issue a delegation).
+   *
+   * Returns the inode ID of the created file.
+   */
+  create(parentInodeId: number, name: string, attributes: InodeAttributes, user?: UnixUser | undefined | null): Promise<number>
+  /** Mark an inode subtree as immutable. */
+  setImmutable(inodeId: number): Promise<void>
+  /** Mark an inode subtree as mutable (reverse of set_immutable). */
+  setMutable(inodeId: number): Promise<void>
+  /** List all immutable subtree root inodes. */
+  listImmutableSubtrees(): Promise<Array<number>>
+  /**
+   * List all delegations currently held by this client.
+   *
+   * Returns a list of delegation info objects containing the inode ID and state.
+   * State is one of: "Active", "Pending", "Removing"
+   */
+  listDelegations(): Array<DelegationInfo>
+}

package/index.js

@@ -0,0 +1,317 @@
+/* tslint:disable */
+/* eslint-disable */
+/* prettier-ignore */
+
+/* auto-generated by NAPI-RS */
+
+const { existsSync, readFileSync } = require('fs')
+const { join } = require('path')
+
+const { platform, arch } = process
+
+let nativeBinding = null
+let localFileExisted = false
+let loadError = null
+
+function isMusl() {
+  // For Node 10
+  if (!process.report || typeof process.report.getReport !== 'function') {
+    try {
+      const lddPath = require('child_process').execSync('which ldd').toString().trim()
+      return readFileSync(lddPath, 'utf8').includes('musl')
+    } catch (e) {
+      return true
+    }
+  } else {
+    const { glibcVersionRuntime } = process.report.getReport().header
+    return !glibcVersionRuntime
+  }
+}
+
+switch (platform) {
+  case 'android':
+    switch (arch) {
+      case 'arm64':
+        localFileExisted = existsSync(join(__dirname, 'archildata-client.android-arm64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./archildata-client.android-arm64.node')
+          } else {
+            nativeBinding = require('@archildata/client-android-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm':
+        localFileExisted = existsSync(join(__dirname, 'archildata-client.android-arm-eabi.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./archildata-client.android-arm-eabi.node')
+          } else {
+            nativeBinding = require('@archildata/client-android-arm-eabi')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Android ${arch}`)
+    }
+    break
+  case 'win32':
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(
+          join(__dirname, 'archildata-client.win32-x64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./archildata-client.win32-x64-msvc.node')
+          } else {
+            nativeBinding = require('@archildata/client-win32-x64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'ia32':
+        localFileExisted = existsSync(
+          join(__dirname, 'archildata-client.win32-ia32-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./archildata-client.win32-ia32-msvc.node')
+          } else {
+            nativeBinding = require('@archildata/client-win32-ia32-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'archildata-client.win32-arm64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./archildata-client.win32-arm64-msvc.node')
+          } else {
+            nativeBinding = require('@archildata/client-win32-arm64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Windows: ${arch}`)
+    }
+    break
+  case 'darwin':
+    localFileExisted = existsSync(join(__dirname, 'archildata-client.darwin-universal.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./archildata-client.darwin-universal.node')
+      } else {
+        nativeBinding = require('@archildata/client-darwin-universal')
+      }
+      break
+    } catch {}
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(join(__dirname, 'archildata-client.darwin-x64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./archildata-client.darwin-x64.node')
+          } else {
+            nativeBinding = require('@archildata/client-darwin-x64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'archildata-client.darwin-arm64.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./archildata-client.darwin-arm64.node')
+          } else {
+            nativeBinding = require('@archildata/client-darwin-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on macOS: ${arch}`)
+    }
+    break
+  case 'freebsd':
+    if (arch !== 'x64') {
+      throw new Error(`Unsupported architecture on FreeBSD: ${arch}`)
+    }
+    localFileExisted = existsSync(join(__dirname, 'archildata-client.freebsd-x64.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./archildata-client.freebsd-x64.node')
+      } else {
+        nativeBinding = require('@archildata/client-freebsd-x64')
+      }
+    } catch (e) {
+      loadError = e
+    }
+    break
+  case 'linux':
+    switch (arch) {
+      case 'x64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'archildata-client.linux-x64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./archildata-client.linux-x64-musl.node')
+            } else {
+              nativeBinding = require('@archildata/client-linux-x64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'archildata-client.linux-x64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./archildata-client.linux-x64-gnu.node')
+            } else {
+              nativeBinding = require('@archildata/client-linux-x64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'archildata-client.linux-arm64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./archildata-client.linux-arm64-musl.node')
+            } else {
+              nativeBinding = require('@archildata/client-linux-arm64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'archildata-client.linux-arm64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./archildata-client.linux-arm64-gnu.node')
+            } else {
+              nativeBinding = require('@archildata/client-linux-arm64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'archildata-client.linux-arm-musleabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./archildata-client.linux-arm-musleabihf.node')
+            } else {
+              nativeBinding = require('@archildata/client-linux-arm-musleabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'archildata-client.linux-arm-gnueabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./archildata-client.linux-arm-gnueabihf.node')
+            } else {
+              nativeBinding = require('@archildata/client-linux-arm-gnueabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'riscv64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'archildata-client.linux-riscv64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./archildata-client.linux-riscv64-musl.node')
+            } else {
+              nativeBinding = require('@archildata/client-linux-riscv64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'archildata-client.linux-riscv64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./archildata-client.linux-riscv64-gnu.node')
+            } else {
+              nativeBinding = require('@archildata/client-linux-riscv64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 's390x':
+        localFileExisted = existsSync(
+          join(__dirname, 'archildata-client.linux-s390x-gnu.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./archildata-client.linux-s390x-gnu.node')
+          } else {
+            nativeBinding = require('@archildata/client-linux-s390x-gnu')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Linux: ${arch}`)
+    }
+    break
+  default:
+    throw new Error(`Unsupported OS: ${platform}, architecture: ${arch}`)
+}
+
+if (!nativeBinding) {
+  if (loadError) {
+    throw loadError
+  }
+  throw new Error(`Failed to load native binding`)
+}
+
+const { initLogging, ArchilClient, JsInodeType } = nativeBinding
+
+module.exports.initLogging = initLogging
+module.exports.ArchilClient = ArchilClient
+module.exports.JsInodeType = JsInodeType

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@archildata/client",
+  "version": "0.1.0",
+  "description": "High-performance Node.js client for Archil distributed filesystem",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "napi": {
+    "name": "archildata-client",
+    "triples": {
+      "defaults": true,
+      "additional": [
+        "aarch64-apple-darwin",
+        "aarch64-unknown-linux-gnu",
+        "x86_64-apple-darwin",
+        "x86_64-unknown-linux-gnu"
+      ]
+    }
+  },
+  "license": "UNLICENSED",
+  "devDependencies": {
+    "@napi-rs/cli": "^2.18.0"
+  },
+  "engines": {
+    "node": ">= 18"
+  },
+  "scripts": {
+    "artifacts": "napi artifacts",
+    "build": "napi build --platform --release",
+    "build:debug": "napi build --platform",
+    "prepublishOnly": "napi prepublish -t npm",
+    "test": "node --test test/*.js",
+    "universal": "napi universal",
+    "version": "napi version"
+  },
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "*.node"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/archil-io/archil"
+  },
+  "keywords": [
+    "archil",
+    "filesystem",
+    "distributed",
+    "napi",
+    "native"
+  ],
+  "optionalDependencies": {
+    "@archildata/client-win32-x64-msvc": "0.1.0",
+    "@archildata/client-darwin-x64": "0.1.0",
+    "@archildata/client-linux-x64-gnu": "0.1.0",
+    "@archildata/client-darwin-arm64": "0.1.0",
+    "@archildata/client-linux-arm64-gnu": "0.1.0"
+  }
+}