@bitmagic/cli 0.1.46-dev.3 → 0.1.46-dev.5

package/dist/update/notice.d.ts

@@ -1,3 +1,4 @@
+import type { EnvironmentName } from '../config/environments.js';
 /** Which published line a build came from: a prerelease was installed from `@bitmagic/cli@dev`. */
 export type UpdateTag = 'latest' | 'dev';
 /**
@@ -11,6 +12,32 @@ export type UpdateTag = 'latest' | 'dev';
 export declare function updateTagFor(version: string): UpdateTag;
 /** How to install the line a build is already on, so a nudge never moves someone between lines. */
 export declare function installCommandFor(tag: UpdateTag): string;
+/**
+ * What to call a line in a sentence.
+ *
+ * The dev line says "prerelease" out loud because the only place this is used asks someone to
+ * install it, and portal/src/cli-install.ts is right that putting an untested build on the machine
+ * of someone who never opted into testing is the worse failure. Being asked to cross lines is
+ * legitimate — the project's environment is what wants it — but nobody should cross without knowing
+ * which side they are landing on.
+ */
+export declare function describeUpdateTag(tag: UpdateTag): string;
+/**
+ * Which line a PROJECT's CLI should come from — the one answer to "dev or prod?" for anyone
+ * standing in a project directory, and the reason nobody should ever be asked.
+ *
+ * The project decides because the project is where the mismatch bites: new `/api/cli/v1` endpoints
+ * reach the dev api-server before production, so a prerelease run against `prod` calls endpoints
+ * that are not there yet, and a release run against `dev` is behind the engine that environment
+ * serves. `local` sits with `dev` — a localhost api-server is built from the same `main` a
+ * prerelease is cut from, so it is ahead of the release by construction.
+ *
+ * Note this is NOT `updateTagFor` applied to something else: that reads a version string and
+ * answers "which line is this build ON", which is a fact about the install. This answers "which
+ * line SHOULD it be on here", which is a fact about the project. The two disagreeing is exactly
+ * what `cliLineMismatchNotice` reports.
+ */
+export declare function updateTagForEnvironment(environment: EnvironmentName): UpdateTag;
 /**
  * How stale a cached npm answer may be before it is refreshed.
  *
@@ -18,7 +45,18 @@ export declare function installCommandFor(tag: UpdateTag): string;
  * refreshed in the background for next time. So this is only "how far behind the notice can be",
  * not "how long a command waits".
  */
-export declare const UPDATE_CHECK_INTERVAL_MS: number;
+export declare const RELEASE_UPDATE_CHECK_INTERVAL_MS: number;
+/**
+ * The same allowance for the dev line, which is shorter because the line moves faster.
+ *
+ * The dev line is cut from every merge to `main` and can move several times an hour, so an answer
+ * that old is often about a build two or three versions back — precisely the version someone
+ * testing dev needs to be told about soonest. Fifteen minutes keeps the nudge close to the line
+ * while still collapsing a burst of commands into a single background registry read.
+ */
+export declare const DEV_UPDATE_CHECK_INTERVAL_MS: number;
+/** How long an answer about `tag` stays good. */
+export declare function updateCheckIntervalFor(tag: UpdateTag): number;
 /** What is remembered between runs, so no command pays for the network. */
 export interface UpdateCheckCache {
     /** The newest version npm reported for `tag`, or null if the last check could not reach it. */
@@ -34,6 +72,13 @@ export interface UpdateCheckCache {
     /** Epoch ms of that check. */
     checkedAt: number;
 }
+/**
+ * The interval comes from the cache's OWN tag, not from the running build's.
+ *
+ * They agree wherever this decides anything: `refreshUpdateCacheInBackground` refreshes a
+ * cross-line cache unconditionally, so by the time staleness is asked about, the cache is about the
+ * line the build is on.
+ */
 export declare function isCacheStale(cache: UpdateCheckCache | null, now: number): boolean;
 /**
  * The line to print, or null to stay quiet.
@@ -46,3 +91,16 @@ export declare function isCacheStale(cache: UpdateCheckCache | null, now: number
  * 0.1.46-dev.3 to "update" to the older 0.1.45 release.
  */
 export declare function cliUpdateNotice(currentVersion: string, latestVersion: string | null | undefined): string | null;
+/**
+ * The line to say when the CLI running inside a project came from the other one.
+ *
+ * This is the one place the two lines are deliberately crossed, and it needs no version comparison
+ * to do it: whatever the numbers say, a project pinned to `dev` wants the dev line and a project
+ * pinned to `prod` wants the release. Version-driven nudges structurally cannot report this — a
+ * prerelease sitting in a `prod` project is *ahead* of the release tag, so `cliUpdateNotice` is
+ * correctly silent about a CLI that is on the wrong line entirely.
+ *
+ * `projectEnvironment` must be a project's committed pin, never a resolved environment: a one-off
+ * `--env` is a statement about this command, not about which CLI belongs in this directory.
+ */
+export declare function cliLineMismatchNotice(currentVersion: string, projectEnvironment: EnvironmentName): string | null;

package/dist/update/notice.js

@@ -14,6 +14,36 @@ export function updateTagFor(version) {
 export function installCommandFor(tag) {
     return tag === 'dev' ? 'npm i -g @bitmagic/cli@dev' : 'npm i -g @bitmagic/cli';
 }
+/**
+ * What to call a line in a sentence.
+ *
+ * The dev line says "prerelease" out loud because the only place this is used asks someone to
+ * install it, and portal/src/cli-install.ts is right that putting an untested build on the machine
+ * of someone who never opted into testing is the worse failure. Being asked to cross lines is
+ * legitimate — the project's environment is what wants it — but nobody should cross without knowing
+ * which side they are landing on.
+ */
+export function describeUpdateTag(tag) {
+    return tag === 'dev' ? 'dev (prerelease)' : 'release';
+}
+/**
+ * Which line a PROJECT's CLI should come from — the one answer to "dev or prod?" for anyone
+ * standing in a project directory, and the reason nobody should ever be asked.
+ *
+ * The project decides because the project is where the mismatch bites: new `/api/cli/v1` endpoints
+ * reach the dev api-server before production, so a prerelease run against `prod` calls endpoints
+ * that are not there yet, and a release run against `dev` is behind the engine that environment
+ * serves. `local` sits with `dev` — a localhost api-server is built from the same `main` a
+ * prerelease is cut from, so it is ahead of the release by construction.
+ *
+ * Note this is NOT `updateTagFor` applied to something else: that reads a version string and
+ * answers "which line is this build ON", which is a fact about the install. This answers "which
+ * line SHOULD it be on here", which is a fact about the project. The two disagreeing is exactly
+ * what `cliLineMismatchNotice` reports.
+ */
+export function updateTagForEnvironment(environment) {
+    return environment === 'prod' ? 'latest' : 'dev';
+}
 /**
  * How stale a cached npm answer may be before it is refreshed.
  *
@@ -21,7 +51,27 @@ export function installCommandFor(tag) {
  * refreshed in the background for next time. So this is only "how far behind the notice can be",
  * not "how long a command waits".
  */
-export const UPDATE_CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
+export const RELEASE_UPDATE_CHECK_INTERVAL_MS = 60 * 60 * 1000;
+/**
+ * The same allowance for the dev line, which is shorter because the line moves faster.
+ *
+ * The dev line is cut from every merge to `main` and can move several times an hour, so an answer
+ * that old is often about a build two or three versions back — precisely the version someone
+ * testing dev needs to be told about soonest. Fifteen minutes keeps the nudge close to the line
+ * while still collapsing a burst of commands into a single background registry read.
+ */
+export const DEV_UPDATE_CHECK_INTERVAL_MS = 15 * 60 * 1000;
+/** How long an answer about `tag` stays good. */
+export function updateCheckIntervalFor(tag) {
+    return tag === 'dev' ? DEV_UPDATE_CHECK_INTERVAL_MS : RELEASE_UPDATE_CHECK_INTERVAL_MS;
+}
+/**
+ * The interval comes from the cache's OWN tag, not from the running build's.
+ *
+ * They agree wherever this decides anything: `refreshUpdateCacheInBackground` refreshes a
+ * cross-line cache unconditionally, so by the time staleness is asked about, the cache is about the
+ * line the build is on.
+ */
 export function isCacheStale(cache, now) {
     if (cache === null)
         return true;
@@ -29,7 +79,7 @@ export function isCacheStale(cache, now) {
     // as fresh forever.
     if (cache.checkedAt > now)
         return true;
-    return now - cache.checkedAt >= UPDATE_CHECK_INTERVAL_MS;
+    return now - cache.checkedAt >= updateCheckIntervalFor(cache.tag);
 }
 /**
  * The line to print, or null to stay quiet.
@@ -52,4 +102,27 @@ export function cliUpdateNotice(currentVersion, latestVersion) {
     const install = installCommandFor(updateTagFor(currentVersion));
     return `A newer bitmagic CLI is available: ${latestVersion} (you have ${currentVersion}). Run \`${install}\` to update.`;
 }
+/**
+ * The line to say when the CLI running inside a project came from the other one.
+ *
+ * This is the one place the two lines are deliberately crossed, and it needs no version comparison
+ * to do it: whatever the numbers say, a project pinned to `dev` wants the dev line and a project
+ * pinned to `prod` wants the release. Version-driven nudges structurally cannot report this — a
+ * prerelease sitting in a `prod` project is *ahead* of the release tag, so `cliUpdateNotice` is
+ * correctly silent about a CLI that is on the wrong line entirely.
+ *
+ * `projectEnvironment` must be a project's committed pin, never a resolved environment: a one-off
+ * `--env` is a statement about this command, not about which CLI belongs in this directory.
+ */
+export function cliLineMismatchNotice(currentVersion, projectEnvironment) {
+    if (typeof currentVersion !== 'string' || currentVersion === '')
+        return null;
+    const wanted = updateTagForEnvironment(projectEnvironment);
+    const installed = updateTagFor(currentVersion);
+    if (installed === wanted)
+        return null;
+    return (`This project is on the ${projectEnvironment} environment, so its CLI comes from the ` +
+        `${describeUpdateTag(wanted)} line — but you are running a ${describeUpdateTag(installed)} ` +
+        `build (${currentVersion}). Run \`${installCommandFor(wanted)}\`.`);
+}
 //# sourceMappingURL=notice.js.map

package/dist/update/notice.js.map

@@ -1 +1 @@
-{"version":3,"file":"notice.js","sourceRoot":"","sources":["../../src/update/notice.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAKrE;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,OAAO,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;AAClD,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,iBAAiB,CAAC,GAAc;IAC9C,OAAO,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,wBAAwB,CAAC;AACjF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAkB5D,MAAM,UAAU,YAAY,CAAC,KAA8B,EAAE,GAAW;IACtE,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,+FAA+F;IAC/F,oBAAoB;IACpB,IAAI,KAAK,CAAC,SAAS,GAAG,GAAG;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,GAAG,GAAG,KAAK,CAAC,SAAS,IAAI,wBAAwB,CAAC;AAC3D,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,cAAsB,EAAE,aAAwC;IAC9F,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,aAAa,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAC3E,IAAI,OAAO,cAAc,KAAK,QAAQ,IAAI,cAAc,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAC7E,IAAI,oBAAoB,CAAC,cAAc,EAAE,aAAa,CAAC,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC9E,8FAA8F;IAC9F,MAAM,OAAO,GAAG,iBAAiB,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC;IAChE,OAAO,sCAAsC,aAAa,cAAc,cAAc,YAAY,OAAO,eAAe,CAAC;AAC3H,CAAC"}
+{"version":3,"file":"notice.js","sourceRoot":"","sources":["../../src/update/notice.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitmagic/cli",
-  "version": "0.1.46-dev.3",
+  "version": "0.1.46-dev.5",
   "description": "Build Bitmagic games from your own agent tool",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "Bitmagic Oy",
@@ -23,9 +23,9 @@
     "fflate": "^0.8.2",
     "playwright-core": "^1.59.1",
     "tar": "^7.4.3",
-    "@bitmagic/asset-core": "0.2.1-dev.1",
-    "@bitmagic/world-forger": "0.1.6-dev.1",
-    "@bitmagic/animation-forger": "0.1.1-dev.1"
+    "@bitmagic/asset-core": "0.2.1-dev.3",
+    "@bitmagic/world-forger": "0.1.6-dev.3",
+    "@bitmagic/animation-forger": "0.1.1-dev.3"
   },
   "devDependencies": {
     "@eslint/js": "^9.38.0",