@bodhiapp/app-bindings 0.0.5

package/README.md

@@ -0,0 +1,135 @@
+# @bodhiapp/app-bindings
+
+[![npm version](https://badge.fury.io/js/@bodhiapp%2Fapp-bindings.svg)](https://badge.fury.io/js/@bodhiapp%2Fapp-bindings)
+[![CI](https://github.com/BodhiSearch/BodhiApp/actions/workflows/build.yml/badge.svg)](https://github.com/BodhiSearch/BodhiApp/actions/workflows/build.yml)
+
+Node.js bindings for BodhiApp server functionality, built with NAPI-RS for high-performance native integration.
+
+## Features
+
+- 🚀 **High Performance**: Native Rust implementation with Node.js bindings
+- 🔄 **Cross-Platform**: Supports macOS, Linux, and Windows
+- 📦 **Zero Dependencies**: Self-contained with platform-specific binaries
+- 🔒 **Type Safe**: Full TypeScript definitions included
+- 🧪 **Well Tested**: Comprehensive test suite with integration tests
+
+## Installation
+
+```bash
+npm install @bodhiapp/app-bindings
+```
+
+## Supported Platforms
+
+This package includes pre-built binaries for the following platforms:
+
+| Platform | Architecture | Node.js |
+|----------|-------------|---------|
+| macOS | Apple Silicon (ARM64) | >=22 |
+| Linux | x64 | >=22 |
+| Windows | x64 | >=22 |
+
+## Usage
+
+### Basic Usage
+
+```javascript
+import { /* exported functions */ } from '@bodhiapp/app-bindings';
+
+// Example usage will be added based on your actual exports
+```
+
+### TypeScript Support
+
+The package includes full TypeScript definitions:
+
+```typescript
+import type { /* types */ } from '@bodhiapp/app-bindings';
+
+// TypeScript intellisense and type checking work out of the box
+```
+
+## API Reference
+
+<!-- API documentation will be generated based on your actual exports -->
+
+## Development
+
+This package is part of the [BodhiApp](https://github.com/BodhiSearch/BodhiApp) project. 
+
+### Building from Source
+
+If you need to build from source:
+
+```bash
+# Clone the repository
+git clone https://github.com/BodhiSearch/BodhiApp.git
+cd BodhiApp/crates/lib_bodhiserver_napi
+
+# Install dependencies
+npm install
+
+# Build the native module
+npm run build:release
+```
+
+### Testing
+
+```bash
+# Run unit tests
+npm test
+
+# Run integration tests
+npm run test:integration
+
+# Run Playwright tests
+npm run test:playwright
+```
+
+## Architecture
+
+This package uses [NAPI-RS](https://napi.rs/) to provide Node.js bindings for Rust code. The architecture follows these principles:
+
+- **Platform-specific binaries**: Each supported platform gets its own optimized binary
+- **Automatic loading**: The package automatically loads the correct binary for your platform
+- **Fallback handling**: Graceful error handling if binaries are missing
+- **Development support**: Debug builds available for development
+
+## Performance
+
+The native Rust implementation provides significant performance benefits over pure JavaScript implementations:
+
+- **Memory efficiency**: Lower memory usage through Rust's ownership model
+- **CPU performance**: Optimized native code execution
+- **Concurrent processing**: Built-in support for async operations
+
+## Contributing
+
+Contributions are welcome! Please see the [main repository](https://github.com/BodhiSearch/BodhiApp) for contribution guidelines.
+
+### Development Setup
+
+1. **Rust**: Install Rust toolchain (1.70+)
+2. **Node.js**: Install Node.js (22+)
+3. **Platform tools**: Platform-specific build tools may be required
+
+## License
+
+MIT License - see the [LICENSE](https://github.com/BodhiSearch/BodhiApp/blob/main/LICENSE) file for details.
+
+## Support
+
+- **Issues**: [GitHub Issues](https://github.com/BodhiSearch/BodhiApp/issues)
+- **Documentation**: [Project Documentation](https://github.com/BodhiSearch/BodhiApp#readme)
+- **Community**: [Discussions](https://github.com/BodhiSearch/BodhiApp/discussions)
+
+## Related Packages
+
+This package is part of the BodhiApp ecosystem:
+
+- **[BodhiApp](https://github.com/BodhiSearch/BodhiApp)**: Main application repository
+- **Desktop App**: Cross-platform desktop application built with Tauri
+
+---
+
+*Built with ❤️ using [NAPI-RS](https://napi.rs/)* 

package/index.d.ts

@@ -0,0 +1,95 @@
+/* auto-generated by NAPI-RS */
+/* eslint-disable */
+/** The main Bodhi server wrapper for NAPI */
+export declare class BodhiServer {
+  /** Create a new Bodhi server instance with the given configuration */
+  constructor(config: NapiAppOptions)
+  /** Get the server configuration */
+  get config(): NapiAppOptions
+  /** Get the server URL */
+  serverUrl(): string
+  /** Get the server host */
+  host(): string
+  /** Get the server port */
+  port(): number
+  /** Start the Bodhi server */
+  start(): Promise<void>
+  /** Stop the Bodhi server */
+  stop(): Promise<void>
+  /** Check if the server is running */
+  isRunning(): Promise<boolean>
+  /** Get server ping status */
+  ping(): Promise<boolean>
+}
+
+export const BODHI_APP_TYPE: string
+
+export const BODHI_AUTH_REALM: string
+
+export const BODHI_AUTH_URL: string
+
+export const BODHI_ENCRYPTION_KEY: string
+
+export const BODHI_ENV_TYPE: string
+
+export const BODHI_EXEC_LOOKUP_PATH: string
+
+export const BODHI_EXEC_VARIANT: string
+
+export const BODHI_HOME: string
+
+export const BODHI_HOST: string
+
+export const BODHI_KEEP_ALIVE_SECS: string
+
+export const BODHI_LOG_LEVEL: string
+
+export const BODHI_LOG_STDOUT: string
+
+export const BODHI_LOGS: string
+
+export const BODHI_PORT: string
+
+export const BODHI_SCHEME: string
+
+export const BODHI_VERSION: string
+
+/** Create a new NapiAppOptions with empty configuration */
+export declare export declare function createNapiAppOptions(): NapiAppOptions
+
+export const DEFAULT_HOST: string
+
+export const DEFAULT_PORT: number
+
+export const HF_HOME: string
+
+/** Flexible configuration options for the Bodhi server that can be passed across NAPI boundary */
+export interface NapiAppOptions {
+  /** Environment variables to set */
+  envVars: Record<string, string>
+  /** App settings (configurable via settings.yaml) */
+  appSettings: Record<string, string>
+  /** System settings (immutable) */
+  systemSettings: Record<string, string>
+  /** OAuth client ID (optional) */
+  clientId?: string
+  /** OAuth client secret (optional) */
+  clientSecret?: string
+  /** App status as string (optional) */
+  appStatus?: string
+}
+
+/** Set an app setting (configurable via settings.yaml) */
+export declare export declare function setAppSetting(config: NapiAppOptions, key: string, value: string): NapiAppOptions
+
+/** Set app status */
+export declare export declare function setAppStatus(config: NapiAppOptions, status: string): NapiAppOptions
+
+/** Set OAuth client credentials */
+export declare export declare function setClientCredentials(config: NapiAppOptions, clientId: string, clientSecret: string): NapiAppOptions
+
+/** Set an environment variable */
+export declare export declare function setEnvVar(config: NapiAppOptions, key: string, value: string): NapiAppOptions
+
+/** Set a system setting (immutable) */
+export declare export declare function setSystemSetting(config: NapiAppOptions, key: string, value: string): NapiAppOptions

package/index.js

@@ -0,0 +1,398 @@
+// prettier-ignore
+/* eslint-disable */
+// @ts-nocheck
+/* auto-generated by NAPI-RS */
+
+const { createRequire } = require('node:module')
+require = createRequire(__filename)
+
+const { readFileSync } = require('node:fs')
+let nativeBinding = null
+const loadErrors = []
+
+const isMusl = () => {
+  let musl = false
+  if (process.platform === 'linux') {
+    musl = isMuslFromFilesystem()
+    if (musl === null) {
+      musl = isMuslFromReport()
+    }
+    if (musl === null) {
+      musl = isMuslFromChildProcess()
+    }
+  }
+  return musl
+}
+
+const isFileMusl = (f) => f.includes('libc.musl-') || f.includes('ld-musl-')
+
+const isMuslFromFilesystem = () => {
+  try {
+    return readFileSync('/usr/bin/ldd', 'utf-8').includes('musl')
+  } catch {
+    return null
+  }
+}
+
+const isMuslFromReport = () => {
+  const report = typeof process.report.getReport === 'function' ? process.report.getReport() : null
+  if (!report) {
+    return null
+  }
+  if (report.header && report.header.glibcVersionRuntime) {
+    return false
+  }
+  if (Array.isArray(report.sharedObjects)) {
+    if (report.sharedObjects.some(isFileMusl)) {
+      return true
+    }
+  }
+  return false
+}
+
+const isMuslFromChildProcess = () => {
+  try {
+    return require('child_process').execSync('ldd --version', { encoding: 'utf8' }).includes('musl')
+  } catch (e) {
+    // If we reach this case, we don't know if the system is musl or not, so is better to just fallback to false
+    return false
+  }
+}
+
+function requireNative() {
+  if (process.env.NAPI_RS_NATIVE_LIBRARY_PATH) {
+    try {
+      nativeBinding = require(process.env.NAPI_RS_NATIVE_LIBRARY_PATH);
+    } catch (err) {
+      loadErrors.push(err);
+    }
+  } else if (process.platform === 'android') {
+    if (process.arch === 'arm64') {
+      try {
+        return require('./app-bindings.android-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@bodhiapp/app-bindings-android-arm64')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+    } else if (process.arch === 'arm') {
+      try {
+        return require('./app-bindings.android-arm-eabi.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@bodhiapp/app-bindings-android-arm-eabi')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Android ${process.arch}`))
+    }
+  } else if (process.platform === 'win32') {
+    if (process.arch === 'x64') {
+      try {
+        return require('./app-bindings.win32-x64-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@bodhiapp/app-bindings-win32-x64-msvc')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+    } else if (process.arch === 'ia32') {
+      try {
+        return require('./app-bindings.win32-ia32-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@bodhiapp/app-bindings-win32-ia32-msvc')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./app-bindings.win32-arm64-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@bodhiapp/app-bindings-win32-arm64-msvc')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Windows: ${process.arch}`))
+    }
+  } else if (process.platform === 'darwin') {
+    try {
+        return require('./app-bindings.darwin-universal.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@bodhiapp/app-bindings-darwin-universal')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+    if (process.arch === 'x64') {
+      try {
+        return require('./app-bindings.darwin-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@bodhiapp/app-bindings-darwin-x64')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./app-bindings.darwin-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@bodhiapp/app-bindings-darwin-arm64')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on macOS: ${process.arch}`))
+    }
+  } else if (process.platform === 'freebsd') {
+    if (process.arch === 'x64') {
+      try {
+        return require('./app-bindings.freebsd-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@bodhiapp/app-bindings-freebsd-x64')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./app-bindings.freebsd-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@bodhiapp/app-bindings-freebsd-arm64')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on FreeBSD: ${process.arch}`))
+    }
+  } else if (process.platform === 'linux') {
+    if (process.arch === 'x64') {
+      if (isMusl()) {
+        try {
+        return require('./app-bindings.linux-x64-musl.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@bodhiapp/app-bindings-linux-x64-musl')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+      } else {
+        try {
+        return require('./app-bindings.linux-x64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@bodhiapp/app-bindings-linux-x64-gnu')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+      }
+    } else if (process.arch === 'arm64') {
+      if (isMusl()) {
+        try {
+        return require('./app-bindings.linux-arm64-musl.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@bodhiapp/app-bindings-linux-arm64-musl')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+      } else {
+        try {
+        return require('./app-bindings.linux-arm64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@bodhiapp/app-bindings-linux-arm64-gnu')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+      }
+    } else if (process.arch === 'arm') {
+      if (isMusl()) {
+        try {
+        return require('./app-bindings.linux-arm-musleabihf.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@bodhiapp/app-bindings-linux-arm-musleabihf')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+      } else {
+        try {
+        return require('./app-bindings.linux-arm-gnueabihf.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@bodhiapp/app-bindings-linux-arm-gnueabihf')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+      }
+    } else if (process.arch === 'riscv64') {
+      if (isMusl()) {
+        try {
+        return require('./app-bindings.linux-riscv64-musl.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@bodhiapp/app-bindings-linux-riscv64-musl')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+      } else {
+        try {
+        return require('./app-bindings.linux-riscv64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@bodhiapp/app-bindings-linux-riscv64-gnu')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+      }
+    } else if (process.arch === 'ppc64') {
+      try {
+        return require('./app-bindings.linux-ppc64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@bodhiapp/app-bindings-linux-ppc64-gnu')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+    } else if (process.arch === 's390x') {
+      try {
+        return require('./app-bindings.linux-s390x-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        return require('@bodhiapp/app-bindings-linux-s390x-gnu')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Linux: ${process.arch}`))
+    }
+  } else {
+    loadErrors.push(new Error(`Unsupported OS: ${process.platform}, architecture: ${process.arch}`))
+  }
+}
+
+nativeBinding = requireNative()
+
+if (!nativeBinding || process.env.NAPI_RS_FORCE_WASI) {
+  try {
+    nativeBinding = require('./app-bindings.wasi.cjs')
+  } catch (err) {
+    if (process.env.NAPI_RS_FORCE_WASI) {
+      loadErrors.push(err)
+    }
+  }
+  if (!nativeBinding) {
+    try {
+      nativeBinding = require('@bodhiapp/app-bindings-wasm32-wasi')
+    } catch (err) {
+      if (process.env.NAPI_RS_FORCE_WASI) {
+        loadErrors.push(err)
+      }
+    }
+  }
+}
+
+if (!nativeBinding) {
+  if (loadErrors.length > 0) {
+    // TODO Link to documentation with potential fixes
+    //  - The package owner could build/publish bindings for this arch
+    //  - The user may need to bundle the correct files
+    //  - The user may need to re-install node_modules to get new packages
+    throw new Error('Failed to load native binding', { cause: loadErrors })
+  }
+  throw new Error(`Failed to load native binding`)
+}
+
+module.exports.BodhiServer = nativeBinding.BodhiServer
+module.exports.BODHI_APP_TYPE = nativeBinding.BODHI_APP_TYPE
+module.exports.BODHI_AUTH_REALM = nativeBinding.BODHI_AUTH_REALM
+module.exports.BODHI_AUTH_URL = nativeBinding.BODHI_AUTH_URL
+module.exports.BODHI_ENCRYPTION_KEY = nativeBinding.BODHI_ENCRYPTION_KEY
+module.exports.BODHI_ENV_TYPE = nativeBinding.BODHI_ENV_TYPE
+module.exports.BODHI_EXEC_LOOKUP_PATH = nativeBinding.BODHI_EXEC_LOOKUP_PATH
+module.exports.BODHI_EXEC_VARIANT = nativeBinding.BODHI_EXEC_VARIANT
+module.exports.BODHI_HOME = nativeBinding.BODHI_HOME
+module.exports.BODHI_HOST = nativeBinding.BODHI_HOST
+module.exports.BODHI_KEEP_ALIVE_SECS = nativeBinding.BODHI_KEEP_ALIVE_SECS
+module.exports.BODHI_LOG_LEVEL = nativeBinding.BODHI_LOG_LEVEL
+module.exports.BODHI_LOG_STDOUT = nativeBinding.BODHI_LOG_STDOUT
+module.exports.BODHI_LOGS = nativeBinding.BODHI_LOGS
+module.exports.BODHI_PORT = nativeBinding.BODHI_PORT
+module.exports.BODHI_SCHEME = nativeBinding.BODHI_SCHEME
+module.exports.BODHI_VERSION = nativeBinding.BODHI_VERSION
+module.exports.createNapiAppOptions = nativeBinding.createNapiAppOptions
+module.exports.DEFAULT_HOST = nativeBinding.DEFAULT_HOST
+module.exports.DEFAULT_PORT = nativeBinding.DEFAULT_PORT
+module.exports.HF_HOME = nativeBinding.HF_HOME
+module.exports.setAppSetting = nativeBinding.setAppSetting
+module.exports.setAppStatus = nativeBinding.setAppStatus
+module.exports.setClientCredentials = nativeBinding.setClientCredentials
+module.exports.setEnvVar = nativeBinding.setEnvVar
+module.exports.setSystemSetting = nativeBinding.setSystemSetting

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@bodhiapp/app-bindings",
+  "version": "0.0.5",
+  "description": "NAPI-RS bindings for BodhiApp server with integrated tests",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "type": "module",
+  "napi": {
+    "binaryName": "app-bindings",
+    "targets": [
+      "aarch64-apple-darwin"
+    ]
+  },
+  "scripts": {
+    "artifacts": "napi artifacts",
+    "create-npm-dirs": "napi create-npm-dirs",
+    "build": "napi build --platform --release",
+    "build:debug": "napi build --platform",
+    "build:release": "napi build --platform --release",
+    "build:release:win": "napi build --platform --release --target x86_64-pc-windows-msvc",
+    "test": "vitest run",
+    "test:run": "vitest run",
+    "test:config": "vitest run --testNamePattern='Configuration'",
+    "test:integration": "vitest run --testNamePattern='Integration'",
+    "test:live": "vitest run --testNamePattern='Live Server'",
+    "test:playwright": "playwright test --reporter=list",
+    "test:playwright:ci": "playwright test",
+    "test:playwright:ui": "playwright test --ui",
+    "test:playwright:headed": "playwright test --headed",
+    "test:all": "npm run test:run && npm run test:playwright",
+    "format": "biome format --write .",
+    "format:check": "biome format .",
+    "lint": "biome lint .",
+    "lint:fix": "biome lint --write .",
+    "check": "biome check .",
+    "check:fix": "biome check --write ."
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
+    "@napi-rs/cli": "=3.0.0-alpha.68",
+    "@playwright/test": "^1.48.2",
+    "dotenv": "^16.5.0",
+    "vitest": "^2.1.8"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BodhiSearch/BodhiApp.git",
+    "directory": "crates/lib_bodhiserver_napi"
+  },
+  "homepage": "https://github.com/BodhiSearch/BodhiApp#readme",
+  "bugs": {
+    "url": "https://github.com/BodhiSearch/BodhiApp/issues"
+  },
+  "keywords": [
+    "napi",
+    "rust",
+    "node-addon",
+    "bodhi",
+    "llm",
+    "server"
+  ],
+  "files": [
+    "index.d.ts",
+    "index.js"
+  ],
+  "optionalDependencies": {
+    "@bodhiapp/app-bindings-darwin-arm64": "0.0.1"
+  }
+}