@fairgarden/distribution 0.1.0-alpha.0

package/Readme.md

@@ -0,0 +1,94 @@
+# FairGarden Distribution
+
+<!-- fg:version -->
+
+Version **0.1.0-alpha.0**
+
+<!-- /fg:version -->
+
+<!-- fg:releasing -->
+
+## Releasing
+
+This module releases on its own. `0.1.0-alpha.0` is what main is working towards,
+not what is published — the version here is always the next one.
+
+1. **Publish it.** Run the *Publish* workflow from the Actions tab, picking the
+   dist tag. It refuses if that version is already on npm.
+2. **Move it on.** `pnpm release` — opens a pull request bumping this branch
+   to `0.1.0-alpha.1`, or `pnpm release --id rc` to change
+   identifier. A prerelease gets no maintenance branch; there is no released
+   line behind it yet.
+
+Every push to main publishes `@fairgarden/distribution@canary`. A canary is not a release and
+carries no promise; it is there so main can be tried without a checkout.
+
+<!-- /fg:releasing -->
+
+Ship a set of versioned modules together.
+
+End users do not care about semver — they want to know how old their copy is,
+and `2024.12.01` says that at a glance where `1.2.1` does not. Developers do
+care, because semver says how much work an upgrade will be. A distribution uses
+each where it belongs: the distribution is versioned by date, the modules inside
+it by semver.
+
+```
+@fairgarden/core  2024.12.01
+  @fairgarden/id          1.2.3
+  @fairgarden/design      1.5.6
+  @fairgarden/membership  1.0.0
+```
+
+Modules are git submodules, so the commit is the pin and the version is whatever
+the module's own `package.json` says. Nothing in the distribution repository
+restates it.
+
+## Documentation
+
+The docs are a site in this repository. Run them with:
+
+```bash
+pnpm --filter @fairgarden/distribution-docs dev
+```
+
+- **Versioning** — why two schemes, where a version comes from, and LTS branches
+- **Modules** — apps, packages, and how they resolve
+- **Extending** — one distribution built on another
+- **Deploying** — one deployment, or many
+- **Running it** — dev modes, and a hostname per app
+- **Growing a module** — building in place, then extracting
+- **Releasing a module** — semver, maintenance branches and dist-tags
+- **Submodule urls** — what a build host can actually clone
+- **Commands** and **Functions** — the `fg-dist` CLI and its API
+
+## Install
+
+```bash
+pnpm add -D @fairgarden/distribution
+```
+
+Or scaffold without installing anything:
+
+```bash
+pnpx @fairgarden/distribution init distribution acme --name @acme/core
+```
+
+```bash
+fg-dist init <kind> [dir]    # scaffold a distribution, monolith or module
+fg-dist add-module <url>     # add a module repository as a submodule
+fg-dist extract <path>       # turn a directory here into its own repository
+fg-dist sync                 # what has moved, and whether the floor holds
+fg-dist bump [name...]       # take the newest non-major version
+fg-dist check                # fail when this ships older than what it extends
+fg-dist use-https            # rewrite ssh submodule urls, and check they are public
+fg-dist readme               # write the module versions into the readmes
+fg-dist overrides            # resolve modules from the tree, not the registry
+fg-dist workflows            # give every module a publishing workflow
+fg-dist canary               # stamp a canary version, for CI
+fg-dist release --minor      # open the next version on main, and a branch behind it
+fg-dist prerelease --major   # start the next line on a branch, leaving main alone
+```
+
+Mounting a distribution's apps into one Next deployment is a separate concern,
+handled by `@fairgarden/monolith`.

package/dist/add-module.d.ts

@@ -0,0 +1,58 @@
+/** `git@host:owner/name.git` or `https://host/owner/name(.git)` -> `name`. */
+export declare const nameFromUrl: (url: string) => string;
+export interface AddModuleOptions {
+    /** Where the submodule goes, relative to the repository. Defaults to `apps/<name>`. */
+    at?: string;
+    /** Mount name, which becomes the URL segment. Defaults to the repository name. */
+    mount?: string;
+    /** The monolith whose package.json gains the dependency. Found when omitted. */
+    monolith?: string;
+    /**
+     * Record the URL as given instead of rewriting it to HTTPS. Only do this
+     * when nothing but a developer's machine will ever clone the submodule.
+     */
+    ssh?: boolean;
+}
+/**
+ * The app that composes the modules, or undefined when there is none.
+ *
+ * A distribution too complex to serve from one deployment has no monolith at
+ * all; each app under `apps/` is deployed on its own.
+ */
+export declare const findMonolith: (root: string, from: string) => Promise<string | undefined>;
+export interface AddModuleResult {
+    /** Whether the workspace overrides were updated to include this module. */
+    overrides: boolean;
+    /** Why they were not, when the workspace could not be edited. */
+    overridesError: string | undefined;
+    mount: string;
+    relativePath: string;
+    packageName: string | undefined;
+    version: string | undefined;
+    /** Whether the monolith's package.json was changed. */
+    linked: boolean;
+    /** The monolith package.json that was, or should be, updated. */
+    monolithPackageJson: string | undefined;
+    /** The config the mount was written into. */
+    monolithConfig: string | undefined;
+    /** Whether the mount was added; false when it was already declared. */
+    mounted: boolean;
+    /** Why the config could not be edited, when it could not be. */
+    mountError: string | undefined;
+    /** The URL recorded in .gitmodules, which may differ from the one given. */
+    url: string;
+    /** Whether that URL was rewritten from SSH. */
+    rewritten: boolean;
+    /** Whether the module has routes, and so is mounted rather than depended on. */
+    isApp: boolean;
+}
+/**
+ * Add a module repository as a submodule and wire it into the monolith.
+ *
+ * The submodule is what pins the version, and the dependency is what makes the
+ * module resolvable by package name. The mount itself is declared in the
+ * monolith's Next config, which is left alone — rewriting someone's config is
+ * not something a command should do quietly.
+ */
+export declare const addModule: (cwd: string, url: string, options?: AddModuleOptions) => Promise<AddModuleResult>;
+//# sourceMappingURL=add-module.d.ts.map

package/dist/add-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-module.d.ts","sourceRoot":"","sources":["../src/add-module.ts"],"names":[],"mappings":"AAgCA,8EAA8E;AAC9E,eAAO,MAAM,WAAW,GAAI,KAAK,MAAM,KAAG,MAGzC,CAAA;AAED,MAAM,WAAW,gBAAgB;IAC/B,uFAAuF;IACvF,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,kFAAkF;IAClF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;OAGG;IACH,GAAG,CAAC,EAAE,OAAO,CAAA;CACd;AAgBD;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GACvB,MAAM,MAAM,EACZ,MAAM,MAAM,KACX,OAAO,CAAC,MAAM,GAAG,SAAS,CAiB5B,CAAA;AAED,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,SAAS,EAAE,OAAO,CAAA;IAClB,iEAAiE;IACjE,cAAc,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,uDAAuD;IACvD,MAAM,EAAE,OAAO,CAAA;IACf,iEAAiE;IACjE,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAA;IACvC,6CAA6C;IAC7C,cAAc,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,uEAAuE;IACvE,OAAO,EAAE,OAAO,CAAA;IAChB,gEAAgE;IAChE,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,4EAA4E;IAC5E,GAAG,EAAE,MAAM,CAAA;IACX,+CAA+C;IAC/C,SAAS,EAAE,OAAO,CAAA;IAClB,gFAAgF;IAChF,KAAK,EAAE,OAAO,CAAA;CACf;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GACpB,KAAK,MAAM,EACX,KAAK,MAAM,EACX,UAAS,gBAAqB,KAC7B,OAAO,CAAC,eAAe,CAwGzB,CAAA"}

package/dist/add-module.js

@@ -0,0 +1,250 @@
+import { execFileSync } from 'node:child_process';
+import { readFile, writeFile, readdir, stat, mkdir } from 'node:fs/promises';
+import path from 'node:path';
+import { writeOverrides } from "./overrides.js";
+import { repositoryRoot } from "./submodules.js";
+import { readPackageName } from "./scaffold.js";
+import { addMount, ConfigEditError, declaresMonolith } from "./config-edit.js";
+import { toHttps } from "./git-url.js";
+const CONFIG_FILES = [
+    'next.config.ts',
+    'next.config.mts',
+    'next.config.js',
+    'next.config.mjs',
+    'next.config.cjs',
+];
+const git = (cwd, args) => {
+    try {
+        return execFileSync('git', args, {
+            cwd,
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'pipe'],
+        }).trim();
+    }
+    catch (cause) {
+        const stderr = cause instanceof Error && 'stderr' in cause ? String(cause.stderr).trim() : '';
+        throw new Error(`git ${args[0]} failed${stderr ? `: ${stderr}` : ''}`, { cause });
+    }
+};
+/** `git@host:owner/name.git` or `https://host/owner/name(.git)` -> `name`. */
+export const nameFromUrl = (url) => {
+    const last = url.replace(/\.git$/, '').split(/[/:]/).pop() ?? '';
+    return last || 'module';
+};
+/**
+ * Whether a directory holds the app that composes modules.
+ *
+ * Identified by its Next config calling `withMonolith`. A module depends on
+ * this package as well, so the dependency alone would match every module.
+ */
+const composesModules = async (dir) => {
+    for (const file of CONFIG_FILES) {
+        const source = await readFile(path.join(dir, file), 'utf8').catch(() => undefined);
+        if (source !== undefined)
+            return declaresMonolith(source);
+    }
+    return false;
+};
+/**
+ * The app that composes the modules, or undefined when there is none.
+ *
+ * A distribution too complex to serve from one deployment has no monolith at
+ * all; each app under `apps/` is deployed on its own.
+ */
+export const findMonolith = async (root, from) => {
+    if (await composesModules(from))
+        return from;
+    const candidates = [path.join(root, 'apps', 'monolith')];
+    for (const parent of ['apps', 'packages']) {
+        const entries = await readdir(path.join(root, parent), {
+            withFileTypes: true,
+        }).catch(() => []);
+        for (const entry of entries) {
+            if (entry.isDirectory())
+                candidates.push(path.join(root, parent, entry.name));
+        }
+    }
+    for (const candidate of candidates) {
+        if (await composesModules(candidate))
+            return candidate;
+    }
+    return undefined;
+};
+/**
+ * Add a module repository as a submodule and wire it into the monolith.
+ *
+ * The submodule is what pins the version, and the dependency is what makes the
+ * module resolvable by package name. The mount itself is declared in the
+ * monolith's Next config, which is left alone — rewriting someone's config is
+ * not something a command should do quietly.
+ */
+export const addModule = async (cwd, url, options = {}) => {
+    const root = repositoryRoot(cwd);
+    if (!root)
+        throw new Error(`${cwd} is not inside a git repository.`);
+    const name = nameFromUrl(url);
+    // Where it lands is decided after cloning, since only the contents say
+    // whether this is an app to deploy or a package apps depend on.
+    const relativePath = options.at ?? path.join('apps', name);
+    const full = path.join(root, relativePath);
+    // .gitmodules is committed, so this URL is what every later clone uses.
+    const recorded = options.ssh ? url : toHttps(url);
+    const rewritten = recorded !== url;
+    git(root, ['submodule', 'add', recorded, relativePath]);
+    git(root, ['submodule', 'update', '--init', '--recursive', relativePath]);
+    let placedAt = relativePath;
+    let placedFull = full;
+    // A distribution is apps and the packages they share. An app has routes; a
+    // package does not, and belongs beside the others rather than under apps/.
+    const isApp = await hasRoutes(full);
+    if (!options.at && !isApp) {
+        const packagePath = path.join('packages', name);
+        try {
+            await mkdir(path.join(root, 'packages'), { recursive: true });
+            git(root, ['mv', relativePath, packagePath]);
+            placedAt = packagePath;
+            placedFull = path.join(root, packagePath);
+        }
+        catch {
+            // Leaving it under apps/ is wrong but harmless; say nothing and carry on.
+        }
+    }
+    const packageName = await readPackageName(placedFull);
+    const version = await readVersion(placedFull);
+    const monolithRoot = options.monolith
+        ? path.resolve(cwd, options.monolith)
+        : await findMonolith(root, cwd);
+    const monolithPackageJson = monolithRoot
+        ? path.join(monolithRoot, 'package.json')
+        : undefined;
+    // Linked through the workspace, so the version is irrelevant here — only
+    // the name is. Guarding on the version left a module with none mounted but
+    // never depended on.
+    let linked = false;
+    if (packageName && monolithPackageJson && monolithRoot !== root) {
+        linked = await addDependency(monolithPackageJson, packageName);
+    }
+    const mount = options.mount ?? name;
+    // Only an app is mounted at a path. A package is depended on, not served.
+    // A mount is written into the config as a bare string, which is read back as
+    // a package name. Without one there is nothing valid to write, so say so
+    // rather than record a path that will not resolve.
+    const { config, mounted, error } = monolithRoot && isApp
+        ? packageName
+            ? await declareMount(monolithRoot, mount, packageName)
+            : {
+                config: undefined,
+                mounted: false,
+                error: 'It has no package name, so there is nothing to mount it by. ' +
+                    'Give it one, or mount it by path yourself.',
+            }
+        : { config: undefined, mounted: false, error: undefined };
+    // The distribution resolves its own modules from the tree, not from their
+    // declared ranges — which stop matching as soon as a submodule is bumped
+    // past them.
+    // The repository, not where the command was run: adding a module from
+    // apps/monolith is a supported path, and `cwd` there is not the root.
+    //
+    // Last, and after everything that matters. The submodule is added and the
+    // mount is written by now, so a workspace this cannot edit — a sibling with
+    // no checkout, an `overrides:` key someone else wrote — is something to
+    // report, not something to fail the whole command over.
+    const overrides = await writeOverrides(repositoryRoot(cwd) ?? cwd).catch((error) => ({
+        changed: false,
+        error: error instanceof Error ? error.message : String(error),
+    }));
+    return {
+        overrides: overrides.changed,
+        overridesError: 'error' in overrides ? overrides.error : undefined,
+        mount,
+        relativePath: placedAt,
+        packageName,
+        version,
+        linked,
+        monolithPackageJson,
+        monolithConfig: config,
+        mounted,
+        mountError: error,
+        url: recorded,
+        rewritten,
+        isApp,
+    };
+};
+/**
+ * Write the mount into the monolith's Next config.
+ *
+ * Reports rather than throws when the config is shaped in a way it cannot
+ * edit — the submodule is already added by then, and failing the whole command
+ * over a line someone can paste would be worse than saying so.
+ */
+const declareMount = async (monolithRoot, mount, module) => {
+    for (const file of CONFIG_FILES) {
+        const full = path.join(monolithRoot, file);
+        let source;
+        try {
+            source = await readFile(full, 'utf8');
+        }
+        catch {
+            continue;
+        }
+        try {
+            const result = addMount(source, mount, module);
+            if (result.changed)
+                await writeFile(full, result.source);
+            return { config: full, mounted: result.changed, error: undefined };
+        }
+        catch (cause) {
+            return {
+                config: full,
+                mounted: false,
+                error: cause instanceof ConfigEditError
+                    ? cause.message
+                    : `The config could not be edited: ${String(cause)}`,
+            };
+        }
+    }
+    return { config: undefined, mounted: false, error: 'No Next config was found.' };
+};
+const isDirectory = async (candidate) => (await stat(candidate).catch(() => undefined))?.isDirectory() === true;
+/** Whether a checkout is an app, meaning it has routes Next would serve. */
+const hasRoutes = async (root) => {
+    for (const dir of ['app', 'pages', path.join('src', 'app'), path.join('src', 'pages')]) {
+        if (await isDirectory(path.join(root, dir)))
+            return true;
+    }
+    return false;
+};
+const readVersion = async (root) => {
+    try {
+        const pkg = JSON.parse(await readFile(path.join(root, 'package.json'), 'utf8'));
+        return typeof pkg.version === 'string' ? pkg.version : undefined;
+    }
+    catch {
+        return undefined;
+    }
+};
+/**
+ * Depend on the module through the workspace, not on a version.
+ *
+ * Nothing in a distribution repository pins a module version: the submodule
+ * commit is the pin, and the version is whatever the package.json inside that
+ * checkout says. `workspace:*` is how that is spelled, and it keeps the
+ * repository from carrying a second, stale copy of the same fact.
+ */
+const addDependency = async (packageJsonPath, name) => {
+    let pkg;
+    try {
+        pkg = JSON.parse(await readFile(packageJsonPath, 'utf8'));
+    }
+    catch {
+        return false;
+    }
+    const dependencies = { ...(pkg.dependencies ?? {}) };
+    if (dependencies[name] === 'workspace:*')
+        return false;
+    dependencies[name] = 'workspace:*';
+    pkg.dependencies = Object.fromEntries(Object.entries(dependencies).sort(([a], [b]) => a.localeCompare(b)));
+    await writeFile(packageJsonPath, `${JSON.stringify(pkg, null, 2)}\n`);
+    return true;
+};
+//# sourceMappingURL=add-module.js.map

package/dist/add-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-module.js","sourceRoot":"","sources":["../src/add-module.ts"],"names":[],"mappings":"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"}

package/dist/canary.d.ts

@@ -0,0 +1,58 @@
+/** What is on the `canary` tag now. */
+export interface Published {
+    version?: string;
+    gitSha?: string;
+}
+/**
+ * The next canary version.
+ *
+ * The suffix counts this canary's position within its own release cycle, read
+ * from the registry. A CI run counter would look similar and be wrong: it skips
+ * numbers whenever a run fails or deduplicates, which makes published versions
+ * a record of workflow bookkeeping rather than of releases.
+ */
+export declare const nextCanary: (version: string, published: string | undefined) => string;
+export interface CanaryResult {
+    name: string;
+    /**
+     * Whether npm will generate provenance for this package. It refuses to for
+     * anything not published publicly, and refusing is a failed publish.
+     */
+    provenance: boolean;
+    /** The version written into the manifest, or the one already published. */
+    version: string;
+    /** True when this commit is already on the canary tag, so there is nothing to do. */
+    skip: boolean;
+    sha: string;
+}
+export interface CanaryOptions {
+    /** The commit being built. Defaults to `GITHUB_SHA`. */
+    sha?: string;
+    /** What is on the canary tag. Defaults to asking npm. */
+    published?: Published;
+    /** Work out the version and report it, without touching the manifest. */
+    dryRun?: boolean;
+}
+/**
+ * Stamp a canary version into the manifest, ready to publish.
+ *
+ * Returns without writing when the canary tag already points at this commit,
+ * which is what makes a nightly build with nothing new a no-op rather than a
+ * version bump.
+ */
+export declare const stampCanary: (root: string, { sha, published, dryRun }?: CanaryOptions) => Promise<CanaryResult>;
+/** Hand a result to the workflow step that decides whether to publish. */
+export declare const reportToActions: (result: CanaryResult) => Promise<void>;
+/**
+ * Whether a manifest publishes publicly.
+ *
+ * npm generates provenance only for public packages, and asking for it on a
+ * restricted one fails the publish. A scoped package is restricted unless it
+ * says otherwise, which is why the default here is the pessimistic one.
+ */
+export declare const isPublic: (manifest: {
+    name?: unknown;
+    private?: unknown;
+    publishConfig?: unknown;
+}) => boolean;
+//# sourceMappingURL=canary.d.ts.map

package/dist/canary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canary.d.ts","sourceRoot":"","sources":["../src/canary.ts"],"names":[],"mappings":"AAoBA,uCAAuC;AACvC,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,GAAI,SAAS,MAAM,EAAE,WAAW,MAAM,GAAG,SAAS,KAAG,MA8B3E,CAAA;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ;;;OAGG;IACH,UAAU,EAAE,OAAO,CAAA;IACnB,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAA;IACf,qFAAqF;IACrF,IAAI,EAAE,OAAO,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,yDAAyD;IACzD,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,yEAAyE;IACzE,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GACtB,MAAM,MAAM,EACZ,6BAAmE,aAAkB,KACpF,OAAO,CAAC,YAAY,CAqCtB,CAAA;AAED,0EAA0E;AAC1E,eAAO,MAAM,eAAe,GAAU,QAAQ,YAAY,KAAG,OAAO,CAAC,IAAI,CAUxE,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,GAAI,UAAU;IACjC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB,KAAG,OASH,CAAA"}

package/dist/canary.js

@@ -0,0 +1,117 @@
+import { execFileSync } from 'node:child_process';
+import { appendFile, readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import semver from 'semver';
+/** Ask npm about a published version, returning undefined when it says nothing. */
+const view = (spec, field) => {
+    try {
+        const value = execFileSync('npm', ['view', spec, field], {
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+        return value === '' ? undefined : value;
+    }
+    catch {
+        // Not published yet, or no registry to ask. Either way there is no
+        // previous canary, which is the same thing as far as the next one goes.
+        return undefined;
+    }
+};
+/**
+ * The next canary version.
+ *
+ * The suffix counts this canary's position within its own release cycle, read
+ * from the registry. A CI run counter would look similar and be wrong: it skips
+ * numbers whenever a run fails or deduplicates, which makes published versions
+ * a record of workflow bookkeeping rather than of releases.
+ */
+export const nextCanary = (version, published) => {
+    const parsed = semver.parse(version);
+    if (!parsed)
+        throw new Error(`\`${version}\` is not a version to build a canary from.`);
+    // A canary has to sort below every real version of what it is building
+    // towards, or somebody's range resolves to one.
+    //
+    // The familiar `1.7.0-canary.3` shape only half does that. It is below 1.7.0,
+    // but `canary` is above `alpha` and `beta` as a string, so while main sits at
+    // 2.0.0 with 2.0.0-beta.2 published, a consumer on `^2.0.0-beta.2` gets the
+    // canary. Naming it after the prerelease it follows fails the same way from
+    // the other side.
+    //
+    // Semver ranks numeric identifiers below alphanumeric ones, so a numeric
+    // first identifier is the one slot beneath all of them: `2.0.0-0.canary.3` is
+    // below alpha, beta, rc and anything else anyone names, which puts it under
+    // the floor of every prerelease range. One shape for every target, so there
+    // is no case where this is nearly right.
+    const prefix = `${parsed.major}.${parsed.minor}.${parsed.patch}-0.canary.`;
+    // Counted from what is on the tag rather than from a CI run number, which
+    // skips whenever a run fails or deduplicates. The prefix ignores the
+    // prerelease, so the count carries on across alpha, beta and the release
+    // itself instead of restarting at each one.
+    const count = published && published.startsWith(prefix)
+        ? Number(published.slice(prefix.length)) + 1
+        : 0;
+    return `${prefix}${Number.isFinite(count) ? count : 0}`;
+};
+/**
+ * Stamp a canary version into the manifest, ready to publish.
+ *
+ * Returns without writing when the canary tag already points at this commit,
+ * which is what makes a nightly build with nothing new a no-op rather than a
+ * version bump.
+ */
+export const stampCanary = async (root, { sha = process.env.GITHUB_SHA ?? '', published, dryRun = false } = {}) => {
+    const file = path.join(root, 'package.json');
+    const manifest = JSON.parse(await readFile(file, 'utf8'));
+    if (typeof manifest.name !== 'string' || typeof manifest.version !== 'string') {
+        throw new Error('package.json needs a name and a version to stamp a canary.');
+    }
+    const current = published ??
+        {
+            version: view(`${manifest.name}@canary`, 'version'),
+            gitSha: view(`${manifest.name}@canary`, 'gitSha'),
+        };
+    const provenance = isPublic(manifest);
+    if (sha && current.gitSha === sha) {
+        return {
+            name: manifest.name,
+            version: current.version ?? '',
+            skip: true,
+            provenance,
+            sha,
+        };
+    }
+    const version = nextCanary(manifest.version, current.version);
+    if (!dryRun) {
+        await writeFile(file, `${JSON.stringify({ ...manifest, version, gitSha: sha }, null, 2)}\n`);
+    }
+    return { name: manifest.name, version, skip: false, provenance, sha };
+};
+/** Hand a result to the workflow step that decides whether to publish. */
+export const reportToActions = async (result) => {
+    const output = process.env.GITHUB_OUTPUT;
+    if (!output)
+        return;
+    await appendFile(output, `version=${result.version}\n` +
+        `skip=${result.skip ? 'true' : 'false'}\n` +
+        `provenance=${result.provenance ? 'true' : 'false'}\n`);
+};
+/**
+ * Whether a manifest publishes publicly.
+ *
+ * npm generates provenance only for public packages, and asking for it on a
+ * restricted one fails the publish. A scoped package is restricted unless it
+ * says otherwise, which is why the default here is the pessimistic one.
+ */
+export const isPublic = (manifest) => {
+    if (manifest.private === true)
+        return false;
+    const access = manifest.publishConfig?.access;
+    if (access === 'public')
+        return true;
+    if (access === 'restricted')
+        return false;
+    // Unscoped packages are public; scoped ones are not, unless told to be.
+    return typeof manifest.name === 'string' && !manifest.name.startsWith('@');
+};
+//# sourceMappingURL=canary.js.map

package/dist/canary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canary.js","sourceRoot":"","sources":["../src/canary.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}