@previewio/cli 0.2.0-007a84d

package/bin/preview

@@ -0,0 +1,3 @@
+#!/bin/sh
+echo "error: run npm install without --ignore-scripts so the Preview CLI binary can download." >&2
+exit 1

package/install.mjs

@@ -0,0 +1,128 @@
+import { chmodSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const PUBLIC_DOWNLOAD_ORIGIN = 'https://download.preview.io';
+const VERSION_PATTERN = /^[A-Za-z0-9._-]+$/;
+const RESERVED_VERSIONS = new Set(['latest', 'install', '.', '..']);
+const BINARY_FETCH_TIMEOUT_MS = 120_000;
+
+export function binaryObjectName(platform, arch) {
+  if (platform === 'darwin' && arch === 'arm64') return 'preview-darwin-arm64';
+  if (platform === 'darwin' && (arch === 'x64' || arch === 'x86_64')) return 'preview-darwin-x64';
+  if (platform === 'linux' && (arch === 'x64' || arch === 'x86_64')) return 'preview-linux-x64';
+  if (platform === 'win32' && (arch === 'x64' || arch === 'x86_64')) return 'preview-windows-x64.exe';
+  return undefined;
+}
+
+function assertReleaseVersion(version) {
+  if (!VERSION_PATTERN.test(version) || RESERVED_VERSIONS.has(version) || version === '0.0.0-dev') {
+    throw new Error(`Invalid CLI release version ${version}. Publish stamps the package version to the CDN stamp.`);
+  }
+}
+
+export function downloadUrl(origin, version, object) {
+  assertReleaseVersion(version);
+  return `${origin.replace(/\/+$/, '')}/cli/${version}/${object}`;
+}
+
+function installedBinaryName(platform) {
+  return platform === 'win32' ? 'preview.exe' : 'preview';
+}
+
+function npmGlobalInstall(env) {
+  const value = env.npm_config_global?.trim().toLowerCase();
+  return value === '1' || value === 'true' || value === 'yes';
+}
+
+function windowsShimDirs(packageRoot, env) {
+  const dirs = [join(packageRoot, '..', '..', '.bin')];
+  const prefix = env.npm_config_prefix?.trim();
+  if (prefix && npmGlobalInstall(env)) dirs.push(prefix);
+  return dirs;
+}
+
+function writeWindowsLaunchers(exePath, packageRoot, env) {
+  const cmd = `@ECHO OFF\r\n"${exePath}" %*\r\n`;
+  const ps1 = `& '${exePath.replaceAll("'", "''")}' @args\r\n`;
+  const sh = `#!/bin/sh\nexec "${exePath}" "$@"\n`;
+  for (const dir of windowsShimDirs(packageRoot, env)) {
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(join(dir, 'preview.cmd'), cmd);
+    writeFileSync(join(dir, 'preview.ps1'), ps1);
+    writeFileSync(join(dir, 'preview'), sh);
+    chmodSync(join(dir, 'preview'), 0o755);
+  }
+}
+
+export function looksLikePublishedBinary(bytes, platform) {
+  if (platform === 'linux') {
+    return bytes.byteLength >= 4 && bytes[0] === 0x7f && bytes[1] === 0x45 && bytes[2] === 0x4c && bytes[3] === 0x46;
+  }
+  if (platform === 'darwin') {
+    if (bytes.byteLength < 4) return false;
+    const magic = ((bytes[0] << 24) | (bytes[1] << 16) | (bytes[2] << 8) | bytes[3]) >>> 0;
+    return (
+      magic === 0xfeedface ||
+      magic === 0xfeedfacf ||
+      magic === 0xcefaedfe ||
+      magic === 0xcffaedfe ||
+      magic === 0xcafebabe ||
+      magic === 0xbebafeca
+    );
+  }
+  if (platform === 'win32') {
+    return bytes.byteLength >= 2 && bytes[0] === 0x4d && bytes[1] === 0x5a;
+  }
+  return false;
+}
+
+function packageVersion(packageRoot) {
+  return JSON.parse(readFileSync(join(packageRoot, 'package.json'), 'utf8')).version;
+}
+
+async function fetchBinary(url, fetchImpl) {
+  const response = await fetchImpl(url, { signal: AbortSignal.timeout(BINARY_FETCH_TIMEOUT_MS) });
+  if (!response.ok) {
+    throw new Error(`Failed to download Preview CLI from ${url} (${response.status})`);
+  }
+  const contentType = response.headers.get('content-type') ?? '';
+  if (contentType.includes('text/html')) {
+    throw new Error(`Refused HTML body from ${url}`);
+  }
+  return new Uint8Array(await response.arrayBuffer());
+}
+
+export async function install(opts = {}) {
+  const packageRoot = opts.packageRoot ?? dirname(fileURLToPath(import.meta.url));
+  const version = opts.version ?? packageVersion(packageRoot);
+  const platform = opts.platform ?? process.platform;
+  const arch = opts.arch ?? process.arch;
+  const object = binaryObjectName(platform, arch);
+  if (!object) {
+    throw new Error(`Unsupported platform: ${platform} ${arch}`);
+  }
+  const url = downloadUrl(opts.origin ?? PUBLIC_DOWNLOAD_ORIGIN, version, object);
+  const dest = join(opts.binDir ?? join(packageRoot, 'bin'), installedBinaryName(platform));
+  const bytes = await fetchBinary(url, opts.fetch ?? globalThis.fetch);
+  if (bytes.byteLength === 0 || !looksLikePublishedBinary(bytes, platform)) {
+    throw new Error(`Refused non-binary body from ${url}`);
+  }
+  mkdirSync(dirname(dest), { recursive: true });
+  const tmp = `${dest}.download`;
+  writeFileSync(tmp, bytes);
+  chmodSync(tmp, 0o755);
+  renameSync(tmp, dest);
+  if (platform === 'win32') {
+    writeWindowsLaunchers(dest, packageRoot, opts.env ?? process.env);
+  }
+  return dest;
+}
+
+const invoked = process.argv[1] ? resolve(process.argv[1]) : '';
+if (invoked && invoked === fileURLToPath(import.meta.url)) {
+  install({}).catch((err) => {
+    console.error(err instanceof Error ? err.message : err);
+    process.exit(1);
+  });
+}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@previewio/cli",
+  "version": "0.2.0-007a84d",
+  "description": "Preview CLI — JSON-first client for agentic tooling",
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TheRenderDepartment/preview.git",
+    "directory": "tools/preview-cli/npm"
+  },
+  "bin": {
+    "preview": "bin/preview"
+  },
+  "files": [
+    "bin",
+    "install.mjs"
+  ],
+  "scripts": {
+    "postinstall": "node install.mjs"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}