@lerna-labs/hydra-sdk 1.0.0-beta.26 → 1.0.0-beta.28

package/dist/ipfs/ipfs.js

@@ -35,15 +35,28 @@ export function createIpfsClient(config) {
      * @returns The CID of the wrapping IPFS directory.
      */
     async function pinDirectory(dirPath) {
-        const entries = await fs.readdir(dirPath);
         const form = new FormData();
-        for (const entry of entries) {
-            const filePath = path.join(dirPath, entry);
-            const stat = await fs.stat(filePath);
-            if (!stat.isFile())
-                continue;
-            const content = await fs.readFile(filePath, 'utf-8');
-            form.append('file', new Blob([content]), entry);
+        const collectFiles = async (rel) => {
+            const out = [];
+            const dirents = await fs.readdir(path.join(dirPath, rel), { withFileTypes: true });
+            for (const dirent of dirents) {
+                const childRel = path.join(rel, dirent.name);
+                if (dirent.isDirectory()) {
+                    out.push(...(await collectFiles(childRel)));
+                }
+                else if (dirent.isFile()) {
+                    out.push(childRel);
+                }
+            }
+            return out;
+        };
+        for (const relPath of await collectFiles('')) {
+            const buf = await fs.readFile(path.join(dirPath, relPath));
+            const content = new Uint8Array(buf).slice().buffer;
+            // Kubo reconstructs the directory tree from entry names — always
+            // use POSIX separators so Windows callers get the same CID.
+            const entryName = relPath.split(path.sep).join('/');
+            form.append('file', new Blob([content]), entryName);
         }
         const res = await fetch(`${apiUrl}/api/v0/add?pin=true&wrap-with-directory=true&recursive=true`, {
             method: 'POST',

package/dist/wrangler.d.ts

@@ -70,11 +70,22 @@ export declare class Wrangler {
     shutdownHead(): Promise<void>;
     /**
      * Wait for the Hydra head to fully close and finalize.
+     *
+     * Resolves on the `HeadIsClosed` / `HeadIsFinalized` transition events, **and**
+     * on the initial `Greetings` replay if the head is already at `Closed` or
+     * `Final`. Rejects fast if the head is `Idle` (no head exists to close).
+     *
      * @param timeoutMs - Maximum time to wait in milliseconds.
      */
     waitForHeadClose(timeoutMs?: number): Promise<void>;
     /**
      * Wait for the Hydra head to reach the `Open` state.
+     *
+     * Resolves on the `HeadIsOpen` transition event, **and** on the initial
+     * `Greetings` replay if the head is already `Open`. Rejects fast if the
+     * head is in a terminal or shutting-down state (`Closed`, `FanoutPossible`,
+     * `Final`) — a new head must be started from a fresh node.
+     *
      * @param commitArgs - UTxO to commit into the head during initialization.
      * @param timeoutMs - Maximum time to wait in milliseconds.
      */

package/dist/wrangler.js

@@ -140,6 +140,11 @@ export class Wrangler {
     }
     /**
      * Wait for the Hydra head to fully close and finalize.
+     *
+     * Resolves on the `HeadIsClosed` / `HeadIsFinalized` transition events, **and**
+     * on the initial `Greetings` replay if the head is already at `Closed` or
+     * `Final`. Rejects fast if the head is `Idle` (no head exists to close).
+     *
      * @param timeoutMs - Maximum time to wait in milliseconds.
      */
     async waitForHeadClose(timeoutMs = 180000) {
@@ -153,14 +158,30 @@ export class Wrangler {
                 case 'ReadyToFanout':
                     this.ws.send({ tag: 'Fanout' });
                     break;
-                case 'Greetings':
-                    this.onGreetings(message.headStatus).catch((err) => reject(new Error(`Greetings handler failed: ${String(err)}`)));
+                case 'Greetings': {
+                    const status = message.headStatus;
+                    if (status === 'Closed' || status === 'Final') {
+                        resolve();
+                        return;
+                    }
+                    if (status === 'Idle') {
+                        reject(new Error(`Cannot wait for head to close: head is "Idle" — no head exists to close`));
+                        return;
+                    }
+                    this.onGreetings(status).catch((err) => reject(new Error(`Greetings handler failed: ${String(err)}`)));
                     break;
+                }
             }
         }, timeoutMs, 'Timeout waiting for head to close!');
     }
     /**
      * Wait for the Hydra head to reach the `Open` state.
+     *
+     * Resolves on the `HeadIsOpen` transition event, **and** on the initial
+     * `Greetings` replay if the head is already `Open`. Rejects fast if the
+     * head is in a terminal or shutting-down state (`Closed`, `FanoutPossible`,
+     * `Final`) — a new head must be started from a fresh node.
+     *
      * @param commitArgs - UTxO to commit into the head during initialization.
      * @param timeoutMs - Maximum time to wait in milliseconds.
      */
@@ -176,7 +197,16 @@ export class Wrangler {
                 this.doCommit(commitArgs).catch((err) => reject(new Error(`Commit failed: ${String(err)}`)));
             }
             else if (message.tag === 'Greetings') {
-                this.onGreetings(message.headStatus, commitArgs).catch((err) => reject(new Error(`Greetings handler failed: ${String(err)}`)));
+                const status = message.headStatus;
+                if (status === 'Open') {
+                    resolve();
+                    return;
+                }
+                if (status === 'Closed' || status === 'FanoutPossible' || status === 'Final') {
+                    reject(new Error(`Cannot wait for head to open: head is "${status}" (terminal or shutting down)`));
+                    return;
+                }
+                this.onGreetings(status, commitArgs).catch((err) => reject(new Error(`Greetings handler failed: ${String(err)}`)));
             }
         }, timeoutMs, 'Timeout waiting for head to open');
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lerna-labs/hydra-sdk",
-  "version": "1.0.0-beta.26",
+  "version": "1.0.0-beta.28",
   "description": "TypeScript SDK for managing Cardano Hydra Heads — lifecycle, UTxO queries, wallet management, transaction submission, and signature verification",
   "keywords": [
     "cardano",