create-ovok 0.1.0-dev.22 → 0.1.0-dev.33

package/README.md

@@ -24,6 +24,9 @@ Flags answer their questions, and `--yes` takes the recommended setup for the re
 Outside a terminal, such as in CI, nothing is asked: unanswered questions take the recommended
 setup.
 
+In a terminal it also asks npm for the latest create-ovok and, when there is a newer one, ends
+with the version to run next time.
+
 Inside the workspace:
 
 ```bash

package/dist/adapters/npm-registry.js

@@ -0,0 +1,15 @@
+const REGISTRY = "https://registry.npmjs.org";
+/** The version npm serves under `distTag`, or null when the registry does not answer in time. */
+export async function distTagVersion(packageName, distTag, signal) {
+    const url = `${REGISTRY}/-/package/${encodeURIComponent(packageName)}/dist-tags`;
+    try {
+        const response = await fetch(url, { signal });
+        if (!response.ok)
+            return null;
+        const version = (await response.json())[distTag];
+        return typeof version === "string" ? version : null;
+    }
+    catch {
+        return null;
+    }
+}

package/dist/domain/version.js

@@ -0,0 +1,28 @@
+const NUMERIC_ORDER = new Intl.Collator("en", { numeric: true });
+const DIST_TAG_BY_CHANNEL = { dev: "dev", rc: "next" };
+const STABLE_DIST_TAG = "latest";
+/** Semver order: numbers compare as numbers, and a release outranks its own prereleases. */
+export function isNewer(candidate, current) {
+    const [candidateCore, candidatePrerelease] = splitPrerelease(candidate);
+    const [currentCore, currentPrerelease] = splitPrerelease(current);
+    const coreOrder = NUMERIC_ORDER.compare(candidateCore, currentCore);
+    if (coreOrder !== 0)
+        return coreOrder > 0;
+    if (candidatePrerelease === "" || currentPrerelease === "") {
+        return candidatePrerelease === "" && currentPrerelease !== "";
+    }
+    return NUMERIC_ORDER.compare(candidatePrerelease, currentPrerelease) > 0;
+}
+/** The npm dist-tag that builds like this one are published under. */
+export function distTagOf(version) {
+    const [, prerelease] = splitPrerelease(version);
+    const [channel = ""] = prerelease.split(".");
+    return DIST_TAG_BY_CHANNEL[channel] ?? STABLE_DIST_TAG;
+}
+function splitPrerelease(version) {
+    const [withoutBuild = ""] = version.split("+");
+    const dash = withoutBuild.indexOf("-");
+    return dash === -1
+        ? [withoutBuild, ""]
+        : [withoutBuild.slice(0, dash), withoutBuild.slice(dash + 1)];
+}

package/dist/main.js

@@ -1,17 +1,20 @@
 #!/usr/bin/env node
 import { readFile } from "node:fs/promises";
-import { parseArgs } from "node:util";
+import { parseArgs, styleText } from "node:util";
 import { cancel } from "@clack/prompts";
 import { ClackPrompt } from "./adapters/clack-prompt.js";
 import { FsProjectFiles } from "./adapters/fs-project-files.js";
+import { distTagVersion } from "./adapters/npm-registry.js";
 import { dependenciesAt } from "./adapters/scaffold-dependencies.js";
 import { addApp, addPackage } from "./application/add-app.js";
 import { refreshAgentRules } from "./application/refresh-agent-rules.js";
 import { CancelledError, DEFAULT_ANSWERS, RECOMMENDED, } from "./application/workspace-answers.js";
 import { initialiseGit, install, scaffold, showNextSteps } from "./commands/create.js";
 import { MOBILE_OSES, osFor, PLATFORMS, parseChoice, parsePackageName, STARTING_PLATFORMS, } from "./domain/app-spec.js";
+import { distTagOf, isNewer } from "./domain/version.js";
 const EXIT_FAILURE = 1;
 const EXIT_CANCELLED = 130;
+const UPDATE_CHECK_TIMEOUT_MS = 1_500;
 const OPTIONS = {
     platform: { type: "string" },
     type: { type: "string" },
@@ -69,7 +72,7 @@ async function main(argv) {
     if (values.help)
         return console.log(USAGE);
     if (values.version)
-        return console.log(await ownVersion());
+        return console.log((await ownManifest()).version);
     const [first, ...rest] = positionals;
     const subcommand = first === undefined ? undefined : SUBCOMMANDS[first];
     if (subcommand === undefined)
@@ -77,14 +80,31 @@ async function main(argv) {
     return subcommand(rest, values);
 }
 async function create(name, values) {
-    const workspace = await scaffold(setupFlagsOf(name, values), promptFor(values), await ownVersion());
+    const manifest = await ownManifest();
+    const pendingNotice = updateNotice(manifest);
+    const workspace = await scaffold(setupFlagsOf(name, values), promptFor(values), manifest.version);
     const installation = values["skip-install"] ? "skipped" : await install(workspace);
     if (!values["disable-git"])
         await initialiseGit(workspace);
     showNextSteps(workspace, installation);
+    const notice = await pendingNotice;
+    if (notice !== null)
+        console.error(notice);
     if (installation === "failed")
         process.exitCode = EXIT_FAILURE;
 }
+/** Asks npm while the workspace is made, and only when someone is at a terminal to read the answer. */
+async function updateNotice({ name, version }) {
+    if (!process.stderr.isTTY)
+        return null;
+    const signal = AbortSignal.timeout(UPDATE_CHECK_TIMEOUT_MS);
+    const newest = await distTagVersion(name, distTagOf(version), signal);
+    return newest !== null && isNewer(newest, version) ? updateMessage(version, newest) : null;
+}
+function updateMessage(current, newest) {
+    const update = styleText("cyan", `pnpm create ovok@${newest}`);
+    return `${styleText("yellow", "Update available:")} ${current} → ${newest}. Next time run ${update}`;
+}
 function promptFor(values) {
     const interactive = process.stdin.isTTY && process.stdout.isTTY && !values.yes;
     return interactive ? new ClackPrompt() : DEFAULT_ANSWERS;
@@ -103,9 +123,9 @@ function setupFlagsOf(name, values) {
 function typeOf(values) {
     return values.type === undefined ? null : parseChoice(values.type, MOBILE_OSES, "--type");
 }
-async function ownVersion() {
+async function ownManifest() {
     const manifest = await readFile(new URL("../package.json", import.meta.url), "utf8");
-    return JSON.parse(manifest).version;
+    return JSON.parse(manifest);
 }
 try {
     await main(process.argv.slice(2));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-ovok",
-  "version": "0.1.0-dev.22",
+  "version": "0.1.0-dev.33+5f9fdd8",
   "description": "Create a Turborepo with Ovok web and mobile apps, and add more apps through turbo gen.",
   "license": "MIT",
   "type": "module",