thingd-native 0.18.2

package/README.md

@@ -0,0 +1,40 @@
+# thingd-native
+
+Private native Node.js binding for `thingd`.
+
+This package is intentionally private and non-publishable right now. The public package remains `thingd`.
+
+Current shape:
+
+```txt
+thingd
+  TypeScript public API
+  ThingStore interface
+  loads this package only for driver: "native"
+
+thingd-native
+  napi-rs binding package
+  wraps crates/thingd-core
+  exposes low-level JSON bridge methods
+```
+
+Build locally:
+
+```bash
+pnpm --filter thingd-native build
+```
+
+Then use it through the public SDK:
+
+```ts
+import { ThingD } from "thingd";
+
+const db = await ThingD.open({
+  path: "./thingd.db",
+  driver: "native",
+});
+```
+
+The native package should not define a separate app-facing API. It should satisfy the same SDK behavior tested in `packages/thingd/test`.
+
+Do not publish this package until it has a prebuild strategy, migration story, and CI coverage for supported Node.js/platform combinations.

package/index.d.ts

@@ -0,0 +1,28 @@
+export class NativeThingStore {
+  static open(path: string): NativeThingStore;
+
+  putObjectJson(collection: string, id: string, body: string): string;
+  getObjectJson(collection: string, id: string): string | null;
+  listObjectsJson(collectionsJson?: string): string;
+  deleteObject(collection: string, id: string): boolean;
+  appendEventJson(stream: string, body: string): string;
+  listEventsJson(stream?: string): string;
+  pushJobJson(
+    queue: string,
+    id: string,
+    body: string,
+    maxAttempts: number,
+    delayMs: number,
+  ): string;
+  claimJobJson(queue: string, leaseMs: number): string | null;
+  ackJobJson(queue: string, id: string): string;
+  nackJobJson(queue: string, id: string, delayMs: number): string;
+  listJobsJson(queue: string): string;
+  listDeadJobsJson(queue: string): string;
+  countObjectsJson(): Promise<number>;
+  countEventsJson(): Promise<number>;
+  countActiveJobsJson(): Promise<number>;
+  countDeadJobsJson(): Promise<number>;
+  listCollectionsJson(): Promise<string>;
+  listStreamsJson(): Promise<string>;
+}

package/index.js

@@ -0,0 +1,31 @@
+import { existsSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const require = createRequire(import.meta.url);
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+function resolveBinding() {
+  // 1. Try local dev build first (dist/thingd_native.node)
+  const devPath = join(__dirname, "dist", "thingd_native.node");
+  if (existsSync(devPath)) {
+    return { binding: require(devPath), path: devPath };
+  }
+
+  // 2. Try prebuilt binary matching current platform and arch
+  const platform = process.platform;
+  const arch = process.arch;
+  const prebuiltPath = join(__dirname, "prebuilds", `${platform}-${arch}`, "thingd_native.node");
+  if (existsSync(prebuiltPath)) {
+    return { binding: require(prebuiltPath), path: prebuiltPath };
+  }
+
+  // 3. Fallback to requiring dev path directly (will throw standard error)
+  return { binding: require(devPath), path: devPath };
+}
+
+const { binding, path } = resolveBinding();
+
+export const { NativeThingStore } = binding;
+export const loadedPath = path;

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "thingd-native",
+  "version": "0.18.2",
+  "description": "Private native Node.js binding for thingd.",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "Sayan Mohsin",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sayanmohsin/thingd.git"
+  },
+  "main": "./index.js",
+  "types": "./index.d.ts",
+  "files": [
+    "prebuilds",
+    "index.js",
+    "index.d.ts",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "cargo build -p thingd-native --release && node scripts/copy-native.mjs",
+    "build:prebuild": "node scripts/copy-prebuild.mjs",
+    "clean": "node scripts/clean-native.mjs"
+  }
+}