bulletin-deploy 0.6.7-rc.0 → 0.6.7

package/README.md

@@ -15,7 +15,7 @@ Your site is live at `https://my-app00.dot.li`
 ## Prerequisites
 
 - **Node.js 22+**
-- **IPFS Kubo** (for merkleizing directories)
+- **IPFS Kubo** (for merkleizing directories — not needed with `--js-merkle`)
 
 ```bash
 # macOS
@@ -29,6 +29,8 @@ sudo bash kubo/install.sh
 ipfs init
 ```
 
+> **No Kubo?** Use `--js-merkle` to skip the Kubo requirement entirely. See [Merkleization modes](#merkleization-modes) below.
+
 ## CLI Usage
 
 ```bash
@@ -55,6 +57,7 @@ Options:
   --rpc wss://...     Bulletin RPC (or set BULLETIN_RPC env var)
   --mnemonic "..."    DotNS owner mnemonic (or set MNEMONIC env var)
   --playground        Publish to the Playground remix registry
+  --js-merkle         Use pure-JS merkleization (no IPFS Kubo binary required)
   --pool-size N       Number of pool accounts (default: 10)
   --help              Show help
 ```
@@ -92,6 +95,20 @@ const result = await deploy("./dist", "my-app00.dot");
 console.log(result.cid, result.domainName);
 ```
 
+### JS merkleization and custom telemetry
+
+For environments without Kubo (WebContainers, serverless), use `jsMerkle`. The optional `attributes` field lets you inject telemetry context when git is unavailable:
+
+```javascript
+const result = await deploy("./dist", "my-app00.dot", {
+  jsMerkle: true,
+  attributes: {
+    "deploy.source": "revx",
+    "deploy.repo": "user/project",
+  },
+});
+```
+
 ## Domain Names and Proof of Personhood
 
 DotNS domain names are classified by the PopOracle contract on Asset Hub. The classification determines what level of **Proof of Personhood (PoP)** is required to register:
@@ -124,18 +141,53 @@ If you see **"Requires Full Personhood verification"**, the deploy will fail ear
 ## How It Works
 
 ```
-Build output ──> IPFS merkleize ──> CAR file ──> Chunk upload ──> DotNS
-    ./dist          ipfs add        .car         Bulletin        Asset Hub
-                                                 Storage         Registry
+Build output ──> Merkleize ──> CAR file ──> Chunk upload ──> DotNS
+    ./dist       (Kubo or JS)   .car         Bulletin        Asset Hub
+                                             Storage         Registry
 ```
 
-1. **Merkleize** your build directory with IPFS to produce a content-addressed CAR file
+1. **Merkleize** your build directory to produce a content-addressed CAR file
 2. **Chunk and upload** the CAR file to Bulletin's TransactionStorage (1MB chunks, 2 per batch)
 3. **Store the DAG root** that links all chunks together under a single CID
 4. **Register or update** your `.dot` domain on Asset Hub with the new contenthash
 
 Your site is immediately accessible at `https://your-domain.dot.li`
 
+## Merkleization modes
+
+bulletin-deploy supports two ways to merkleize your build directory into a CAR file:
+
+| Mode | Flag | Requires | Best for |
+|---|---|---|---|
+| **Kubo** (default) | _(none)_ | IPFS Kubo binary installed | CI pipelines, local development |
+| **JS** | `--js-merkle` | Nothing beyond Node.js | WebContainers, serverless, environments without system binaries |
+
+Both modes produce valid IPFS UnixFS DAGs. The CIDs may differ between modes for the same input (different chunking implementations), but this is fine — each deploy sets a fresh contenthash on DotNS regardless.
+
+### CLI
+
+```bash
+# Default (Kubo)
+bulletin-deploy ./dist my-app00.dot
+
+# JS merkleization
+bulletin-deploy --js-merkle ./dist my-app00.dot
+```
+
+### Programmatic
+
+```javascript
+import { deploy } from "bulletin-deploy";
+
+// Default (Kubo)
+await deploy("./dist", "my-app00.dot");
+
+// JS merkleization
+await deploy("./dist", "my-app00.dot", { jsMerkle: true });
+```
+
+The JS mode uses `ipfs-unixfs-importer` (the same chunker Kubo uses internally) and `@ipld/car` for CAR serialization. It runs entirely in-memory with no temp files.
+
 ## Resilience Features
 
 ### Chunk-level retry
@@ -161,7 +213,9 @@ What's tracked:
 - Pool account selection
 - Source metadata (repo, branch, PR number, CI vs local)
 
-Dashboard: https://polkadot-community-foundation.sentry.io/dashboards/92523/
+Dashboard:
+- Bulletin Deploy Health: https://paritytech.sentry.io/dashboard/1669817/
+- Deploy Failures Detail: https://paritytech.sentry.io/dashboard/1669818/
 
 ## Troubleshooting
 

package/dist/{chunk-HMCNHEMO.js → chunk-FBXG7YMT.js}

@@ -1,7 +1,7 @@
 import {
   captureWarning,
   withSpan
-} from "./chunk-DOBGWPA3.js";
+} from "./chunk-ZGP4DMFK.js";
 
 // src/dotns.ts
 import crypto from "crypto";

package/dist/{chunk-5B6UCUSH.js → chunk-TD73EZ5I.js}

@@ -4,7 +4,7 @@ import {
   TX_TIMEOUT_MS,
   fetchNonce,
   validateDomainLabel
-} from "./chunk-HMCNHEMO.js";
+} from "./chunk-FBXG7YMT.js";
 import {
   merkleizeJS
 } from "./chunk-GZ5UUECB.js";
@@ -21,7 +21,7 @@ import {
   setDeployAttribute,
   withDeploySpan,
   withSpan
-} from "./chunk-DOBGWPA3.js";
+} from "./chunk-ZGP4DMFK.js";
 
 // src/deploy.ts
 import { Buffer } from "buffer";

package/dist/{chunk-DOBGWPA3.js → chunk-ZGP4DMFK.js}

@@ -6,7 +6,7 @@ import * as path from "path";
 // package.json
 var package_default = {
   name: "bulletin-deploy",
-  version: "0.6.7-rc.0",
+  version: "0.6.7",
   private: false,
   repository: {
     type: "git",
@@ -175,6 +175,8 @@ function captureWarning(message, context) {
   try {
     Sentry.addBreadcrumb({ level: "warning", message, data: context });
     Sentry.captureMessage(message, { level: "warning", extra: context });
+    const root = Sentry.getRootSpan(Sentry.getActiveSpan());
+    if (root) root.setAttribute("deploy.sad", true);
   } catch {
   }
 }

package/dist/deploy.js

@@ -21,11 +21,11 @@ import {
   storeChunkedContent,
   storeDirectory,
   storeFile
-} from "./chunk-5B6UCUSH.js";
-import "./chunk-HMCNHEMO.js";
+} from "./chunk-TD73EZ5I.js";
+import "./chunk-FBXG7YMT.js";
 import "./chunk-GZ5UUECB.js";
 import "./chunk-LGPTJYA3.js";
-import "./chunk-DOBGWPA3.js";
+import "./chunk-ZGP4DMFK.js";
 import "./chunk-QGM4M3NI.js";
 export {
   DEFAULT_BULLETIN_RPC,

package/dist/dotns.js

@@ -19,8 +19,8 @@ import {
   sanitizeDomainLabel,
   stripTrailingDigits,
   validateDomainLabel
-} from "./chunk-HMCNHEMO.js";
-import "./chunk-DOBGWPA3.js";
+} from "./chunk-FBXG7YMT.js";
+import "./chunk-ZGP4DMFK.js";
 import "./chunk-QGM4M3NI.js";
 export {
   CONNECTION_TIMEOUT_MS,

package/dist/index.js

@@ -1,9 +1,9 @@
 import {
   deploy
-} from "./chunk-5B6UCUSH.js";
+} from "./chunk-TD73EZ5I.js";
 import {
   DotNS
-} from "./chunk-HMCNHEMO.js";
+} from "./chunk-FBXG7YMT.js";
 import {
   merkleizeJS
 } from "./chunk-GZ5UUECB.js";
@@ -14,7 +14,7 @@ import {
   fetchPoolAuthorizations,
   selectAccount
 } from "./chunk-LGPTJYA3.js";
-import "./chunk-DOBGWPA3.js";
+import "./chunk-ZGP4DMFK.js";
 import "./chunk-QGM4M3NI.js";
 export {
   DotNS,

package/dist/telemetry.js

@@ -8,7 +8,7 @@ import {
   setDeployAttribute,
   withDeploySpan,
   withSpan
-} from "./chunk-DOBGWPA3.js";
+} from "./chunk-ZGP4DMFK.js";
 import "./chunk-QGM4M3NI.js";
 export {
   VERSION,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bulletin-deploy",
-  "version": "0.6.7-rc.0",
+  "version": "0.6.7",
   "private": false,
   "repository": {
     "type": "git",