@rathnasgala/cli 0.0.21 → 1.0.0

package/src/upgrade-command.js

@@ -1,81 +0,0 @@
-import { lstat, readFile, rm } from 'node:fs/promises';
-import path from 'node:path';
-import { parse, stringify } from 'yaml';
-
-import { repairFramework } from './doctor-command.js';
-import { fetchVerifiedThemePackage } from './theme-package.js';
-
-const NAME = '@rathnasgala/theme';
-const ACTION_WORKFLOW = '.github/workflows/publish.yml';
-const ACTION_REFERENCE = /rathnasgala\/publish\/\.github\/workflows\/publish\.yml@v([1-9][0-9]*)/g;
-const ACTION_TAG = /^v([1-9][0-9]*)(?:\.[0-9]+\.[0-9]+(?:[-+][0-9A-Za-z.-]+)?)?$/;
-
-async function registryMetadata(fetchImpl) {
-  const response = await fetchImpl(`https://registry.npmjs.org/${encodeURIComponent(NAME)}`, {
-    headers: { Accept: 'application/json' }
-  });
-  if (!response.ok) throw new Error(`Theme registry request failed with HTTP ${response.status}`);
-  return response.json();
-}
-
-export async function inspectActionUpgrade({ root, fetchImpl = fetch }) {
-  const workflowPath = path.resolve(root, ACTION_WORKFLOW);
-  const metadata = await lstat(workflowPath);
-  if (!metadata.isFile() || metadata.isSymbolicLink()) {
-    throw new TypeError('Publish workflow must be a regular file');
-  }
-  const workflow = await readFile(workflowPath, 'utf8');
-  const majors = [...workflow.matchAll(ACTION_REFERENCE)].map((match) => Number(match[1]));
-  if (majors.length === 0 || new Set(majors).size !== 1) {
-    throw new Error('Publish workflow must reference exactly one Gala action major');
-  }
-  const response = await fetchImpl('https://api.github.com/repos/rathnasgala/publish/tags?per_page=100', {
-    headers: { Accept: 'application/vnd.github+json', 'X-GitHub-Api-Version': '2026-03-10' }
-  });
-  if (!response.ok) throw new Error(`Action release lookup failed with HTTP ${response.status}`);
-  const tags = await response.json();
-  if (!Array.isArray(tags)) throw new TypeError('Action release response must be an array');
-  const releasedMajors = tags.map((tag) => ACTION_TAG.exec(tag?.name)?.[1])
-    .filter((major) => major != null).map(Number);
-  const currentMajor = majors[0];
-  const latestMajor = releasedMajors.length === 0 ? currentMajor : Math.max(...releasedMajors);
-  return Object.freeze({ currentMajor, latestMajor, newerAvailable: latestMajor > currentMajor });
-}
-
-export async function upgradeTheme({ root, channel, confirm, fetchImpl = fetch }) {
-  const configPath = path.resolve(root, 'site.config.yml');
-  const config = parse(await readFile(configPath, 'utf8'));
-  if (config?.canonicalPolicy != null) {
-    if (config.canonicalPolicy !== 'self' || config.hosting == null || Array.isArray(config.hosting)
-        || (config.hosting.canonicalPolicy != null && config.hosting.canonicalPolicy !== 'self')) {
-      throw new TypeError('Legacy canonicalPolicy cannot be migrated safely');
-    }
-    config.hosting.canonicalPolicy = 'self';
-    delete config.canonicalPolicy;
-  }
-  const installed = config?.framework?.themePackage?.version;
-  const [metadata, action] = await Promise.all([
-    registryMetadata(fetchImpl), inspectActionUpgrade({ root, fetchImpl })
-  ]);
-  const selectedChannel = channel ?? (metadata['dist-tags']?.next === installed ? 'next' : 'latest');
-  if (!['latest', 'next'].includes(selectedChannel)) throw new TypeError('theme channel must be latest or next');
-  const version = metadata['dist-tags']?.[selectedChannel];
-  if (typeof version !== 'string') throw new Error(`Theme channel ${selectedChannel} has no resolved version`);
-  if (version === installed) return { changed: false, channel: selectedChannel, version, repaired: [], action };
-  if (typeof confirm !== 'function' || !await confirm({ name: NAME, installed, channel: selectedChannel, version })) {
-    return { changed: false, cancelled: true, channel: selectedChannel, version, repaired: [], action };
-  }
-  const downloaded = await fetchVerifiedThemePackage({ name: NAME, version, fetchImpl });
-  try {
-    if (!downloaded.manifest.themePackage.availableDesignThemes?.includes(config?.design?.theme)) {
-      throw new Error(`Visual theme ${String(config?.design?.theme)} is unavailable in ${NAME}@${version}`);
-    }
-    config.framework.themePackage = { name: NAME, version };
-    const repaired = await repairFramework(root, downloaded.staging, {
-      siteConfiguration: stringify(config)
-    });
-    return { changed: true, channel: selectedChannel, version, repaired, action };
-  } finally {
-    await rm(downloaded.cleanupRoot, { recursive: true, force: true });
-  }
-}

package/src/validate-command.js

@@ -1,5 +0,0 @@
-export {
-  BUILD_MANIFEST_PATH,
-  regenerateBuildManifest,
-  validateContent
-} from '@rathnasgala/content-validation';

package/src/workflow-command.js

@@ -1,87 +0,0 @@
-import { createHash } from 'node:crypto';
-import { lstat, mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';
-import path from 'node:path';
-
-const ACTION_REF = /^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+\/.github\/workflows\/[A-Za-z0-9_.-]+\.ya?ml@v(?:[1-9][0-9]*|[0-9]+\.[0-9]+\.[0-9]+)$/;
-const BRANCH = /^(?![./])(?!.*\.\.)(?!.*[~^:?*\[\\])[A-Za-z0-9._/-]+(?<![/.])$/;
-
-export function deriveNightlySchedule(siteId) {
-  if (typeof siteId !== 'string' || siteId.trim() === '') throw new TypeError('siteId is required');
-  const digest = createHash('sha256').update(siteId, 'utf8').digest();
-  return { minute: digest.readUInt16BE(0) % 60, hour: digest.readUInt16BE(2) % 24 };
-}
-
-function validateTimezone(timezone) {
-  try {
-    new Intl.DateTimeFormat('en-US', { timeZone: timezone }).format(0);
-  } catch {
-    throw new TypeError(`Invalid IANA timezone: ${timezone}`);
-  }
-}
-
-export async function writePublishWorkflow({
-  root,
-  siteId,
-  timezone,
-  actionRef = 'rathnasgala/publish/.github/workflows/publish.yml@v1',
-  defaultBranch = 'main',
-  buildMode = 'build-and-deploy'
-}) {
-  validateTimezone(timezone);
-  if (!ACTION_REF.test(actionRef)) {
-    throw new TypeError('actionRef must pin a reusable workflow to a major or immutable semver tag');
-  }
-  if (!BRANCH.test(defaultBranch)) throw new TypeError('Invalid default branch');
-  if (!['build-only', 'build-and-deploy'].includes(buildMode)) throw new TypeError('Invalid build mode');
-
-  const resolvedRoot = path.resolve(root);
-  const templatePath = path.join(resolvedRoot, '.gala', 'publish.yml.template');
-  const target = path.join(resolvedRoot, '.github', 'workflows', 'publish.yml');
-  const templateMetadata = await lstat(templatePath);
-  if (!templateMetadata.isFile() || templateMetadata.isSymbolicLink()) {
-    throw new TypeError('Workflow template must be a regular file');
-  }
-  try {
-    const targetMetadata = await lstat(target);
-    if (targetMetadata.isSymbolicLink() || !targetMetadata.isFile()) {
-      throw new TypeError('Workflow target must be a regular file');
-    }
-  } catch (error) {
-    if (error.code !== 'ENOENT') throw error;
-  }
-
-  const { minute, hour } = deriveNightlySchedule(siteId);
-  const workflow = (await readFile(templatePath, 'utf8'))
-    .replaceAll('__DEFAULT_BRANCH__', defaultBranch)
-    .replaceAll('__CRON__', `${minute} ${hour} * * *`)
-    .replaceAll('__TIMEZONE__', timezone)
-    .replaceAll('__SITE_ID__', siteId)
-    .replaceAll('__ACTION_REF__', actionRef)
-    .replaceAll('__BUILD_MODE__', buildMode);
-  if (/__[A-Z_]+__/.test(workflow)) throw new TypeError('Workflow template contains unresolved placeholders');
-
-  await mkdir(path.dirname(target), { recursive: true });
-  const temporary = `${target}.gala-workflow-${process.pid}`;
-  const backup = `${target}.gala-backup-${process.pid}`;
-  let backedUp = false;
-  try {
-    await writeFile(temporary, workflow, { flag: 'wx' });
-    try {
-      await rename(target, backup);
-      backedUp = true;
-    } catch (error) {
-      if (error.code !== 'ENOENT') throw error;
-    }
-    try {
-      await rename(temporary, target);
-    } catch (error) {
-      if (backedUp) await rename(backup, target);
-      throw error;
-    }
-    if (backedUp) await rm(backup);
-  } catch (error) {
-    await rm(temporary, { force: true });
-    throw error;
-  }
-  return { target, minute, hour };
-}