@t3x-dev/local 0.1.4 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@t3x-dev/local",
-  "version": "0.1.4",
+  "version": "0.3.0",
   "description": "T3X local entry package",
   "license": "Apache-2.0",
   "type": "module",
@@ -38,10 +38,10 @@
   },
   "dependencies": {
     "@hono/node-server": "^1.15.2",
-    "@t3x-dev/api": "0.1.4",
-    "@t3x-dev/cli": "0.1.4",
-    "@t3x-dev/mcp": "0.1.4",
-    "@t3x-dev/storage": "0.1.4",
+    "@t3x-dev/api": "0.3.0",
+    "@t3x-dev/cli": "0.3.0",
+    "@t3x-dev/mcp": "0.3.0",
+    "@t3x-dev/storage": "0.3.0",
     "commander": "^13.1.0"
   },
   "devDependencies": {

package/runtime-manifest.json

@@ -1,26 +1,26 @@
 {
   "manifestVersion": 1,
-  "packageVersion": "0.1.4",
-  "fixedVersion": "0.1.4",
-  "generatedAt": "2026-04-27T05:44:57.580Z",
+  "packageVersion": "0.3.0",
+  "fixedVersion": "0.3.0",
+  "generatedAt": "2026-05-03T07:35:37.449Z",
   "dependencies": {
-    "@t3x-dev/yops": "0.1.4",
-    "@t3x-dev/yschema": "0.1.4",
-    "@t3x-dev/core": "0.1.4",
-    "@t3x-dev/storage": "0.1.4",
-    "@t3x-dev/api": "0.1.4",
-    "@t3x-dev/api-client": "0.1.4",
-    "@t3x-dev/cli": "0.1.4",
-    "@t3x-dev/mcp": "0.1.4",
-    "@t3x-dev/local": "0.1.4",
+    "@t3x-dev/yops": "0.3.0",
+    "@t3x-dev/yschema": "0.3.0",
+    "@t3x-dev/core": "0.3.0",
+    "@t3x-dev/storage": "0.3.0",
+    "@t3x-dev/api": "0.3.0",
+    "@t3x-dev/api-client": "0.3.0",
+    "@t3x-dev/cli": "0.3.0",
+    "@t3x-dev/mcp": "0.3.0",
+    "@t3x-dev/local": "0.3.0",
     "web": "0.1.0"
   },
   "platforms": {
     "darwin-arm64": {
-      "fileName": "t3x-local-runtime-0.1.4-darwin-arm64.tar.gz",
-      "url": "https://github.com/t3x-dev/t3x-core/releases/download/t3x-local-v0.1.4/t3x-local-runtime-0.1.4-darwin-arm64.tar.gz",
-      "sha256": "6d5ab00096f233a4a02ab982cdea0375d3ec793d5f7454bfc7bf9cd2fd90b830",
-      "size": 20377274
+      "fileName": "t3x-local-runtime-0.3.0-darwin-arm64.tar.gz",
+      "url": "https://github.com/t3x-dev/t3x-core/releases/download/t3x-local-v0.3.0/t3x-local-runtime-0.3.0-darwin-arm64.tar.gz",
+      "sha256": "7f9c52d3ce51585aa7232bd2d16078f8e6e080264224862462423429227d4cbb",
+      "size": 20420629
     }
   }
 }

package/scripts/postinstall-download.mjs

@@ -2,9 +2,13 @@
 
 import { spawnSync } from 'node:child_process';
 import crypto from 'node:crypto';
+import { createWriteStream } from 'node:fs';
 import fs from 'node:fs/promises';
 import os from 'node:os';
 import path from 'node:path';
+import { Readable } from 'node:stream';
+import { pipeline } from 'node:stream/promises';
+import { setTimeout as sleep } from 'node:timers/promises';
 import {
   assertRuntimeLayout,
   ensureDir,
@@ -36,6 +40,11 @@ const LOCAL_DIRECT_FIXED_DEPENDENCIES = [
   '@t3x-dev/storage',
 ];
 const GITHUB_TOKEN_ENV_NAMES = ['T3X_LOCAL_GITHUB_TOKEN', 'GH_TOKEN', 'GITHUB_TOKEN'];
+const DOWNLOAD_MAX_ATTEMPTS = parsePositiveInt(process.env.T3X_LOCAL_DOWNLOAD_ATTEMPTS, 3);
+const DOWNLOAD_RETRY_DELAY_MS = parsePositiveInt(
+  process.env.T3X_LOCAL_DOWNLOAD_RETRY_DELAY_MS,
+  3000
+);
 
 if (process.env.T3X_LOCAL_SKIP_DOWNLOAD === '1' || process.env.T3X_LOCAL_SKIP_DOWNLOAD === 'true') {
   console.log(
@@ -132,20 +141,58 @@ async function downloadArtifact(source, destinationPath) {
   }
 
   if (source.startsWith('http://') || source.startsWith('https://')) {
-    const response = await fetchRuntimeArtifact(source);
+    await downloadHttpArtifact(source, destinationPath);
+    return;
+  }
+
+  await fs.copyFile(source, destinationPath);
+}
+
+async function downloadHttpArtifact(source, destinationPath) {
+  let lastError = null;
+
+  for (let attempt = 1; attempt <= DOWNLOAD_MAX_ATTEMPTS; attempt += 1) {
+    try {
+      await fs.rm(destinationPath, { force: true });
 
-    if (!response.ok) {
-      throw new Error(
-        `[t3x-local:postinstall] Failed to download runtime: HTTP ${response.status}${getDownloadHint(source)}`
+      const response = await fetchRuntimeArtifact(source);
+      if (!response.ok) {
+        throw buildHttpDownloadError(source, response.status);
+      }
+
+      await writeResponseBody(response, destinationPath);
+      return;
+    } catch (error) {
+      lastError = error;
+
+      if (attempt === DOWNLOAD_MAX_ATTEMPTS || !isRetryableDownloadError(error)) {
+        throw error;
+      }
+
+      console.log(
+        `[t3x-local:postinstall] Runtime download failed (${getErrorSummary(error)}). Retrying ${attempt + 1}/${DOWNLOAD_MAX_ATTEMPTS}...`
       );
+      await sleep(DOWNLOAD_RETRY_DELAY_MS * attempt);
     }
+  }
 
-    const arrayBuffer = await response.arrayBuffer();
-    await fs.writeFile(destinationPath, new Uint8Array(arrayBuffer));
-    return;
+  throw lastError;
+}
+
+async function writeResponseBody(response, destinationPath) {
+  if (!response.body) {
+    throw new Error('[t3x-local:postinstall] Runtime download response did not contain a body');
   }
 
-  await fs.copyFile(source, destinationPath);
+  await pipeline(Readable.fromWeb(response.body), createWriteStream(destinationPath));
+}
+
+function buildHttpDownloadError(source, status) {
+  const error = new Error(
+    `[t3x-local:postinstall] Failed to download runtime: HTTP ${status}${getDownloadHint(source)}`
+  );
+  error.httpStatus = status;
+  return error;
 }
 
 async function fetchRuntimeArtifact(source) {
@@ -287,6 +334,35 @@ function isAuthRetryStatus(status) {
   return status === 403 || status === 404;
 }
 
+function isRetryableDownloadError(error) {
+  if (isRetryableHttpStatus(error?.httpStatus)) {
+    return true;
+  }
+
+  const code = error?.code ?? error?.cause?.code;
+  return (
+    code === 'ETIMEDOUT' ||
+    code === 'ECONNRESET' ||
+    code === 'EPIPE' ||
+    code === 'UND_ERR_BODY_TIMEOUT' ||
+    code === 'UND_ERR_SOCKET' ||
+    error instanceof TypeError
+  );
+}
+
+function isRetryableHttpStatus(status) {
+  return status === 408 || status === 429 || (status >= 500 && status <= 599);
+}
+
+function getErrorSummary(error) {
+  return error?.cause?.code ?? error?.code ?? error?.message ?? String(error);
+}
+
+function parsePositiveInt(value, fallbackValue) {
+  const parsed = Number.parseInt(value ?? '', 10);
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : fallbackValue;
+}
+
 async function verifyArchiveSha(archivePath, expectedSha) {
   const file = await fs.readFile(archivePath);
   const actualSha = crypto.createHash('sha256').update(file).digest('hex');