@happier-dev/relay-server 0.1.2 → 0.2.0

package/src/releaseAssets.mjs

@@ -1,33 +1,33 @@
-export function resolveServerReleaseAssets({ release, os, arch }) {
-  const assets = Array.isArray(release?.assets) ? release.assets : [];
-  const byName = new Map();
-  for (const asset of assets) {
-    const name = String(asset?.name ?? '');
-    const url = String(asset?.browser_download_url ?? '');
-    if (!name || !url) continue;
-    byName.set(name, { name, url });
-  }
-
-  const checksumsName = [...byName.keys()].find((name) => /^checksums-happier-server-v\d+\.\d+\.\d+\.txt$/.test(name));
-  if (!checksumsName) {
-    throw new Error('[server] missing checksums-happier-server-v<version>.txt asset');
-  }
-  const versionMatch = /^checksums-happier-server-v(\d+\.\d+\.\d+)\.txt$/.exec(checksumsName);
-  const version = versionMatch?.[1] ?? null;
-  if (!version) {
-    throw new Error('[server] unable to derive server version from checksums filename');
-  }
-
-  const checksumsSigName = `${checksumsName}.minisig`;
-  const tarballName = `happier-server-v${version}-${os}-${arch}.tar.gz`;
+import { resolveReleaseAssetBundle } from '@happier-dev/release-runtime/assets';
 
-  const checksums = byName.get(checksumsName) ?? null;
-  const checksumsSig = byName.get(checksumsSigName) ?? null;
-  const tarball = byName.get(tarballName) ?? null;
-
-  if (!checksums) throw new Error(`[server] missing release asset: ${checksumsName}`);
-  if (!checksumsSig) throw new Error(`[server] missing release asset: ${checksumsSigName}`);
-  if (!tarball) throw new Error(`[server] missing release asset: ${tarballName}`);
+export function resolveServerReleaseAssets({ release, os, arch }) {
+  const resolved = resolveReleaseAssetBundle({
+    assets: release?.assets,
+    product: 'happier-server',
+    os,
+    arch,
+    preferZipOnWindows: true,
+  });
+  return {
+    version: resolved.version,
+    tarball: resolved.archive,
+    checksums: resolved.checksums,
+    checksumsSig: resolved.checksumsSig,
+  };
+}
 
-  return { version, tarball, checksums, checksumsSig };
+export function resolveUiWebReleaseAssets({ release }) {
+  const resolved = resolveReleaseAssetBundle({
+    assets: release?.assets,
+    product: 'happier-ui-web',
+    os: 'web',
+    arch: 'any',
+    preferZipOnWindows: false,
+  });
+  return {
+    version: resolved.version,
+    tarball: resolved.archive,
+    checksums: resolved.checksums,
+    checksumsSig: resolved.checksumsSig,
+  };
 }

package/src/releaseAssets.test.mjs

@@ -1,7 +1,7 @@
 import test from 'node:test';
 import assert from 'node:assert/strict';
 
-import { resolveServerReleaseAssets } from './releaseAssets.mjs';
+import { resolveServerReleaseAssets, resolveUiWebReleaseAssets } from './releaseAssets.mjs';
 
 test('resolveServerReleaseAssets picks tarball + checksums + minisig for linux-x64', () => {
   const release = {
@@ -21,8 +21,40 @@ test('resolveServerReleaseAssets picks tarball + checksums + minisig for linux-x
   assert.equal(resolved.checksumsSig.name, 'checksums-happier-server-v0.1.0.txt.minisig');
 });
 
+test('resolveServerReleaseAssets prefers windows zip artifacts when available', () => {
+  const release = {
+    tag_name: 'server-preview',
+    assets: [
+      { name: 'checksums-happier-server-v0.2.0-preview.7.txt', browser_download_url: 'https://example/checksums.txt' },
+      { name: 'checksums-happier-server-v0.2.0-preview.7.txt.minisig', browser_download_url: 'https://example/checksums.txt.minisig' },
+      { name: 'happier-server-v0.2.0-preview.7-windows-x64.zip', browser_download_url: 'https://example/server-win.zip' },
+      { name: 'happier-server-v0.2.0-preview.7-windows-x64.tar.gz', browser_download_url: 'https://example/server-win.tgz' },
+    ],
+  };
+
+  const resolved = resolveServerReleaseAssets({ release, os: 'windows', arch: 'x64' });
+  assert.equal(resolved.version, '0.2.0-preview.7');
+  assert.equal(resolved.tarball.name, 'happier-server-v0.2.0-preview.7-windows-x64.zip');
+});
+
 test('resolveServerReleaseAssets throws when required assets are missing', () => {
   const release = { tag_name: 'server-preview', assets: [{ name: 'nope', browser_download_url: 'x' }] };
   assert.throws(() => resolveServerReleaseAssets({ release, os: 'linux', arch: 'x64' }));
 });
 
+test('resolveUiWebReleaseAssets picks ui-web tarball + checksums + minisig', () => {
+  const release = {
+    tag_name: 'ui-web-preview',
+    assets: [
+      { name: 'checksums-happier-ui-web-v0.3.0-preview.1.1.txt', browser_download_url: 'https://example/checksums.txt' },
+      { name: 'checksums-happier-ui-web-v0.3.0-preview.1.1.txt.minisig', browser_download_url: 'https://example/checksums.txt.minisig' },
+      { name: 'happier-ui-web-v0.3.0-preview.1.1-web-any.tar.gz', browser_download_url: 'https://example/ui-web.tgz' },
+    ],
+  };
+
+  const resolved = resolveUiWebReleaseAssets({ release });
+  assert.equal(resolved.version, '0.3.0-preview.1.1');
+  assert.equal(resolved.tarball.name, 'happier-ui-web-v0.3.0-preview.1.1-web-any.tar.gz');
+  assert.equal(resolved.checksums.name, 'checksums-happier-ui-web-v0.3.0-preview.1.1.txt');
+  assert.equal(resolved.checksumsSig.name, 'checksums-happier-ui-web-v0.3.0-preview.1.1.txt.minisig');
+});

package/src/runnerConfig.mjs

@@ -0,0 +1,69 @@
+import {
+  getReleaseRingCatalogEntry,
+  normalizePublicReleaseRingId,
+} from '@happier-dev/release-runtime/releaseRings';
+
+function parseArgs(argv) {
+  const kv = new Map();
+  const flags = new Set();
+  const positionals = [];
+  for (let i = 0; i < argv.length; i += 1) {
+    const a = argv[i];
+    if (a === '--') {
+      positionals.push(...argv.slice(i + 1));
+      break;
+    }
+    if (!String(a ?? '').startsWith('--')) {
+      positionals.push(String(a));
+      continue;
+    }
+    const next = argv[i + 1];
+    if (next && !String(next).startsWith('--')) {
+      kv.set(a, String(next));
+      i += 1;
+      continue;
+    }
+    flags.add(String(a));
+    kv.set(a, 'true');
+  }
+  return { kv, flags, positionals };
+}
+
+function normalizeChannel(raw) {
+  const requested = String(raw ?? '').trim() || 'stable';
+  const channel = normalizePublicReleaseRingId(requested);
+  if (!channel) {
+    throw new Error(`Invalid --channel '${requested}'. Expected stable|preview|dev.`);
+  }
+  return channel;
+}
+
+function parseBooleanFlag(raw, fallback) {
+  const value = String(raw ?? '').trim().toLowerCase();
+  if (!value) return fallback;
+  if (value === '1' || value === 'true' || value === 'yes' || value === 'y' || value === 'on') return true;
+  if (value === '0' || value === 'false' || value === 'no' || value === 'n' || value === 'off') return false;
+  return fallback;
+}
+
+export function parseRunnerInvocation(argv = []) {
+  const { kv, flags, positionals } = parseArgs(Array.isArray(argv) ? argv : []);
+  const channel = normalizeChannel(kv.get('--channel'));
+  const suffix = getReleaseRingCatalogEntry(channel).rollingReleaseSuffix;
+  if (!suffix) {
+    throw new Error(`Missing rolling release suffix for channel '${channel}'.`);
+  }
+  const serverTag = String(kv.get('--tag') ?? '').trim() || `server-${suffix}`;
+  const uiWebTag = String(kv.get('--ui-tag') ?? '').trim() || `ui-web-${suffix}`;
+
+  const withUiWeb =
+    !(flags.has('--without-ui') || parseBooleanFlag(kv.get('--with-ui'), true) === false);
+
+  return {
+    channel,
+    serverTag,
+    uiWebTag,
+    withUiWeb,
+    positionals,
+  };
+}

package/src/runnerConfig.test.mjs

@@ -0,0 +1,37 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+
+import { parseRunnerInvocation } from './runnerConfig.mjs';
+
+test('parseRunnerInvocation defaults to stable channel and installs ui web bundle', () => {
+  const parsed = parseRunnerInvocation([]);
+  assert.equal(parsed.channel, 'stable');
+  assert.equal(parsed.serverTag, 'server-stable');
+  assert.equal(parsed.uiWebTag, 'ui-web-stable');
+  assert.equal(parsed.withUiWeb, true);
+});
+
+test('parseRunnerInvocation resolves preview tags from channel', () => {
+  const parsed = parseRunnerInvocation(['--channel', 'preview']);
+  assert.equal(parsed.channel, 'preview');
+  assert.equal(parsed.serverTag, 'server-preview');
+  assert.equal(parsed.uiWebTag, 'ui-web-preview');
+});
+
+test('parseRunnerInvocation resolves dev user input to publicdev tags', () => {
+  const parsed = parseRunnerInvocation(['--channel', 'dev']);
+  assert.equal(parsed.channel, 'publicdev');
+  assert.equal(parsed.serverTag, 'server-dev');
+  assert.equal(parsed.uiWebTag, 'ui-web-dev');
+});
+
+test('parseRunnerInvocation honors explicit tag overrides', () => {
+  const parsed = parseRunnerInvocation(['--tag', 'server-preview', '--ui-tag', 'ui-web-preview']);
+  assert.equal(parsed.serverTag, 'server-preview');
+  assert.equal(parsed.uiWebTag, 'ui-web-preview');
+});
+
+test('parseRunnerInvocation supports --without-ui', () => {
+  const parsed = parseRunnerInvocation(['--without-ui']);
+  assert.equal(parsed.withUiWeb, false);
+});

package/src/target.mjs

@@ -0,0 +1,48 @@
+import { join } from 'node:path';
+
+export function resolveServerRunnerTarget({ platform, arch }) {
+  const p = String(platform ?? '').trim();
+  const a = String(arch ?? '').trim();
+  if (!p) {
+    throw new Error('Unsupported platform: (empty)');
+  }
+  if (p !== 'linux' && p !== 'darwin' && p !== 'win32') {
+    throw new Error(`Unsupported platform '${p}'. Expected linux|darwin|win32.`);
+  }
+
+  const os = p === 'win32' ? 'windows' : p;
+  if (a !== 'x64' && a !== 'arm64') {
+    throw new Error(`Unsupported architecture '${a}'. Expected x64 or arm64.`);
+  }
+  if (p === 'win32' && a !== 'x64') {
+    throw new Error(`Unsupported architecture '${a}' for windows. Expected x64.`);
+  }
+
+  return {
+    os,
+    arch: a,
+    exeName: os === 'windows' ? 'happier-server.exe' : 'happier-server',
+  };
+}
+
+export function resolveRunnerCacheRoot({ platform, homedir, env }) {
+  const p = String(platform ?? '').trim();
+  const home = String(homedir ?? '').trim();
+  const e = env && typeof env === 'object' ? env : {};
+
+  if (String(e.HAPPIER_CACHE_DIR ?? '').trim()) {
+    return String(e.HAPPIER_CACHE_DIR).trim();
+  }
+
+  if (p === 'win32') {
+    const local = String(e.LOCALAPPDATA ?? '').trim();
+    return local || join(home || 'C:\\\\Users\\\\Default', 'AppData', 'Local');
+  }
+  if (p === 'darwin') {
+    return join(home || '', 'Library', 'Caches');
+  }
+  const xdg = String(e.XDG_CACHE_HOME ?? '').trim();
+  if (xdg) return xdg;
+  return join(home || '', '.cache');
+}
+

package/src/target.test.mjs

@@ -0,0 +1,54 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { join } from 'node:path';
+
+import { resolveServerRunnerTarget, resolveRunnerCacheRoot } from './target.mjs';
+
+test('resolveServerRunnerTarget maps linux platforms to linux assets', () => {
+  assert.deepEqual(resolveServerRunnerTarget({ platform: 'linux', arch: 'x64' }), {
+    os: 'linux',
+    arch: 'x64',
+    exeName: 'happier-server',
+  });
+});
+
+test('resolveServerRunnerTarget maps darwin platforms to darwin assets', () => {
+  assert.deepEqual(resolveServerRunnerTarget({ platform: 'darwin', arch: 'arm64' }), {
+    os: 'darwin',
+    arch: 'arm64',
+    exeName: 'happier-server',
+  });
+});
+
+test('resolveServerRunnerTarget maps win32 platforms to windows assets', () => {
+  assert.deepEqual(resolveServerRunnerTarget({ platform: 'win32', arch: 'x64' }), {
+    os: 'windows',
+    arch: 'x64',
+    exeName: 'happier-server.exe',
+  });
+});
+
+test('resolveServerRunnerTarget rejects unsupported platform/arch combinations', () => {
+  assert.throws(() => resolveServerRunnerTarget({ platform: 'freebsd', arch: 'x64' }), /Unsupported platform/i);
+  assert.throws(() => resolveServerRunnerTarget({ platform: 'win32', arch: 'arm64' }), /Unsupported architecture/i);
+});
+
+test('resolveRunnerCacheRoot uses platform-specific defaults', () => {
+  assert.equal(
+    resolveRunnerCacheRoot({ platform: 'linux', homedir: '/home/me', env: {} }),
+    join('/home/me', '.cache')
+  );
+  assert.equal(
+    resolveRunnerCacheRoot({ platform: 'linux', homedir: '/home/me', env: { XDG_CACHE_HOME: '/tmp/xdg' } }),
+    '/tmp/xdg'
+  );
+  assert.equal(
+    resolveRunnerCacheRoot({ platform: 'darwin', homedir: '/Users/me', env: {} }),
+    join('/Users/me', 'Library', 'Caches')
+  );
+  assert.equal(
+    resolveRunnerCacheRoot({ platform: 'win32', homedir: 'C:\\\\Users\\\\me', env: { LOCALAPPDATA: 'C:\\\\Local' } }),
+    'C:\\\\Local'
+  );
+});
+