@le-space/node 0.1.0 → 0.1.2

package/index.d.ts

@@ -133,6 +133,7 @@ interface DeployExecutorDependencies {
     sender?: string;
     hasher?: MessageHasher;
     manifest?: RootfsManifest | null;
+    log?: (message: string) => void;
 }
 declare function executeDeployPlan(plan: DeployPlan, dependencies?: DeployExecutorDependencies): Promise<DeployOutputResult>;
 

package/index.js

@@ -664,12 +664,14 @@ async function waitForDeploymentResult(itemHash, options) {
   const delayMs = Math.max(0, Number(options.delayMs ?? 2e3));
   const sleep2 = options.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
   let lastResult = await inspectDeploymentResult(itemHash, options);
+  options.onAttempt?.(lastResult, 1, attempts);
   for (let attempt = 1; attempt < attempts; attempt += 1) {
     if (lastResult.status === "processed" || lastResult.status === "rejected") {
       return lastResult;
     }
     await sleep2(delayMs);
     lastResult = await inspectDeploymentResult(itemHash, options);
+    options.onAttempt?.(lastResult, attempt + 1, attempts);
   }
   return lastResult;
 }
@@ -1374,12 +1376,14 @@ async function waitForVmRuntime(args) {
   const delayMs = Math.max(0, Number(args.delayMs ?? 4e3));
   const sleep2 = args.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
   let lastRuntime = await fetchVmRuntime(args);
+  args.onAttempt?.(lastRuntime, 1, attempts);
   for (let attempt = 0; attempt < attempts - 1; attempt += 1) {
     if (lastRuntime.hostIpv4 && Object.keys(lastRuntime.mappedPorts ?? {}).length > 0) {
       return lastRuntime;
     }
     await sleep2(delayMs);
     lastRuntime = await fetchVmRuntime(args);
+    args.onAttempt?.(lastRuntime, attempt + 2, attempts);
   }
   if (lastRuntime.diagnostics) {
     lastRuntime.diagnostics.timedOut = true;
@@ -1458,10 +1462,12 @@ async function waitForSetupEndpoint(args) {
   const sleep2 = args.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
   const url = `http://${args.hostIpv4}:${args.setupPort}/health`;
   let result = await defaultHttpProbe(args.fetch, url, Number(args.httpTimeoutMs ?? 1e4));
+  args.onAttempt?.(result, 1, attempts);
   for (let attempt = 1; attempt < attempts; attempt += 1) {
     if (result.ok) return result;
     await sleep2(delayMs);
     result = await defaultHttpProbe(args.fetch, url, Number(args.httpTimeoutMs ?? 1e4));
+    args.onAttempt?.(result, attempt + 1, attempts);
   }
   return result;
 }
@@ -1512,6 +1518,12 @@ async function fetchUcGoPeerMetadata(args) {
       });
       const payload = await response.json().catch(() => null);
       lastPayload = payload;
+      args.onAttempt?.(
+        payload,
+        Boolean(response.ok && payload && typeof payload === "object" && payload.status === "ready"),
+        attempt + 1,
+        attempts
+      );
       if (response.ok && payload && typeof payload === "object" && payload.status === "ready") {
         return payload;
       }
@@ -1653,13 +1665,21 @@ async function executeDeployPlan(plan, dependencies = {}) {
   const hasher = dependencies.hasher ?? defaultHasher;
   const tcpProbe = dependencies.tcpProbe ?? defaultTcpProbe;
   const sleepImpl = dependencies.sleep ?? ((ms) => sleep(ms).then(() => void 0));
+  const log = dependencies.log ?? ((message) => console.log(message));
   const identity = dependencies.sender && dependencies.signer ? { address: dependencies.sender, signer: dependencies.signer } : await createPrivateKeyIdentity(plan.privateKey);
   const candidateCrns = await candidateCrnsForPlan(plan, fetchImpl);
   if (candidateCrns.length === 0) {
     throw new Error("No compatible CRN was available for deployment.");
   }
+  log(`[deploy] profile=${plan.profile} sender=${identity.address}`);
+  log(
+    `[deploy] candidate CRNs=${candidateCrns.map((crn) => `${crn.name ?? crn.hash}:${crn.hash}`).join(", ")}`
+  );
   let lastError = null;
-  for (const candidateCrn of candidateCrns) {
+  for (const [candidateIndex, candidateCrn] of candidateCrns.entries()) {
+    log(
+      `[deploy] attempting CRN ${candidateIndex + 1}/${candidateCrns.length}: ${candidateCrn.name ?? candidateCrn.hash} (${candidateCrn.hash})`
+    );
     const content = createInstanceContent({
       address: identity.address,
       name: plan.name,
@@ -1683,21 +1703,33 @@ async function executeDeployPlan(plan, dependencies = {}) {
       channel: plan.channel,
       sync: true
     });
+    log(`[deploy] broadcasted INSTANCE message ${deployment.itemHash} on ${candidateCrn.name ?? candidateCrn.hash}`);
     const inspection = await waitForDeploymentResult(deployment.itemHash, {
       rootfsRef: plan.rootfsItemHash,
       apiHost: plan.apiHost,
       fetch: fetchImpl,
       attempts: plan.waitAttempts,
       delayMs: plan.waitDelayMs,
-      sleep: sleepImpl
+      sleep: sleepImpl,
+      onAttempt: (result, attempt, attempts) => {
+        log(
+          `[deploy] Aleph processing ${attempt}/${attempts} for ${deployment.itemHash}: status=${result.status}${result.rejectionReason ? ` reason=${result.rejectionReason}` : ""}`
+        );
+      }
     });
     if (inspection.status === "rejected") {
+      log(
+        `[deploy] CRN ${candidateCrn.name ?? candidateCrn.hash} rejected deployment ${deployment.itemHash}: ${inspection.rejectionReason ?? "no additional reason"}`
+      );
       lastError = new Error(
         `Deployment on ${candidateCrn.name ?? candidateCrn.hash} was rejected: ${inspection.rejectionReason ?? "no additional rejection reason from Aleph"}.`
       );
       continue;
     }
     if (inspection.status !== "processed") {
+      log(
+        `[deploy] deployment ${deployment.itemHash} on ${candidateCrn.name ?? candidateCrn.hash} did not become processed; cleaning up`
+      );
       await cleanupFailedDeployment({
         sender: identity.address,
         instanceItemHash: deployment.itemHash,
@@ -1715,6 +1747,7 @@ async function executeDeployPlan(plan, dependencies = {}) {
     }
     let portForwarding = null;
     if (plan.publishPortForwards && plan.requiredPorts.length > 0) {
+      log(`[deploy] publishing required port-forward aggregate for ${deployment.itemHash}`);
       const aggregate = await ensureInstancePortForwards({
         sender: identity.address,
         instanceItemHash: deployment.itemHash,
@@ -1730,7 +1763,19 @@ async function executeDeployPlan(plan, dependencies = {}) {
         aggregateItemHash: aggregate.aggregateItemHash,
         aggregateStatus: aggregate.aggregateStatus
       };
+      log(
+        `[deploy] port-forward aggregate published: item_hash=${aggregate.aggregateItemHash} status=${aggregate.aggregateStatus}`
+      );
     }
+    if (candidateCrn.address) {
+      log(`[deploy] notifying CRN allocation endpoint ${candidateCrn.address}`);
+      await notifyCrnAllocation({
+        crnUrl: candidateCrn.address,
+        itemHash: deployment.itemHash,
+        fetch: fetchImpl
+      }).catch(() => null);
+    }
+    log(`[deploy] waiting for runtime networking on ${candidateCrn.name ?? candidateCrn.hash}`);
     const runtime = await waitForVmRuntime({
       itemHash: deployment.itemHash,
       fetch: fetchImpl,
@@ -1739,7 +1784,12 @@ async function executeDeployPlan(plan, dependencies = {}) {
       crnListUrl: plan.crnListUrl,
       attempts: plan.runtimeAttempts,
       delayMs: plan.runtimeDelayMs,
-      sleep: sleepImpl
+      sleep: sleepImpl,
+      onAttempt: (runtimeAttempt, attempt, attempts) => {
+        log(
+          `[deploy] runtime ${attempt}/${attempts} for ${deployment.itemHash}: state=${runtimeAttempt.diagnostics?.state ?? "unknown"} host=${runtimeAttempt.hostIpv4 ?? "-"} mapped_ports=${Object.keys(runtimeAttempt.mappedPorts ?? {}).length}`
+        );
+      }
     }).catch(() => null);
     const runtimeMetadata = runtime ? {
       allocation: runtime.allocation,
@@ -1763,6 +1813,9 @@ async function executeDeployPlan(plan, dependencies = {}) {
       selectedCrn: { hash: candidateCrn.hash, name: candidateCrn.name ?? "" }
     };
     if (!runtime?.hostIpv4 || Object.keys(runtime?.mappedPorts ?? {}).length === 0) {
+      log(
+        `[deploy] processed deployment ${deployment.itemHash} never exposed usable runtime networking on ${candidateCrn.name ?? candidateCrn.hash}; cleaning up`
+      );
       await cleanupFailedDeployment({
         sender: identity.address,
         instanceItemHash: deployment.itemHash,
@@ -1780,13 +1833,6 @@ async function executeDeployPlan(plan, dependencies = {}) {
     }
     let configuration = null;
     let verification = null;
-    if (runtime.selectedCrn?.address) {
-      await notifyCrnAllocation({
-        crnUrl: runtime.selectedCrn.address,
-        itemHash: deployment.itemHash,
-        fetch: fetchImpl
-      }).catch(() => null);
-    }
     if (runtime.hostIpv4 && plan.autoConfigure !== false && plan.profile === "uc-go-peer") {
       const mappedPorts = runtime.mappedPorts ?? {};
       const setupPort = mappedPorts["80"]?.host ?? null;
@@ -1795,6 +1841,7 @@ async function executeDeployPlan(plan, dependencies = {}) {
       const udpPort = mappedPorts["9095"]?.udp === true ? mappedPorts["9095"]?.host ?? null : null;
       const proxyUrl = plan.enableCaddyProxy ? runtime.proxyUrl ?? null : null;
       if (setupPort && runtime.hostIpv4) {
+        log(`[deploy] waiting for temporary setup endpoint on http://${runtime.hostIpv4}:${setupPort}/health`);
         const setupHealth = await waitForSetupEndpoint({
           hostIpv4: runtime.hostIpv4,
           setupPort,
@@ -1802,10 +1849,16 @@ async function executeDeployPlan(plan, dependencies = {}) {
           attempts: plan.setupAttempts,
           delayMs: plan.setupDelayMs,
           httpTimeoutMs: plan.httpTimeoutMs,
-          sleep: sleepImpl
+          sleep: sleepImpl,
+          onAttempt: (result, attempt, attempts) => {
+            log(
+              `[deploy] setup endpoint ${attempt}/${attempts}: ok=${result.ok} status=${result.status ?? "-"} error=${result.error ?? "-"}`
+            );
+          }
         });
         runtimeMetadata.setupHealth = setupHealth;
         if (!setupHealth.ok) {
+          log(`[deploy] setup endpoint never became reachable; cleaning up ${deployment.itemHash}`);
           await cleanupFailedDeployment({
             sender: identity.address,
             instanceItemHash: deployment.itemHash,
@@ -1819,6 +1872,7 @@ async function executeDeployPlan(plan, dependencies = {}) {
           lastError = new Error(`Temporary setup endpoint did not become reachable at http://${runtime.hostIpv4}:${setupPort}/health.`);
           continue;
         }
+        log(`[deploy] calling guest /configure for ${deployment.itemHash}`);
         const configureResult = await configureUcGoPeer({
           hostIpv4: runtime.hostIpv4,
           publicIpv6: runtime.ipv6,
@@ -1832,6 +1886,7 @@ async function executeDeployPlan(plan, dependencies = {}) {
           fetch: fetchImpl,
           timeoutMs: plan.configureTimeoutMs
         });
+        log(`[deploy] polling guest /metadata until ready`);
         const metadataResult = await fetchUcGoPeerMetadata({
           hostIpv4: runtime.hostIpv4,
           setupPort,
@@ -1839,7 +1894,10 @@ async function executeDeployPlan(plan, dependencies = {}) {
           attempts: plan.metadataAttempts,
           delayMs: plan.metadataDelayMs,
           timeoutMs: plan.metadataTimeoutMs,
-          sleep: sleepImpl
+          sleep: sleepImpl,
+          onAttempt: (_payload, ready, attempt, attempts) => {
+            log(`[deploy] guest metadata ${attempt}/${attempts}: ready=${ready}`);
+          }
         });
         configuration = {
           ...configureResult && typeof configureResult === "object" ? configureResult : {},
@@ -1848,6 +1906,7 @@ async function executeDeployPlan(plan, dependencies = {}) {
         if (plan.verifyReachability !== false) {
           let latestVerification = null;
           for (let attempt = 0; attempt < plan.verifyAttempts; attempt += 1) {
+            log(`[deploy] reachability verification ${attempt + 1}/${plan.verifyAttempts}`);
             latestVerification = await verifyUcGoPeerReachability({
               hostIpv4: runtime.hostIpv4,
               mappedPorts,
@@ -1860,9 +1919,11 @@ async function executeDeployPlan(plan, dependencies = {}) {
               tcpProbe
             });
             if (latestVerification?.ok) {
+              log(`[deploy] reachability verification succeeded`);
               break;
             }
             if (attempt < plan.verifyAttempts - 1) {
+              log(`[deploy] reachability verification not ready yet; sleeping ${plan.verifyDelayMs}ms`);
               await sleepImpl(plan.verifyDelayMs);
             }
           }
@@ -1886,6 +1947,7 @@ async function executeDeployPlan(plan, dependencies = {}) {
       verification
     };
   }
+  log(`[deploy] no candidate CRN succeeded`);
   throw lastError ?? new Error("No compatible CRN deployment attempt succeeded.");
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@le-space/node",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Node and GitHub Actions adapters for shared Aleph tooling.",
   "license": "MIT",
   "type": "module",
@@ -16,8 +16,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@le-space/core": "0.1.0",
-    "@le-space/shared-types": "0.1.0",
+    "@le-space/core": "0.1.2",
+    "@le-space/shared-types": "0.1.2",
     "ethers": "^6.15.0"
   }
 }