rman 2.13.0 → 2.14.0

package/core/interfaces/dependency-updater.js

@@ -0,0 +1,61 @@
+import micromatch from 'micromatch';
+export var DependencyUpdater;
+(function (DependencyUpdater) {
+    /**
+     * Every move but the largest - `minor` under semver. The largest is the one a scheme reserves for a
+     * break, and taking a break is a decision a person makes, not a default.
+     */
+    /* **It was `latest` - every move - and that was the wrong default**, measured the moment it ran:
+     * a `^5.3.0` came back as `^7.0.2`. The values are the scheme's own `bumpNames` rather than a list
+     * written here, for the reason `version` gives: `patch`/`minor`/`major` are semver's words, and a
+     * four-part scheme would offer four. */
+    function defaultTarget(bumps) {
+        return bumps[Math.max(0, bumps.length - 2)];
+    }
+    DependencyUpdater.defaultTarget = defaultTarget;
+    /**
+     * The largest move `settings` allow for the dependency `name`, and the key that said so - the
+     * **last** `deps.targets` glob matching it, else `deps.target`.
+     */
+    /* Last rather than first, because that is how two `"[selector]"` blocks layer: what is written
+     * later wins. */
+    function targetFor(settings, name) {
+        let found;
+        for (const [glob, size] of Object.entries(settings.targets)) {
+            if (micromatch.isMatch(name, glob))
+                found = { size, from: `deps.targets["${glob}"]` };
+        }
+        return found ?? { size: settings.target, from: 'deps.target' };
+    }
+    DependencyUpdater.targetFor = targetFor;
+    /** The settings `pkg` is planned with: `options` from the command line over its `.rmanrc "deps"`,
+     *  and the defaults under both. */
+    function settingsFor(pkg, options) {
+        const config = pkg.config.deps ?? {};
+        const bumps = pkg.versionScheme.bumpNames;
+        const target = options.target ?? config.target ?? defaultTarget(bumps);
+        if (!bumps.includes(target)) {
+            throw new Error(`Invalid "deps.target" for "${pkg.name}": "${target}" (expected one of: ${bumps.join(', ')}, ` +
+                `the "${pkg.versionScheme.name}" scheme's own sizes)`);
+        }
+        const targets = options.target ? {} : { ...(config.targets ?? {}) };
+        for (const [glob, size] of Object.entries(targets)) {
+            if (!bumps.includes(size)) {
+                throw new Error(`Invalid "deps.targets" entry "${glob}" for "${pkg.name}": "${size}" (expected one of: ${bumps.join(', ')})`);
+            }
+        }
+        return {
+            target,
+            targets,
+            reject: [...toList(config.reject), ...(options.reject ?? [])],
+            minAge: options.minAge ?? config.minAge ?? 0,
+            types: config.types?.length ? [...config.types] : undefined,
+        };
+    }
+    DependencyUpdater.settingsFor = settingsFor;
+})(DependencyUpdater || (DependencyUpdater = {}));
+function toList(value) {
+    if (value === undefined)
+        return [];
+    return Array.isArray(value) ? [...value] : [value];
+}

package/core/interfaces/plugin.d.ts

@@ -4,6 +4,7 @@ import type { BinPath } from '../../utils/bin-path.js';
 import type { RmanApplication } from '../application.js';
 import type { Repository } from '../classes/repository.js';
 import type { Workspace } from '../classes/workspace.js';
+import type { DependencyUpdater } from './dependency-updater.js';
 import type { ManifestProvider } from './manifest.js';
 /**
  * **One technology, as a whole** - Node, Cargo, Maven. Everything rman needs in order to treat a
@@ -75,6 +76,9 @@ export interface Platform {
     /** How this technology's releases are planned - where a package's change boundary comes from
      *  when it has no release tag, and how far into its group a bump reaches. */
     versionPlanner?: VersionPlanService;
+    /** How this technology's dependencies are checked against their registry and moved forward -
+     *  what `rman deps` asks. Absent, `deps` leaves this technology's packages alone. */
+    dependencyUpdater?: DependencyUpdater;
 }
 /**
  * **A plugin is whatever a package contributes; a platform is one of the things it can contribute.**

package/index.d.ts

@@ -65,6 +65,8 @@ export { Manifest } from './core/interfaces/manifest.js';
 export { Registry } from './core/classes/registry.js';
 export { Repository } from './core/classes/repository.js';
 export { Service, type ServiceFactory, type ServiceMap } from './core/classes/service.js';
+/** The `deps` seam: how a technology checks its dependencies against a registry and moves them. */
+export { DependencyUpdater } from './core/interfaces/dependency-updater.js';
 export { declaredTargets, type PublishTarget, shipsTo, skipReasonFor, targetsOf, unknownTargets, } from './core/interfaces/publish-target.js';
 export type { RunConditionFn, RunStepContext, RunStepFn, RunStepObject, RunStepValue, } from './core/interfaces/run-step.js';
 /**

package/index.js

@@ -71,6 +71,8 @@ export { Manifest } from './core/interfaces/manifest.js';
 export { Registry } from './core/classes/registry.js';
 export { Repository } from './core/classes/repository.js';
 export { Service } from './core/classes/service.js';
+/** The `deps` seam: how a technology checks its dependencies against a registry and moves them. */
+export { DependencyUpdater } from './core/interfaces/dependency-updater.js';
 export { declaredTargets, shipsTo, skipReasonFor, targetsOf, unknownTargets, } from './core/interfaces/publish-target.js';
 export { basePlatform, definePlatform, definePlugin, isPlatform, } from './core/interfaces/plugin.js';
 /** The numbering seam. `VersionScheme` is abstract - `highestVersion`/`highestBump`/`smallestBump`

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "rman",
   "description": "Repository manager",
-  "version": "2.13.0",
+  "version": "2.14.0",
   "author": "Panates",
   "license": "MIT",
   "dependencies": {