sekejap 0.13.3

package/README.md

@@ -0,0 +1,62 @@
+# sekejap for Node.js
+
+**Status: working** (tested). Native Node.js binding via [napi-rs](https://napi.rs/) —
+`#[napi]` over `sekejap::CoreDB`, compiled to a native N-API addon.
+
+## Run it
+
+```bash
+cd wrappers/node
+cargo build --release                        # builds the addon
+cp target/release/libsekejap_node.dylib sekejap.node   # (.so on Linux, .dll on Windows)
+node test.cjs                                # → OK — sekejap-node 0.13.0 …
+```
+
+For real packaging use `npx @napi-rs/cli build --release`, which names the addon
+per-platform and generates `index.js` + `index.d.ts` (TypeScript types). JS API:
+`Db.open(path)`, `execute`, `query`/`queryParams` (→ JSON string, `JSON.parse` it),
+`put`, `link`, `nodeCount`/`edgeCount`, `compact`, `version()`.
+
+## Approach
+
+napi-rs is Node's equivalent of PyO3: you annotate Rust with `#[napi]` and it
+builds a native Node addon (`.node`) that speaks Node's stable **N-API** directly —
+idiomatic JS types, no manual C ABI. (An alternative is `koffi`/`ffi-napi` calling
+the C ABI in `../c`, but napi-rs gives better perf and TypeScript types.)
+
+```
+wrappers/node/
+├── Cargo.toml        # crate-type = ["cdylib"], deps: napi, napi-derive; depends on the sekejap crate
+├── package.json      # name "sekejap", @napi-rs/cli build/publish scripts
+├── src/lib.rs        # #[napi] wrappers over sekejap::CoreDB / Engine
+├── index.d.ts        # generated TypeScript types
+└── examples/         # .js / .ts usage
+```
+
+Minimal `Cargo.toml` to add (then add `wrappers/node` to the workspace members):
+
+```toml
+[package]
+name = "sekejap-node"
+version.workspace = true
+edition.workspace = true
+
+[lib]
+crate-type = ["cdylib"]
+
+[dependencies]
+sekejap = { path = "../.." }
+napi = { version = "2", features = ["napi8"] }
+napi-derive = "2"
+
+[build-dependencies]
+napi-build = "2"
+```
+
+## Distribution
+
+- **Registry:** [npm](https://npmjs.com) → `npm install sekejap`
+- **Publish:** `npm publish`. Build prebuilt binaries per platform in CI with
+  `@napi-rs/cli` (`napi build --release`) and ship them as platform packages under
+  `optionalDependencies`, so users don't need a Rust toolchain.
+- Reserve the name `sekejap` on npm now.

package/index.d.ts

@@ -0,0 +1,40 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/* auto-generated by NAPI-RS */
+
+/** The library version. */
+export declare function version(): string
+/**
+ * An open sekejap database. JS is single-threaded, but we guard with a Mutex so
+ * the handle is sound even if shared via worker threads.
+ */
+export declare class Db {
+  /** Open (or create) a database at `path`. */
+  static open(path: string): Db
+  /** Run a mutating statement; returns affected rows. */
+  execute(sql: string): number
+  /** Run a SELECT; returns a JSON-array string (caller `JSON.parse`s it). */
+  query(sql: string): string
+  /** Parameterized SELECT ($1, $2, …); `paramsJson` is a JSON array string. */
+  queryParams(sql: string, paramsJson: string): string
+  /** Compile a query once for repeated execution — a prepared statement. */
+  prepare(sql: string): PreparedStatement
+  /**
+   * Run a prepared statement, binding `$1`, `$2`, … from a JSON-array string.
+   * Returns a JSON-array string (caller `JSON.parse`s it).
+   */
+  queryPrepared(stmt: PreparedStatement, paramsJson: string): string
+  /** Insert/replace one node by slug with a JSON payload. */
+  put(slug: string, payloadJson: string): void
+  /** Create a plain edge from -> to of the given type. */
+  link(from: string, to: string, edgeType: string): void
+  /** Number of nodes. */
+  nodeCount(): number
+  /** Number of edges. */
+  edgeCount(): number
+  /** Compact: truncate WAL, rewrite payloads/topology, reclaim RAM. */
+  compact(): void
+}
+/** A prepared (compiled) query — from `Db.prepare`, run with `Db.queryPrepared`. */
+export declare class PreparedStatement { }

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, 'sekejap.android-arm64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./sekejap.android-arm64.node')
+          } else {
+            nativeBinding = require('sekejap-android-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm':
+        localFileExisted = existsSync(join(__dirname, 'sekejap.android-arm-eabi.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./sekejap.android-arm-eabi.node')
+          } else {
+            nativeBinding = require('sekejap-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, 'sekejap.win32-x64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./sekejap.win32-x64-msvc.node')
+          } else {
+            nativeBinding = require('sekejap-win32-x64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'ia32':
+        localFileExisted = existsSync(
+          join(__dirname, 'sekejap.win32-ia32-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./sekejap.win32-ia32-msvc.node')
+          } else {
+            nativeBinding = require('sekejap-win32-ia32-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'sekejap.win32-arm64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./sekejap.win32-arm64-msvc.node')
+          } else {
+            nativeBinding = require('sekejap-win32-arm64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Windows: ${arch}`)
+    }
+    break
+  case 'darwin':
+    localFileExisted = existsSync(join(__dirname, 'sekejap.darwin-universal.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./sekejap.darwin-universal.node')
+      } else {
+        nativeBinding = require('sekejap-darwin-universal')
+      }
+      break
+    } catch {}
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(join(__dirname, 'sekejap.darwin-x64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./sekejap.darwin-x64.node')
+          } else {
+            nativeBinding = require('sekejap-darwin-x64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'sekejap.darwin-arm64.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./sekejap.darwin-arm64.node')
+          } else {
+            nativeBinding = require('sekejap-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, 'sekejap.freebsd-x64.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./sekejap.freebsd-x64.node')
+      } else {
+        nativeBinding = require('sekejap-freebsd-x64')
+      }
+    } catch (e) {
+      loadError = e
+    }
+    break
+  case 'linux':
+    switch (arch) {
+      case 'x64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'sekejap.linux-x64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./sekejap.linux-x64-musl.node')
+            } else {
+              nativeBinding = require('sekejap-linux-x64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'sekejap.linux-x64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./sekejap.linux-x64-gnu.node')
+            } else {
+              nativeBinding = require('sekejap-linux-x64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'sekejap.linux-arm64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./sekejap.linux-arm64-musl.node')
+            } else {
+              nativeBinding = require('sekejap-linux-arm64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'sekejap.linux-arm64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./sekejap.linux-arm64-gnu.node')
+            } else {
+              nativeBinding = require('sekejap-linux-arm64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'sekejap.linux-arm-musleabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./sekejap.linux-arm-musleabihf.node')
+            } else {
+              nativeBinding = require('sekejap-linux-arm-musleabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'sekejap.linux-arm-gnueabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./sekejap.linux-arm-gnueabihf.node')
+            } else {
+              nativeBinding = require('sekejap-linux-arm-gnueabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'riscv64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'sekejap.linux-riscv64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./sekejap.linux-riscv64-musl.node')
+            } else {
+              nativeBinding = require('sekejap-linux-riscv64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'sekejap.linux-riscv64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./sekejap.linux-riscv64-gnu.node')
+            } else {
+              nativeBinding = require('sekejap-linux-riscv64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 's390x':
+        localFileExisted = existsSync(
+          join(__dirname, 'sekejap.linux-s390x-gnu.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./sekejap.linux-s390x-gnu.node')
+          } else {
+            nativeBinding = require('sekejap-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 { Db, PreparedStatement, version } = nativeBinding
+
+module.exports.Db = Db
+module.exports.PreparedStatement = PreparedStatement
+module.exports.version = version

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "sekejap",
+  "version": "0.13.3",
+  "description": "Embedded graph-first multi-model database — Node.js binding",
+  "license": "MIT OR Apache-2.0",
+  "repository": "github:sekejapdb/sekejap",
+  "homepage": "https://sekejap.zebflow.com",
+  "keywords": ["database", "graph", "vector", "spatial", "embedded", "multi-model"],
+  "main": "index.js",
+  "types": "index.d.ts",
+  "files": ["index.js", "index.d.ts", "*.node", "README.md"],
+  "napi": {
+    "name": "sekejap"
+  },
+  "engines": { "node": ">= 16" },
+  "os": ["darwin", "linux", "win32"],
+  "cpu": ["x64", "arm64"],
+  "scripts": {
+    "build": "napi build --platform --release"
+  },
+  "devDependencies": {
+    "@napi-rs/cli": "^2.18.0"
+  }
+}