submodule-version 2.4.1 → 3.1.0

package/README.md

@@ -6,90 +6,149 @@
 
 `Submodule version` is a tool to manage git submodules as versioned packages.
 
-This tool designed to split projects in-to submodules *without npm-packages headache*.
+This tool is designed to split projects into submodules *without npm-packages headache*.
 
-With `submodule version` code can be organized like a *single monorepo*, but each submodule can be *easily reused* in another projects like npm-package.
+With `submodule version` code can be organized like a *single monorepo*, but each submodule can be *easily reused* in other projects like an npm package.
+
+Each module — the project itself and every submodule — declares its dependencies in the `sv` field of its `package.json`, and each release is just a semver git tag. When modules are installed, updated or deleted, `sv` resolves the newest mutually compatible version set across the whole dependency tree with the **PubGrub** algorithm (the one behind Dart's `pub` package manager), reading tags and their `package.json` files straight from the GitHub API without cloning. The resolved set is then applied to the working tree: missing submodules are added, versions are switched to the selected tags and the corresponding `package.json` files are updated — and if no compatible set exists, nothing is touched and a descriptive conflict error is reported.
 
 ## Problem to solve
 
-Take a look on the next situation:
+Take a look at the following situation:
 
 - Project has 2 submodules `ui-button-element` and `render-engine`
-- Package `ui-button-element` dependents on the `render-engine`
-- Third repo `ui-slider-element` dependets on newest version of the `render-engine` and not included in the project
+- Package `ui-button-element` depends on the `render-engine`
+- Third repo `ui-slider-element` depends on the newest version of the `render-engine` and is not included in the project
 
-This cause next problems:
+This causes the following problems:
 
-- Add submodule `ui-slider-element` cause difficulties with handle different `render-engine` versions
-- Manual swithing branches in submodules with big codebase can confuse
-- Updated `ui-button-element` with new version of `render-engine` should be used in another project with the same version
+- Adding the submodule `ui-slider-element` causes difficulties handling different `render-engine` versions
+- Manually switching branches in submodules with a big codebase is confusing
+- An updated `ui-button-element` with a new version of `render-engine` should be used in another project with the same version
 
 Submodule version helps to
 
 - Handle which project should be updated and which version should be installed
-- Help update submodules and theirs dependencies
+- Help update submodules and their dependencies
 - Install new submodules
 
 ## Installation
 
 - Install sv tool `npm i -D submodule-version`
-- Add `workspaces` section in `package.json`
-  ```
-    "workspaces": [
-        "modules/*"
-    ],
-  ```
-- Install first submodule `npx sv i <git_repo>`
-- Install npm dependencies `npm i`. Submodule will be linked in node_modules and its dependencies will be installed
+- Set up a GitHub token (see below) — `sv` reads module versions through the GitHub API
+- Install first submodule `npx sv i <git_repo>` — the `workspaces` section in `package.json` is added automatically on `init`, and `npm install` runs automatically, so the submodule is linked in node_modules and its dependencies are installed
 - Use your submodule in code `import submodule from 'submodule-name'` 🔥
 
+### GitHub token
+
+`sv` lists module versions through the GitHub GraphQL API, which does not work anonymously — a token is required:
+
+1. Create a personal access token at [github.com/settings/tokens](https://github.com/settings/tokens). A **classic** token with the `repo` scope works for both public and private repos; for a **fine-grained** token, grant read-only access to *Contents* and *Metadata* on the repositories you use as submodules.
+2. Export it before running `sv`:
+
+   ```
+   export GITHUB_TOKEN=<your_token>
+   ```
+
+   or pass it via the JS API: `new SV(process.cwd(), 'modules', { githubToken: '<your_token>' })`.
+
+By default submodules live in `modules/` — unless existing submodules in `.gitmodules` point elsewhere, then their directory is used. To use another directory pass the `--modules-dir` flag (`npx sv --modules-dir libs i <git_repo>`) or the constructor argument in the JS API (`new SV(process.cwd(), 'libs')`). The directory is stored in `package.json` as `sv-dir`, so every later call reuses it automatically — no need to pass the flag again. The matching `workspaces` entry is added to `package.json` automatically as well.
+
 ## How it works
 
-- Each submodule and main project has own `package.json` with `sv` object inside. `sv` object will be generated automatically and will contain every dependency version
+- Each submodule and the main project has its own `package.json` with `sv` object inside. `sv` object will be generated automatically and will contain every dependency version
   ```
   "sv": {
       "git@github.com:guljeny/submodule-version.git": "^1.0.0"
   }
   ```
-- Each submodule has a [version](#versioning) tags, and `sv` use list of this tags to resolve dependencies
+- Each submodule has [version](#versioning) tags, and `sv` uses the list of these tags to resolve dependencies
 - The installed version of a submodule is the version tag git `HEAD` points at
-- `Submodule version` creates a graph of whole project and install only possible and actual versions
+- `Submodule version` resolves the newest compatible set with PubGrub and loads nested repositories only when a selected version requires them
 - `sv` never switches a submodule version if it has uncommitted changes or unpushed commits — your local work is always kept intact 🧯
+- After modules are installed, switched or removed, `sv` runs `npm install` automatically — no manual `npm i` is needed (on plain `npx sv` it runs only when something actually changed)
 
 ## Versioning
 
-Sumodules without specified version tags will be installed with ref to the latest commit. You should manage them manually.
+Submodules without specified version tags will be installed with a ref to the latest commit. You should manage them manually.
 
-To add new version in submodule:
-- Specify version in `package.json`
-- Add and push git tag with the same version (`git tag 1.0.1`)
+To add a new version to a submodule:
+- Specify the version in `package.json`
+- Add and push a git tag with the same version (`git tag 1.0.1`)
 
 Or use the [`publish`](#programmatic-api) API, which bumps the version, commits, tags and pushes in one call.
 
 
 ## Commands
 
-- `npx sv validate` - Validate all dependencis and install missing modules
-- `npx sv install <git_url> [target_submodule]` - Install new dependency
-- `npx sv update` - Update all dependencies to the latest possible versions
-- `npx sv publish [module] [--bump release|minor|major] [-m message] [--repo-url git_url]` - Commit, tag and push a new version of a module (or the project itself when `module` is omitted). `--repo-url` is required for the first publish of a module without a git remote
+- `npx sv` - Resolve, validate and install/sync all modules (default command)
+- `npx sv put <url> [target] [--ver 1.2.0]` - Install a submodule or change its version (`install`, `i`). Without `target` the module is installed in the project root; `target` is a parent module name. Without `--ver` the highest possible version is selected (as if `'*'` was passed)
+- `npx sv delete <path>` - Delete a submodule from its parent (project root when the path is a plain name) by path (`remove`, `r`)
+- `npx sv list-versions [name] [--installed]` - List available versions of one module, or of every resolved module when `name` is omitted (`ls`). With `--installed` shows the versions actually checked out in the submodules
+- `npx sv update [path]` - Update modules to the latest allowed versions, all of them or a single one by path (`u`)
+- `npx sv publish [module] [--bump release|minor|major] [-m message] [--repo-url git_url]` - Commit, tag and push a new version of a module (or the project itself when `module` is omitted). `--repo-url` is required for the first publish of a module without a git remote (`p`)
 - `npx sv help` - Description of all commands
 
+All commands accept the global `--modules-dir <dir>` option to use another submodule directory instead of `modules/`. The chosen directory is recorded in `package.json` as `sv-dir` and reused by later commands automatically.
+
 ## Programmatic API
 
 The `SV` class can be used directly from code:
 
 ```ts
-import { SV, versionUtil } from 'submodule-version';
+import { PubGrub, SV, versionUtil } from 'submodule-version';
 
-const sv = new SV(process.cwd(), 'modules');
+const sv = new SV(process.cwd(), 'modules', { githubToken: '…' });
+await sv.init();
+
+await sv.put('git@github.com:org/render-engine.git', '^1.2.0');
+const resolution = sv.getResolution();
 ```
 
-### Switching versions
+The constructor accepts `(projectDir, modulesDir?, { githubToken? })`. The modules directory is resolved as: explicit `modulesDir` argument → `sv-dir` recorded in `package.json` → the common directory of existing submodules in `.gitmodules` → `modules`. The GitHub GraphQL API is used to list module versions without cloning, so a token is required: pass `githubToken` or set the `GITHUB_TOKEN` environment variable.
+
+### Dependency resolution
+
+- `sv.init()` resolves `package.json#sv` with PubGrub and installs/syncs submodules to the resolved versions. It also adds the modules dir to `workspaces` in `package.json` when it is missing, and runs `npm install` when anything changed. All mutations (`put`, `delete`, updates) run `npm install` automatically after applying.
+- `sv.getResolution()` returns the selected version and selected-version dependencies for every resolved module.
+- `new PubGrub(source).resolve(rootDeps)` runs the resolver with a custom entry source, which is useful for tests and non-GitHub registries.
 
-- `sv.setVersion(name, version, constraint?)` - Checkout the submodule to a specific version tag and pin the version constraint in the project `package.json`. By default the constraint is an exact pin of the selected version; pass `^<version>` as `constraint` to keep receiving newer versions on update. If the submodule has local changes that cannot be carried over, the switch is aborted without touching the working tree (`GIT_DIRTY_SWITCH_CONFLICT` error)
-- `sv.getConstraint(name)` - Read the current version constraint of a submodule from the project `package.json`
-- `sv.setConstraint(name, constraint)` - Change the version constraint of a submodule without switching the checked-out version
+### Installing, updating and deleting modules
+
+All mutations first run a check resolve and touch the working tree and `package.json` files only when the resolution succeeds.
+
+- `sv.put(url, version?, parentName?)` - Install a module or change its version. Instead of `url` you can pass the name of an already installed module. All argument forms are supported: `put(url)`, `put(url, version)`, `put(url, parentName)`, `put(url, version, parentName)`.
+  - Without `parentName` the module is installed/updated in the project root and the range is written to the root `package.json#sv`.
+  - With `parentName` the module is added to (or updated in) the parent module and the range is written to the parent's own `package.json#sv`, so the change survives publishing the parent.
+  - Without `version` the highest possible version is selected, as if `'*'` was passed.
+- `sv.delete(name, parentName?)` - Delete a module from its parent (the project root when `parentName` is omitted); the dependency is removed from the corresponding `package.json#sv` and the submodule is uninstalled.
+- `sv.listVersions(name?)` - With `name` returns the available versions of one package (`string[]`); without it returns `{ [pkgName]: string[] }` for every resolved package.
+
+### Simulating changes
+
+`EntryStore.simulate(overrides, rootDeps, callback)` runs the callback against a hypothetically changed dependency tree — every fetch inside the callback sees the overridden modules, and the overrides cease to exist once the callback finishes (also on error):
+
+```ts
+import { EntryStore, PubGrub } from 'submodule-version';
+
+const store = new EntryStore();
+
+// the three override forms:
+const overrides = [
+  // add B to the root
+  { add: 'git@github.com:org/b.git', version: '^1.2.3' },
+  // add B to any version of the installed module A
+  { parent: 'A', add: 'git@github.com:org/b.git', version: '*' },
+  // delete B
+  { delete: 'B' },
+];
+
+const resolution = await store.simulate(overrides, rootDeps, deps => (
+  new PubGrub(store).resolve(deps)
+));
+```
+
+Root-level overrides (without `parent`) are applied to a copy of `rootDeps` that is passed to the callback; `parent` overrides rewrite every version of the parent module. `version` defaults to `'*'`.
 
 ### Inspecting changes and versions
 
@@ -116,10 +175,29 @@ const sv = new SV(process.cwd(), 'modules');
 
 ### Version utilities
 
-`versionUtil` is also exported and now includes `versionUtil.bump(version, 'release' | 'minor' | 'major')` alongside `compare`, `pick`, `validate` and `latest`.
+`versionUtil` exposes standard SemVer validation, comparison, filtering and finite-set operations used by PubGrub: `validate`, `satisfies`, `compare`, `sort`, `select`, `latest`, `intersection`, `union`, `difference`, `intersects`, `isSubset` and `bump`.
+
+### Error handling
+
+`printError(error)` turns any error thrown by the resolver or the `SV` methods into a human-readable string — version conflicts with the requiring parents and the dependency chain, circular dependencies, unknown versions, git layer failures and GitHub API errors. The CLI prints all its errors through it:
+
+```ts
+import { printError, SV } from 'submodule-version';
+
+try {
+  await sv.put('git@github.com:org/b.git', '^2.0.0');
+} catch (error) {
+  console.error(printError(error as Error));
+  // Version conflict for C:
+  //   - ^1.3.2 required by my-project
+  //   - not ^1.4.2 required by B@2.0.0
+  //   chain: A -> B -> C
+  //   available versions: 1.4.2, 1.3.2
+}
+```
 
-## Submodule dependencies 
+## Submodule dependencies
 
-Sumbodules can contains their own dependencies specified in `package.json` as `sv` object.
+Submodules can contain their own dependencies specified in `package.json` as `sv` object.
 
-To install submodule in submodule run `npx install <git_url> [target_submodule]`
+To install a submodule into a submodule, run `npx sv put <git_url> <target_submodule>`

package/dist/runner/handleErrors/handleErrors.d.ts

@@ -1 +1 @@
-export declare const handleErrors: (error: Error, gitUrl: string) => Promise<void>;
+export declare const handleErrors: (error: Error) => Promise<void>;

package/dist/runner/handleErrors/handleErrors.js

@@ -1,17 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleErrors = void 0;
-const handleBuildGraphError_1 = require("./handleBuildGraphError");
-const handleInstallError_1 = require("./handleInstallError");
-const handleGitError_1 = require("./handleGitError");
+const src_1 = require("../../src");
 const log_1 = require("../log");
-const handleErrors = async (error, gitUrl) => {
-    await Promise.all([
-        (0, handleBuildGraphError_1.handleBuildGraphError)(error),
-        (0, handleInstallError_1.handleInstallError)(error, gitUrl),
-        (0, handleGitError_1.handleGitError)(error),
-    ]);
-    log_1.log.error('unhandled error', error.message);
+const handleErrors = async (error) => {
+    log_1.log.error((0, src_1.printError)(error));
 };
 exports.handleErrors = handleErrors;
 //# sourceMappingURL=handleErrors.js.map

package/dist/runner/handleErrors/handleErrors.js.map

@@ -1 +1 @@
-{"version":3,"file":"handleErrors.js","sourceRoot":"","sources":["../../../runner/handleErrors/handleErrors.ts"],"names":[],"mappings":";;;AAAA,mEAAgE;AAChE,6DAA0D;AAC1D,qDAAkD;AAClD,gCAA6B;AAEtB,MAAM,YAAY,GAAG,KAAK,EAAE,KAAY,EAAE,MAAc,EAAE,EAAE;IACjE,MAAM,OAAO,CAAC,GAAG,CAAC;QAChB,IAAA,6CAAqB,EAAC,KAAK,CAAC;QAC5B,IAAA,uCAAkB,EAAC,KAAK,EAAE,MAAM,CAAC;QACjC,IAAA,+BAAc,EAAC,KAAK,CAAC;KACtB,CAAC,CAAC;IACH,SAAG,CAAC,KAAK,CAAC,iBAAiB,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;AAC9C,CAAC,CAAC;AAPW,QAAA,YAAY,gBAOvB"}
+{"version":3,"file":"handleErrors.js","sourceRoot":"","sources":["../../../runner/handleErrors/handleErrors.ts"],"names":[],"mappings":";;;AAAA,mCAAuC;AACvC,gCAA6B;AAEtB,MAAM,YAAY,GAAG,KAAK,EAAE,KAAY,EAAE,EAAE;IACjD,SAAG,CAAC,KAAK,CAAC,IAAA,gBAAU,EAAC,KAAK,CAAC,CAAC,CAAC;AAC/B,CAAC,CAAC;AAFW,QAAA,YAAY,gBAEvB"}

package/dist/runner/runner.d.ts

@@ -1,9 +1,13 @@
 export declare const s: {
     [x: string]: unknown;
+    "modules-dir": string | undefined;
+    modulesDir: string | undefined;
     _: (string | number)[];
     $0: string;
 } | Promise<{
     [x: string]: unknown;
+    "modules-dir": string | undefined;
+    modulesDir: string | undefined;
     _: (string | number)[];
     $0: string;
 }>;

package/dist/runner/runner.js

@@ -9,60 +9,114 @@ const yargs_1 = __importDefault(require("yargs"));
 const src_1 = require("../src");
 const log_1 = require("./log");
 const handleErrors_1 = require("./handleErrors");
-const BASE_DIR = 'modules';
-const makeEvent = (event) => {
-    const sv = new src_1.SV(process.cwd(), BASE_DIR);
-    return async (arg) => {
-        const { url: gitUrl } = arg;
-        try {
-            await event(sv, arg);
-        }
-        catch (e) {
-            (0, handleErrors_1.handleErrors)(e, gitUrl);
+/* 'A.B.C' → { name: 'C', parent: 'B' } (parent — непосредственный родитель) */
+const splitPath = (modulePath) => {
+    const parts = modulePath.split('.');
+    const name = parts.pop();
+    return { name, parent: parts.pop() };
+};
+const makeEvent = (event, { skipInit = false } = {}) => async (arg) => {
+    const sv = new src_1.SV(process.cwd(), arg.modulesDir);
+    try {
+        /* publish умеет работать с ещё не git/npm-инициализированным проектом */
+        if (!skipInit) {
+            await sv.init();
         }
-    };
+        await event(sv, arg);
+    }
+    catch (e) {
+        (0, handleErrors_1.handleErrors)(e);
+    }
 };
-const install = makeEvent(async (sv, arg) => {
-    const { url: gitUrl, target } = arg;
-    await sv.install(gitUrl, target);
+const put = makeEvent(async (sv, arg) => {
+    const { url: gitUrl, target, ver } = arg;
+    await sv.put(gitUrl, ver || target, ver ? target : undefined);
+});
+const update = makeEvent(async (sv, arg) => {
+    const { path: modulePath } = arg;
+    if (!modulePath) {
+        /* init внутри makeEvent уже пересобрал модули на максимально разрешённые */
+        log_1.log.message(chalk_1.default.green.bold('Modules are up to date!'));
+        return;
+    }
+    const { name, parent } = splitPath(modulePath);
+    const entry = sv.getResolution()[name];
+    if (!entry)
+        throw new src_1.SVError('ADDON_NOT_FOUND', { name });
+    await sv.put(entry.url, '*', parent);
 });
-const update = makeEvent(async (sv) => {
-    await sv.update();
+const del = makeEvent(async (sv, arg) => {
+    const { path: modulePath } = arg;
+    const { name, parent } = splitPath(modulePath);
+    await sv.delete(name, parent);
 });
-const remove = makeEvent(async (sv, arg) => {
-    const { name } = arg;
-    await sv.remove(name);
+const listVersions = makeEvent(async (sv, arg) => {
+    const { name, installed } = arg;
+    if (installed) {
+        const resolution = sv.getResolution();
+        if (name && !resolution[name]) {
+            throw new src_1.SVError('ADDON_NOT_FOUND', { name });
+        }
+        const names = name ? [name] : Object.keys(resolution);
+        await Promise.all(names.map(async (moduleName) => {
+            const version = await sv.currentVersion(moduleName);
+            log_1.log.message(chalk_1.default.bold(moduleName), version || chalk_1.default.red('no version tag'));
+        }));
+        return;
+    }
+    const versions = sv.listVersions(name);
+    if (name) {
+        log_1.log.message(chalk_1.default.bold(name), versions.join(', '));
+        return;
+    }
+    Object.entries(versions)
+        .forEach(([moduleName, moduleVersions]) => {
+        log_1.log.message(chalk_1.default.bold(moduleName), moduleVersions.join(', '));
+    });
 });
 const publish = makeEvent(async (sv, arg) => {
     const { module, bump, message, repoUrl } = arg;
     const version = await sv.publish({ module, bump, message, repoUrl });
     log_1.log.message(chalk_1.default.green.bold('Published'), chalk_1.default.bgGreen.black(` ${module || 'project'} `), chalk_1.default.green.bold('version'), chalk_1.default.bgGreen.black(` ${version} `));
-});
+}, { skipInit: true });
 const validate = makeEvent(async (sv) => {
-    const result = await sv.buildGraph();
-    Object.entries(result).forEach(([name, entry]) => {
-        if (!entry.used.includes(entry.version) && entry.versions.length === 0) {
-            log_1.log.message(chalk_1.default.yellow('⚠️  WARN: Module'), chalk_1.default.bgYellow.black(` ${name} `), chalk_1.default.yellow('does not contain any version tag!'));
-        }
-    });
+    sv.getResolution();
     log_1.log.message(chalk_1.default.green.bold('Everything is up to date!🔥'));
 });
-// eslint-disable-next-line @typescript-eslint/no-unused-expressions
 exports.s = yargs_1.default.scriptName('sv')
-    .usage('$0 <cmd> [args]')
-    .command(['validate', '$0', 'v'], 'Validate and install modules', () => { }, validate)
-    .command(['update', 'u'], 'Update git modules to actual versions', () => { }, update)
-    .command(['install <url> [target]', 'i'], 'Install new submodule', y => y.positional('url', {
+    .usage('$0 [cmd] [args]')
+    .option('modules-dir', {
+    type: 'string',
+    describe: 'Directory where submodules live'
+        + ' (stored in package.json as sv-dir)',
+})
+    .command(['$0'], 'Validate and install modules', () => { }, validate)
+    .command(['update [path]', 'u'], 'Update modules to the latest allowed versions', y => y.positional('path', {
     type: 'string',
-    describe: 'Git submodule url',
+    describe: 'Module path (A.B.C), all modules when omitted',
+}), update)
+    .command(['put <url> [target]', 'install', 'i'], 'Install a submodule or change its version', y => y.positional('url', {
+    type: 'string',
+    describe: 'Git submodule url or installed module name',
 }).positional('target', {
     type: 'string',
-    describe: 'Target module name',
-}), install)
-    .command(['remove <name>', 'r'], 'Remove submodule by name', y => y.positional('name', {
+    describe: 'Parent module name',
+}).option('ver', {
+    type: 'string',
+    alias: 'v',
+    describe: 'Version to install',
+}), put)
+    .command(['delete <path>', 'remove', 'r'], 'Delete submodule by path', y => y.positional('path', {
+    type: 'string',
+    describe: 'Submodule path (A.B.C)',
+}), del)
+    .command(['list-versions [name]', 'ls'], 'List available versions of all modules or one', y => y.positional('name', {
     type: 'string',
-    describe: 'Submodule name',
-}), remove)
+    describe: 'Module name',
+}).option('installed', {
+    type: 'boolean',
+    describe: 'Show installed versions instead of available',
+}), listVersions)
     .command(['publish [module]', 'p'], 'Commit, tag and push a new version', y => y.positional('module', {
     type: 'string',
     describe: 'Module name (project itself when omitted)',

package/dist/runner/runner.js.map

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

package/dist/src/PubGrub/PubGrub.d.ts

@@ -0,0 +1,28 @@
+import { IEntrySource, TDependencies, TPubGrubResult } from './types';
+export declare class PubGrub {
+    private source;
+    private entries;
+    private incompatibilities;
+    private incompatibilityKeys;
+    constructor(source?: IEntrySource);
+    resolve: (rootDependencies: TDependencies) => Promise<TPubGrubResult>;
+    private search;
+    private propagate;
+    private relation;
+    private candidates;
+    private addDependencies;
+    private load;
+    private addIncompatibility;
+    private learn;
+    private conflictFrom;
+    private derivedRequirement;
+    private requirement;
+    private addRequirement;
+    private findSelectedConflict;
+    private versionConflict;
+    private assertConstraint;
+    private toError;
+}
+export declare const pubGrub: {
+    resolve: (rootDependencies: TDependencies) => Promise<TPubGrubResult>;
+};