@trayai/tray-sync-cli 1.0.14 → 1.0.16

package/dist/api/resources/project.js

@@ -1,6 +1,42 @@
 export async function rollbackProject(client, projectId, versionNumber) {
     await client.request("POST", `/v1/projects/${projectId}/rollbacks/versions/${versionNumber}`);
 }
+export async function getLatestProjectVersion(client, targetProjectId) {
+    const result = (await client.request("GET", `/v1/projects/${targetProjectId}/versions?last=1`));
+    const latest = result.elements?.[0];
+    if (!latest)
+        return null;
+    const [major, minor] = latest.versionNumber.split(".").map(Number);
+    return { major, minor };
+}
+export function computeNextVersionNumber(current, mode) {
+    if (!current)
+        return "1.0";
+    if (mode === "major")
+        return `${current.major + 1}.0`;
+    return `${current.major}.${current.minor + 1}`;
+}
+export async function createProjectVersion(client, targetProjectId, versionNumber, title, description) {
+    const result = (await client.request("POST", `/v1/projects/${targetProjectId}/versions/${versionNumber}`, { title, description }));
+    return {
+        versionNumber: result.versionNumber,
+        title: result.title,
+        description: result.description,
+        created: result.created,
+    };
+}
+export async function updateProjectVersion(client, projectId, versionNumber, fields) {
+    const result = (await client.request("PUT", `/v1/projects/${projectId}/versions/${versionNumber}`, fields));
+    return {
+        versionNumber: result.versionNumber,
+        title: result.title,
+        description: result.description,
+        created: result.created,
+    };
+}
+export async function deleteProjectVersion(client, projectId, versionNumber) {
+    await client.request("DELETE", `/v1/projects/${projectId}/versions/${versionNumber}`);
+}
 export async function listProjectVersions(client, projectId, options = {}) {
     const params = new URLSearchParams();
     if (options.last !== undefined)

package/dist/cli.js

@@ -12,6 +12,8 @@ import { authCommand } from "./commands/auth.js";
 import { promoteCommand } from "./commands/promote.js";
 import { apiCommand } from "./commands/api/api.js";
 import { isApiEnabled } from "./lib/apiAuth.js";
+import { checkVersion, VersionDeprecatedError } from "./lib/versionCheck.js";
+import { formatDeprecationRefusal, formatOutdatedNag } from "./views/versionCheck.v2.js";
 import { BANNER } from "./views/banner.js";
 import { TrayHelp } from "./views/help.js";
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
@@ -41,6 +43,20 @@ if (isApiEnabled()) {
     apiCommand.helpGroup("General-purpose API (growing)");
     program.addCommand(apiCommand);
 }
+program.hook("preAction", async () => {
+    try {
+        await checkVersion(pkg.version, {
+            onOutdated: (latest, installed) => console.error(formatOutdatedNag(latest, installed)),
+        });
+    }
+    catch (err) {
+        if (err instanceof VersionDeprecatedError) {
+            console.error(formatDeprecationRefusal(err.message));
+            process.exit(1);
+        }
+        throw err;
+    }
+});
 program.parseAsync(process.argv).catch((err) => {
     const message = err instanceof Error ? err.message : String(err);
     console.error(message);

package/dist/commands/api/project.js

@@ -1,11 +1,14 @@
+import ansis from "ansis";
 import { Command, InvalidArgumentError } from "commander";
-import { listProjectVersions, rollbackProject } from "../../api/resources/project.js";
+import { computeNextVersionNumber, createProjectVersion, deleteProjectVersion, getLatestProjectVersion, listProjectVersions, rollbackProject, updateProjectVersion, } from "../../api/resources/project.js";
 import { isUuid } from "../../lib/uuid.js";
 import { parseVersionNumber } from "../../lib/versionNumber.js";
 import { OutputFormats } from "../../lib/outputFormat.js";
-import { printProjectRollbackResult, printProjectVersionListTable } from "../../views/api/project.v2.js";
+import { printProjectRollbackResult, printProjectVersionDeletedResult, printProjectVersionListTable, printProjectVersionResult, } from "../../views/api/project.v2.js";
 import { printConfirmationJson } from "../../views/api/shared.js";
+import { FAILURE_ICON } from "../../views/icons.js";
 import { addCommonApiOptions, apiClientFor, realDeps, runApiAction, } from "./shared.js";
+const DEFAULT_VERSION_CREATE_TITLE = "Created via tray-sync-cli";
 const DEFAULT_VERSION_LIST_LIMIT = 5;
 function parseLimit(value) {
     const limit = Number(value);
@@ -48,6 +51,63 @@ export async function runProjectVersionList(deps, options) {
     }
     return 0;
 }
+function printMutuallyExclusiveMajorAndVersion(stderr) {
+    stderr(`${FAILURE_ICON} ${ansis.bold("--major")} and ${ansis.bold("--version-number")} are mutually exclusive.`);
+}
+export async function runProjectVersionCreate(deps, options) {
+    if (options.major && options.versionNumber) {
+        printMutuallyExclusiveMajorAndVersion(deps.stderr);
+        return 1;
+    }
+    const client = await apiClientFor(deps, options);
+    const mode = options.major ? "major" : "minor";
+    const versionNumber = options.versionNumber ?? computeNextVersionNumber(await getLatestProjectVersion(client, options.projectId), mode);
+    const title = options.title ?? DEFAULT_VERSION_CREATE_TITLE;
+    const description = options.description ?? "";
+    const created = await createProjectVersion(client, options.projectId, versionNumber, title, description);
+    if (options.format === OutputFormats.JSON) {
+        printConfirmationJson(deps.stdout, { projectId: options.projectId, ...created });
+    }
+    else {
+        printProjectVersionResult(deps.stdout, options.projectId, created, "created");
+    }
+    return 0;
+}
+export async function runProjectVersionEdit(deps, options) {
+    if (options.title === undefined && options.description === undefined) {
+        deps.stderr(`${FAILURE_ICON} Nothing to edit — pass --title and/or --description.`);
+        return 1;
+    }
+    const client = await apiClientFor(deps, options);
+    const fields = {};
+    if (options.title !== undefined)
+        fields.title = options.title;
+    if (options.description !== undefined)
+        fields.description = options.description;
+    const updated = await updateProjectVersion(client, options.projectId, options.versionNumber, fields);
+    if (options.format === OutputFormats.JSON) {
+        printConfirmationJson(deps.stdout, { projectId: options.projectId, ...updated });
+    }
+    else {
+        printProjectVersionResult(deps.stdout, options.projectId, updated, "updated");
+    }
+    return 0;
+}
+export async function runProjectVersionDelete(deps, options) {
+    const client = await apiClientFor(deps, options);
+    await deleteProjectVersion(client, options.projectId, options.versionNumber);
+    if (options.format === OutputFormats.JSON) {
+        printConfirmationJson(deps.stdout, {
+            projectId: options.projectId,
+            versionNumber: options.versionNumber,
+            deleted: true,
+        });
+    }
+    else {
+        printProjectVersionDeletedResult(deps.stdout, options.projectId, options.versionNumber);
+    }
+    return 0;
+}
 export const projectCommand = new Command("project").description("Manage projects");
 const versionCommand = new Command("version").description("Manage project versions");
 projectCommand.addCommand(versionCommand);
@@ -79,4 +139,56 @@ addCommonApiOptions(versionCommand
         format: opts.format,
     }));
 });
+addCommonApiOptions(versionCommand
+    .command("create")
+    .description("Create a new version for a project")
+    .argument("<project-id>", "Tray project UUID", parseProjectId)
+    .option("--major", "bump the major version instead of minor")
+    .option("--version-number <major.minor>", "explicit target version number (overrides --major)", parseVersionNumber)
+    .option("--title <title>", `title for the created version (default "${DEFAULT_VERSION_CREATE_TITLE}")`)
+    .option("--description <description>", "description for the created version")).action(async (projectId, opts) => {
+    const deps = realDeps();
+    await runApiAction(deps, () => runProjectVersionCreate(deps, {
+        projectId,
+        major: opts.major,
+        versionNumber: opts.versionNumber,
+        title: opts.title,
+        description: opts.description,
+        region: opts.region,
+        token: opts.token,
+        format: opts.format,
+    }));
+});
+addCommonApiOptions(versionCommand
+    .command("edit")
+    .description("Edit a version's title and/or description")
+    .argument("<project-id>", "Tray project UUID", parseProjectId)
+    .requiredOption("--version-number <major.minor>", "target version number", parseVersionNumber)
+    .option("--title <title>", "new title")
+    .option("--description <description>", "new description")).action(async (projectId, opts) => {
+    const deps = realDeps();
+    await runApiAction(deps, () => runProjectVersionEdit(deps, {
+        projectId,
+        versionNumber: opts.versionNumber,
+        title: opts.title,
+        description: opts.description,
+        region: opts.region,
+        token: opts.token,
+        format: opts.format,
+    }));
+});
+addCommonApiOptions(versionCommand
+    .command("delete")
+    .description("Delete a version")
+    .argument("<project-id>", "Tray project UUID", parseProjectId)
+    .requiredOption("--version-number <major.minor>", "target version number", parseVersionNumber)).action(async (projectId, opts) => {
+    const deps = realDeps();
+    await runApiAction(deps, () => runProjectVersionDelete(deps, {
+        projectId,
+        versionNumber: opts.versionNumber,
+        region: opts.region,
+        token: opts.token,
+        format: opts.format,
+    }));
+});
 //# sourceMappingURL=project.js.map

package/dist/commands/promote.js

@@ -13,7 +13,8 @@ import { resolveContainedSafe } from "../lib/pathContainment.js";
 import { entityDisplayName } from "../lib/exportStructure.js";
 import { importProject, previewImport } from "../lib/promoteExecute.js";
 import { summarizeImpactForVersionDescription, toProjectImportImpact, } from "../lib/promoteReport.js";
-import { computeNextVersionNumber, createProjectVersion, getLatestProjectVersion, isFullyResolved, resolveProjectRequirements, scaffoldUnresolvedAuthentications, } from "../lib/promoteTarget.js";
+import { isFullyResolved, resolveProjectRequirements, scaffoldUnresolvedAuthentications, } from "../lib/promoteTarget.js";
+import { computeNextVersionNumber, createProjectVersion, getLatestProjectVersion, } from "../api/resources/project.js";
 import { resolveToken } from "../lib/tokenResolution.js";
 import { isUuid } from "../lib/uuid.js";
 import { OutputFormats, parseFormat } from "../lib/outputFormat.js";

package/dist/lib/promoteTarget.js

@@ -96,30 +96,6 @@ export function validateAuthenticationMappings(mapping) {
         .filter(([, authenticationId]) => !isUuid(authenticationId))
         .map(([authExportId, value]) => ({ authExportId, value }));
 }
-export async function getLatestProjectVersion(client, targetProjectId) {
-    const result = (await client.request("GET", `/v1/projects/${targetProjectId}/versions?last=1`));
-    const latest = result.elements?.[0];
-    if (!latest)
-        return null;
-    const [major, minor] = latest.versionNumber.split(".").map(Number);
-    return { major, minor };
-}
-export function computeNextVersionNumber(current, mode) {
-    if (!current)
-        return "1.0";
-    if (mode === "major")
-        return `${current.major + 1}.0`;
-    return `${current.major}.${current.minor + 1}`;
-}
-export async function createProjectVersion(client, targetProjectId, versionNumber, title, description) {
-    const result = (await client.request("POST", `/v1/projects/${targetProjectId}/versions/${versionNumber}`, { title, description }));
-    return {
-        versionNumber: result.versionNumber,
-        title: result.title,
-        description: result.description,
-        created: result.created,
-    };
-}
 export async function resolveProjectRequirements(client, deps, options) {
     const targetResolution = await resolveTargetProjectId(client, {
         projectDirPath: options.projectDirPath,

package/dist/lib/versionCheck.js

@@ -0,0 +1,48 @@
+import { readJson, writeJson } from "../config/io.js";
+import { versionCheckPath } from "../config/paths.js";
+import { NetworkError } from "../api/errors.js";
+const REGISTRY_URL = "https://registry.npmjs.org/@trayai/tray-sync-cli";
+const TTL_MS = 24 * 60 * 60 * 1000;
+const FETCH_TIMEOUT_MS = 5_000;
+export async function checkVersion(installedVersion, deps = {}) {
+    const { env, now = () => new Date(), onOutdated } = deps;
+    const fetchImpl = deps.fetchImpl ?? fetch;
+    const cached = await readJson(versionCheckPath(env)).catch(() => undefined);
+    const isFresh = cached !== undefined && now().getTime() - Date.parse(cached.cached_at) < TTL_MS;
+    const response = isFresh
+        ? cached.response
+        : await fetchAndCache(installedVersion, fetchImpl, env, now).catch(() => undefined);
+    if (response === undefined)
+        return;
+    if (response.deprecated) {
+        throw new VersionDeprecatedError(response.deprecated);
+    }
+    if (installedVersion !== response.latest) {
+        onOutdated?.(response.latest, installedVersion);
+    }
+}
+async function fetchAndCache(installedVersion, fetchImpl, env, now) {
+    let raw;
+    try {
+        const res = await fetchImpl(REGISTRY_URL, { signal: AbortSignal.timeout(FETCH_TIMEOUT_MS) });
+        if (!res.ok)
+            throw new Error(`HTTP ${res.status}`);
+        raw = (await res.json());
+    }
+    catch (err) {
+        throw new NetworkError(`Could not reach the npm registry to check for a deprecated version: ${err.message}`);
+    }
+    const latest = raw["dist-tags"]?.latest;
+    if (!latest) {
+        throw new NetworkError("Unexpected response from the npm registry: missing dist-tags.latest");
+    }
+    const response = {
+        latest,
+        deprecated: raw.versions?.[installedVersion]?.deprecated ?? null,
+    };
+    await writeJson(versionCheckPath(env), { cached_at: now().toISOString(), response });
+    return response;
+}
+export class VersionDeprecatedError extends Error {
+}
+//# sourceMappingURL=versionCheck.js.map

package/dist/views/api/project.v2.js

@@ -21,4 +21,10 @@ export function printProjectVersionListTable(stdout, versions) {
     }
     stdout(table.toString());
 }
+export function printProjectVersionResult(stdout, projectId, version, verb) {
+    stdout(`${SUCCESS_ICON} Project ${ansis.bold(projectId)} version ${ansis.bold(version.versionNumber)} ${verb}: ${ansis.bold(version.title)}.`);
+}
+export function printProjectVersionDeletedResult(stdout, projectId, versionNumber) {
+    stdout(`${SUCCESS_ICON} Project ${ansis.bold(projectId)} version ${ansis.bold(versionNumber)} deleted.`);
+}
 //# sourceMappingURL=project.v2.js.map

package/dist/views/versionCheck.v2.js

@@ -0,0 +1,11 @@
+import ansis from "ansis";
+import { INFO_ICON, WARNING_ICON } from "./icons.js";
+export function formatOutdatedNag(latest, installed) {
+    return (`${INFO_ICON} A ${ansis.bold("newer")} version of tray-sync-cli is available ` +
+        `(${ansis.bold.green(latest)}, you have ${ansis.bold(installed)}).\n` +
+        `Upgrade: ${ansis.bold("npm install -g @trayai/tray-sync-cli")}`);
+}
+export function formatDeprecationRefusal(message) {
+    return `${WARNING_ICON} ${message}\n` + `Upgrade: ${ansis.bold("npm install -g @trayai/tray-sync-cli")}`;
+}
+//# sourceMappingURL=versionCheck.v2.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trayai/tray-sync-cli",
-  "version": "1.0.14",
+  "version": "1.0.16",
   "description": "CLI tool to clone Tray projects and related assets to a local directory, and promote them between Tray environments",
   "bin": {
     "tray": "dist/cli.js"