@travetto/repo 3.0.0-rc.4

package/README.md

@@ -0,0 +1,9 @@
+<!-- This file was generated by @travetto/doc and should not be modified directly -->
+<!-- Please modify https://github.com/travetto/travetto/tree/main/module/repo/DOC.ts and execute "npx trv doc" to rebuild -->
+# Repo
+## Monorepo utilities
+
+**Install: @travetto/repo**
+```bash
+npm install @travetto/repo
+```

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@travetto/repo",
+  "version": "3.0.0-rc.4",
+  "description": "Monorepo utilities",
+  "keywords": [
+    "travetto",
+    "typescript",
+    "monorepo"
+  ],
+  "homepage": "https://travetto.io",
+  "license": "MIT",
+  "author": {
+    "email": "travetto.framework@gmail.com",
+    "name": "Travetto Framework"
+  },
+  "files": [
+    "support"
+  ],
+  "repository": {
+    "url": "https://github.com/travetto/travetto.git",
+    "directory": "module/repo"
+  },
+  "dependencies": {
+    "@travetto/cli": "^3.0.0-rc.4"
+  },
+  "peerDependenciesMeta": {
+    "@travetto/cli": {
+      "optional": true
+    }
+  },
+  "travetto": {
+    "displayName": "Repo"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/support/bin/npm.ts

@@ -0,0 +1,48 @@
+import { ExecUtil, ExecutionOptions, ExecutionState, ExecutionResult } from '@travetto/base';
+import { IndexedModule } from '@travetto/manifest';
+
+export type SemverLevel = 'minor' | 'patch' | 'major' | 'prerelease';
+
+export class Npm {
+
+  /**
+   * Is a module already published
+   */
+  static isPublished(mod: IndexedModule, opts: ExecutionOptions): ExecutionState {
+    return ExecUtil.spawn('npm', ['show', `${mod.name}@${mod.version}`, 'version', '--json'], opts);
+  }
+
+  /**
+   * Validate published result
+   */
+  static validatePublishedResult(mod: IndexedModule, result: ExecutionResult): boolean {
+    if (!result.valid && !result.stderr.includes('E404')) {
+      throw new Error(result.stderr);
+    }
+    const item: (string[] | string) = result.stdout ? JSON.parse(result.stdout) : [];
+    const found = Array.isArray(item) ? item.pop() : item;
+    return !!found && found === mod.version;
+  }
+
+  /**
+   * Setting the version
+   */
+  static async version(modules: IndexedModule[], level: SemverLevel, preid?: string): Promise<void> {
+    const mods = modules.flatMap(m => ['-w', m.workspaceRelative]);
+    await ExecUtil.spawn('npm',
+      ['version', level, ...(preid ? ['--preid', preid] : []), ...mods],
+      { stdio: 'inherit' }
+    ).result;
+  }
+
+  /**
+   * Publish a module
+   */
+  static publish(mod: IndexedModule, dryRun: boolean | undefined, opts: ExecutionOptions): ExecutionState {
+    const versionTag = mod.version.replace(/^.*-(rc|alpha|beta|next)[.]\d+/, (a, b) => b) || 'latest';
+    return ExecUtil.spawn('npm',
+      ['publish', ...(dryRun ? ['--dry-run'] : []), '--tag', versionTag, '--access', 'public'],
+      opts
+    );
+  }
+}

package/support/cli.repo_publish.ts

@@ -0,0 +1,44 @@
+import { CliCommand, CliModuleUtil, OptionConfig } from '@travetto/cli';
+import { Npm } from './bin/npm';
+
+type Options = {
+  dryRun: OptionConfig<boolean>;
+};
+
+/**
+* `npx trv repo:publish`
+*
+* Publish all pending modules
+*/
+export class RepoPublishCommand extends CliCommand<Options> {
+
+  name = 'repo:publish';
+
+  getOptions(): Options {
+    return {
+      dryRun: this.boolOption({ desc: 'Dry Run?', def: true })
+    };
+  }
+
+  async action(...args: unknown[]): Promise<void> {
+    const published = await CliModuleUtil.execOnModules('all', (mod, opts) => Npm.isPublished(mod, opts), {
+      filter: mod => !!mod.local && !mod.internal,
+      progressMessage: (mod) => `Checking published [%idx/%total] -- ${mod?.name}`,
+      showStderr: false,
+      transformResult: Npm.validatePublishedResult,
+    });
+
+    if (this.cmd.dryRun) {
+      console.log('Unpublished modules', [...published.entries()].filter(x => !x[1]).map(([mod]) => mod.workspaceRelative));
+    }
+
+    await CliModuleUtil.execOnModules(
+      'all', (mod, opts) => Npm.publish(mod, this.cmd.dryRun, opts),
+      {
+        progressMessage: (mod) => `Published [%idx/%total] -- ${mod?.name}`,
+        showStdout: false,
+        filter: mod => published.get(mod) === false
+      }
+    );
+  }
+}

package/support/cli.repo_version.ts

@@ -0,0 +1,53 @@
+import { CliCommand, CliScmUtil, OptionConfig } from '@travetto/cli';
+import { CliModuleUtil } from '@travetto/cli/src/module';
+
+import { Npm, SemverLevel } from './bin/npm';
+
+type VersionOptions = {
+  changed: OptionConfig<boolean>;
+  force: OptionConfig<boolean>;
+};
+
+/**
+* `npx trv repo:version`
+*
+* Version all all changed dependencies
+*/
+export class RepoVersionCommand extends CliCommand<VersionOptions> {
+
+  name = 'repo:version';
+
+  getArgs(): string {
+    return '[level] [prefix?]';
+  }
+
+  getOptions(): VersionOptions {
+    return {
+      changed: this.boolOption({ desc: 'Only version changed modules', def: true }),
+      force: this.boolOption({ desc: 'Force operation, even in a dirty workspace', def: false })
+    };
+  }
+
+  async action(level: SemverLevel, prefix?: string): Promise<void> {
+    if (!this.cmd.force && await CliScmUtil.isWorkspaceDirty()) {
+      console.error!('Cannot update versions with uncommitted changes');
+      return this.exit(1);
+    }
+
+    const allModules = await CliModuleUtil.findModules(this.cmd.changed ? 'changed' : 'all');
+
+    const modules = allModules.filter(x => !x.internal);
+
+    // Do we have valid changes?
+    if (!modules.length) {
+      console.error!('No modules available for versioning');
+      return this.exit(1);
+    }
+
+    await Npm.version(modules, level, prefix);
+
+    await CliModuleUtil.synchronizeModuleVersions();
+
+    console.log!(await CliScmUtil.createCommit(`Publish ${modules.map(x => x.name).join(',')}`));
+  }
+}