@hologit/holo-tree 0.2.1 → 0.4.0

package/README.md

@@ -78,16 +78,20 @@ git-ignored (built per-platform in CI).
 Published as the scoped package **`@hologit/holo-tree`** with per-platform
 prebuilt binaries shipped as `optionalDependencies`:
 
-| Platform package | Triple | Built on |
-| --- | --- | --- |
-| `@hologit/holo-tree-linux-x64-gnu` | `x86_64-unknown-linux-gnu` | ubuntu-latest |
-| `@hologit/holo-tree-darwin-arm64` | `aarch64-apple-darwin` | macos-latest |
-| `@hologit/holo-tree-win32-x64-msvc` | `x86_64-pc-windows-msvc` | windows-latest |
-
-Each target builds **natively** on its runner — no cross-compilation. The
-`.github/workflows/holo-tree-napi.yml` workflow builds + smoke-tests all three on
-every PR touching the binding, and on a `holo-tree-v*` tag it builds then
-publishes.
+| Platform package | Triple | Built on | Smoke-tested |
+| --- | --- | --- | --- |
+| `@hologit/holo-tree-linux-x64-gnu` | `x86_64-unknown-linux-gnu` | ubuntu-latest | ✓ native |
+| `@hologit/holo-tree-linux-arm64-gnu` | `aarch64-unknown-linux-gnu` | ubuntu-24.04-arm | ✓ native |
+| `@hologit/holo-tree-linux-x64-musl` | `x86_64-unknown-linux-musl` | ubuntu-latest (musl cross) | build-only |
+| `@hologit/holo-tree-darwin-arm64` | `aarch64-apple-darwin` | macos-latest | ✓ native |
+| `@hologit/holo-tree-darwin-x64` | `x86_64-apple-darwin` | macos-latest (cross) | build-only |
+| `@hologit/holo-tree-win32-x64-msvc` | `x86_64-pc-windows-msvc` | windows-latest | ✓ native |
+
+Native targets build + smoke-test on a matching runner; cross targets (musl,
+darwin-x64) build only, since their `.node` can't run on the host arch/libc (the
+logic is covered by the native runs). The `.github/workflows/holo-tree-napi.yml`
+workflow builds all six on every PR touching the binding, and on a
+`holo-tree-v*` tag it builds then publishes.
 
 Auth is **npm trusted publishing (OIDC)** — no tokens, matching hologit's
 `publish-npm.yml`. Trusted publishing is configured *per package*, and a package

package/index.d.ts

@@ -123,6 +123,15 @@ export declare class Tree {
   writeChild(path: string, content: string): string
   /** Hash raw bytes as a blob and insert at `path`. Binary-safe. */
   writeChildBytes(path: string, content: Buffer): string
+  /**
+   * Place an already-written blob at `path` by its `hash`, without reading its
+   * bytes. Unlike `writeChildBytes` (which re-hashes content), this grafts a
+   * blob already in the ODB — validated to exist and be a blob via a header
+   * lookup, so a large attachment isn't read back and re-hashed. `mode` is the
+   * git filemode: `0o100644` regular, `0o100755` executable, `0o120000`
+   * symlink. Returns the placed hash.
+   */
+  writeChildHash(path: string, hash: string, mode: number): string
   /** Read a blob's bytes at `path`, or `null` if no blob exists there. */
   readBlob(path: string): Buffer | null
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hologit/holo-tree",
-  "version": "0.2.1",
+  "version": "0.4.0",
   "description": "Node.js native binding for holo-tree — mutable in-memory git trees via gix",
   "main": "index.js",
   "types": "index.d.ts",
@@ -19,7 +19,10 @@
       "defaults": false,
       "additional": [
         "x86_64-unknown-linux-gnu",
+        "aarch64-unknown-linux-gnu",
+        "x86_64-unknown-linux-musl",
         "aarch64-apple-darwin",
+        "x86_64-apple-darwin",
         "x86_64-pc-windows-msvc"
       ]
     }
@@ -29,9 +32,12 @@
     "index.d.ts"
   ],
   "optionalDependencies": {
-    "@hologit/holo-tree-linux-x64-gnu": "0.2.1",
-    "@hologit/holo-tree-darwin-arm64": "0.2.1",
-    "@hologit/holo-tree-win32-x64-msvc": "0.2.1"
+    "@hologit/holo-tree-linux-x64-gnu": "0.4.0",
+    "@hologit/holo-tree-linux-arm64-gnu": "0.4.0",
+    "@hologit/holo-tree-linux-x64-musl": "0.4.0",
+    "@hologit/holo-tree-darwin-arm64": "0.4.0",
+    "@hologit/holo-tree-darwin-x64": "0.4.0",
+    "@hologit/holo-tree-win32-x64-msvc": "0.4.0"
   },
   "scripts": {
     "artifacts": "napi artifacts",