@neurodevs/meta-node 0.15.0 → 0.16.1

package/build/__tests__/impl/NpmPropagationCoordinator.test.d.ts

@@ -0,0 +1,19 @@
+import AbstractModuleTest from '@neurodevs/node-tdd';
+export default class NpmPropagationCoordinatorTest extends AbstractModuleTest {
+    private static instance;
+    private static readonly packageScope;
+    private static readonly packageName;
+    private static readonly scopedName;
+    private static readonly packageVersion;
+    private static readonly repoPath;
+    private static readonly repoPaths;
+    private static readonly pkgJsons;
+    protected static beforeEach(): Promise<void>;
+    protected static createsInstance(): Promise<void>;
+    protected static propagatesToCorrectRepoPaths(): Promise<void>;
+    private static run;
+    private static generatePackageJson;
+    private static setFakeReadFile;
+    private static setFakeReleasePropagator;
+    private static NpmPropagationCoordinator;
+}

package/build/__tests__/impl/NpmPropagationCoordinator.test.js

@@ -0,0 +1,86 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { fakeReadFile, resetCallsToReadFile, setFakeReadFileResult, } from '@neurodevs/fake-node-core';
+import AbstractModuleTest, { test, assert } from '@neurodevs/node-tdd';
+import NpmPropagationCoordinator from '../../impl/NpmPropagationCoordinator.js';
+import NpmReleasePropagator from '../../impl/NpmReleasePropagator.js';
+import FakeReleasePropagator from '../../testDoubles/ReleasePropagator/FakeReleasePropagator.js';
+export default class NpmPropagationCoordinatorTest extends AbstractModuleTest {
+    static instance;
+    static packageScope = this.generateId();
+    static packageName = this.generateId();
+    static scopedName = `${this.packageScope}/${this.packageName}`;
+    static packageVersion = '7.8.9';
+    static repoPath = `${this.generateId()}/${this.packageName}`;
+    static repoPaths = [
+        this.generateId(),
+        this.generateId(),
+        this.generateId(),
+        this.repoPath,
+    ];
+    static pkgJsons = [
+        this.generatePackageJson({
+            dependencies: { [this.scopedName]: '^1.2.3' },
+        }),
+        this.generatePackageJson({
+            devDependencies: { [this.scopedName]: '^4.5.6' },
+        }),
+        this.generatePackageJson(),
+        this.generatePackageJson({ version: this.packageVersion }),
+    ];
+    static async beforeEach() {
+        await super.beforeEach();
+        this.setFakeReadFile();
+        this.setFakeReleasePropagator();
+        this.instance = this.NpmPropagationCoordinator();
+    }
+    static async createsInstance() {
+        assert.isTruthy(this.instance, 'Failed to create instance!');
+    }
+    static async propagatesToCorrectRepoPaths() {
+        await this.run();
+        assert.isEqualDeep(FakeReleasePropagator.callsToConstructor[0], {
+            packageName: this.scopedName,
+            packageVersion: this.packageVersion,
+            repoPaths: [this.repoPaths[0], this.repoPaths[1]],
+        }, 'Incorrect repo paths propagated to!');
+    }
+    static async run() {
+        await this.instance.run();
+    }
+    static generatePackageJson(options) {
+        return {
+            name: this.scopedName,
+            version: this.packageVersion,
+            dependencies: {},
+            devDependencies: {},
+            ...options,
+        };
+    }
+    static setFakeReadFile() {
+        NpmPropagationCoordinator.readFile =
+            fakeReadFile;
+        resetCallsToReadFile();
+        this.repoPaths.forEach((repoPath, i) => {
+            setFakeReadFileResult(`${repoPath}/package.json`, JSON.stringify(this.pkgJsons[i], null, 4));
+        });
+    }
+    static setFakeReleasePropagator() {
+        NpmReleasePropagator.Class = FakeReleasePropagator;
+        FakeReleasePropagator.resetTestDouble();
+    }
+    static NpmPropagationCoordinator() {
+        return NpmPropagationCoordinator.Create(this.repoPath, this.repoPaths);
+    }
+}
+__decorate([
+    test()
+], NpmPropagationCoordinatorTest, "createsInstance", null);
+__decorate([
+    test()
+], NpmPropagationCoordinatorTest, "propagatesToCorrectRepoPaths", null);
+//# sourceMappingURL=NpmPropagationCoordinator.test.js.map

package/build/__tests__/impl/NpmPropagationCoordinator.test.js.map

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

package/build/impl/NpmPropagationCoordinator.d.ts

@@ -0,0 +1,26 @@
+import { readFile } from 'node:fs/promises';
+export default class NpmPropagationCoordinator implements PropagationCoordinator {
+    static Class?: PropagationCoordinatorConstructor;
+    static readFile: typeof readFile;
+    private repoPath;
+    private repoPaths;
+    private pkg;
+    private currentRepoPath;
+    private currentPkgJson;
+    protected constructor(repoPath: string, repoPaths: string[]);
+    static Create(repoPath: string, repoPaths: string[]): PropagationCoordinator;
+    run(): Promise<void>;
+    private loadPackageJson;
+    private get packageName();
+    private get packageVersion();
+    private determineWhereToPropagate;
+    private get isDependency();
+    private get isDevDependency();
+    private loadCurrentPkgJson;
+    private get readFile();
+    private NpmReleaseCoordinator;
+}
+export interface PropagationCoordinator {
+    run(): Promise<void>;
+}
+export type PropagationCoordinatorConstructor = new (repoPath: string, repoPaths: string[]) => PropagationCoordinator;

package/build/impl/NpmPropagationCoordinator.js

@@ -0,0 +1,66 @@
+import { readFile } from 'node:fs/promises';
+import NpmReleasePropagator from './NpmReleasePropagator.js';
+export default class NpmPropagationCoordinator {
+    static Class;
+    static readFile = readFile;
+    repoPath;
+    repoPaths;
+    pkg;
+    currentRepoPath;
+    currentPkgJson;
+    constructor(repoPath, repoPaths) {
+        this.repoPath = repoPath;
+        this.repoPaths = repoPaths;
+    }
+    static Create(repoPath, repoPaths) {
+        return new (this.Class ?? this)(repoPath, repoPaths);
+    }
+    async run() {
+        await this.loadPackageJson();
+        const repoPaths = await this.determineWhereToPropagate();
+        const propagator = this.NpmReleaseCoordinator({
+            packageName: this.packageName,
+            packageVersion: this.packageVersion,
+            repoPaths,
+        });
+        await propagator.run();
+    }
+    async loadPackageJson() {
+        const pkgJson = await this.readFile(`${this.repoPath}/package.json`, 'utf-8');
+        this.pkg = JSON.parse(pkgJson);
+    }
+    get packageName() {
+        return this.pkg.name;
+    }
+    get packageVersion() {
+        return this.pkg.version;
+    }
+    async determineWhereToPropagate() {
+        const repoPaths = [];
+        for (const repoPath of this.repoPaths) {
+            this.currentRepoPath = repoPath;
+            this.currentPkgJson = await this.loadCurrentPkgJson();
+            if (this.isDependency ?? this.isDevDependency) {
+                repoPaths.push(repoPath);
+            }
+        }
+        return repoPaths;
+    }
+    get isDependency() {
+        return this.currentPkgJson.dependencies[this.packageName];
+    }
+    get isDevDependency() {
+        return this.currentPkgJson.devDependencies[this.packageName];
+    }
+    async loadCurrentPkgJson() {
+        const pkgJson = await this.readFile(`${this.currentRepoPath}/package.json`, 'utf-8');
+        return JSON.parse(pkgJson);
+    }
+    get readFile() {
+        return NpmPropagationCoordinator.readFile;
+    }
+    NpmReleaseCoordinator(options) {
+        return NpmReleasePropagator.Create(options);
+    }
+}
+//# sourceMappingURL=NpmPropagationCoordinator.js.map

package/build/impl/NpmPropagationCoordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NpmPropagationCoordinator.js","sourceRoot":"","sources":["../../src/impl/NpmPropagationCoordinator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAE3C,OAAO,oBAGN,MAAM,2BAA2B,CAAA;AAElC,MAAM,CAAC,OAAO,OAAO,yBAAyB;IACnC,MAAM,CAAC,KAAK,CAAoC;IAChD,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAEzB,QAAQ,CAAQ;IAChB,SAAS,CAAU;IAEnB,GAAG,CAAc;IACjB,eAAe,CAAS;IACxB,cAAc,CAAc;IAEpC,YAAsB,QAAgB,EAAE,SAAmB;QACvD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;IAC9B,CAAC;IAEM,MAAM,CAAC,MAAM,CAAC,QAAgB,EAAE,SAAmB;QACtD,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;IACxD,CAAC;IAEM,KAAK,CAAC,GAAG;QACZ,MAAM,IAAI,CAAC,eAAe,EAAE,CAAA;QAE5B,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,yBAAyB,EAAE,CAAA;QAExD,MAAM,UAAU,GAAG,IAAI,CAAC,qBAAqB,CAAC;YAC1C,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,SAAS;SACZ,CAAC,CAAA;QAEF,MAAM,UAAU,CAAC,GAAG,EAAE,CAAA;IAC1B,CAAC;IAEO,KAAK,CAAC,eAAe;QACzB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAC/B,GAAG,IAAI,CAAC,QAAQ,eAAe,EAC/B,OAAO,CACV,CAAA;QACD,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAClC,CAAC;IAED,IAAY,WAAW;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAA;IACxB,CAAC;IAED,IAAY,cAAc;QACtB,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAA;IAC3B,CAAC;IAEO,KAAK,CAAC,yBAAyB;QACnC,MAAM,SAAS,GAAa,EAAE,CAAA;QAE9B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACpC,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAA;YAC/B,IAAI,CAAC,cAAc,GAAG,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAA;YAErD,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBAC5C,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YAC5B,CAAC;QACL,CAAC;QACD,OAAO,SAAS,CAAA;IACpB,CAAC;IAED,IAAY,YAAY;QACpB,OAAO,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;IAC7D,CAAC;IAED,IAAY,eAAe;QACvB,OAAO,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;IAChE,CAAC;IAEO,KAAK,CAAC,kBAAkB;QAC5B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAC/B,GAAG,IAAI,CAAC,eAAe,eAAe,EACtC,OAAO,CACV,CAAA;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAC9B,CAAC;IAED,IAAY,QAAQ;QAChB,OAAO,yBAAyB,CAAC,QAAQ,CAAA;IAC7C,CAAC;IAEO,qBAAqB,CAAC,OAAiC;QAC3D,OAAO,oBAAoB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAC/C,CAAC"}

package/build/impl/NpmReleasePropagator.d.ts

@@ -35,6 +35,8 @@ export interface ReleasePropagatorOptions {
     repoPaths: string[];
 }
 export interface PackageJson {
-    dependencies?: Record<string, string>;
-    devDependencies?: Record<string, string>;
+    name: string;
+    version: string;
+    dependencies: Record<string, string>;
+    devDependencies: Record<string, string>;
 }

package/build/index.d.ts

@@ -22,6 +22,10 @@ export { default as NpmAutopackage } from './impl/NpmAutopackage.js';
 export * from './impl/NpmAutopackage.js';
 export { default as FakeAutopackage } from './testDoubles/Autopackage/FakeAutopackage.js';
 export * from './testDoubles/Autopackage/FakeAutopackage.js';
+export { default as NpmPropagationCoordinator } from './impl/NpmPropagationCoordinator.js';
+export * from './impl/NpmPropagationCoordinator.js';
+export { default as FakePropagationCoordinator } from './testDoubles/PropagationCoordinator/FakePropagationCoordinator.js';
+export * from './testDoubles/PropagationCoordinator/FakePropagationCoordinator.js';
 export { default as NpmReleasePropagator } from './impl/NpmReleasePropagator.js';
 export * from './impl/NpmReleasePropagator.js';
 export { default as FakeReleasePropagator } from './testDoubles/ReleasePropagator/FakeReleasePropagator.js';

package/build/index.js

@@ -27,6 +27,11 @@ export { default as NpmAutopackage } from './impl/NpmAutopackage.js';
 export * from './impl/NpmAutopackage.js';
 export { default as FakeAutopackage } from './testDoubles/Autopackage/FakeAutopackage.js';
 export * from './testDoubles/Autopackage/FakeAutopackage.js';
+// PropagationCoordinator
+export { default as NpmPropagationCoordinator } from './impl/NpmPropagationCoordinator.js';
+export * from './impl/NpmPropagationCoordinator.js';
+export { default as FakePropagationCoordinator } from './testDoubles/PropagationCoordinator/FakePropagationCoordinator.js';
+export * from './testDoubles/PropagationCoordinator/FakePropagationCoordinator.js';
 // ReleasePropagator
 export { default as NpmReleasePropagator } from './impl/NpmReleasePropagator.js';
 export * from './impl/NpmReleasePropagator.js';

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,aAAa;AAEb,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAClE,cAAc,yBAAyB,CAAA;AAEvC,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,4CAA4C,CAAA;AACtF,cAAc,4CAA4C,CAAA;AAE1D,aAAa;AAEb,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAClE,cAAc,yBAAyB,CAAA;AAEvC,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,4CAA4C,CAAA;AACtF,cAAc,4CAA4C,CAAA;AAE1D,iBAAiB;AAEjB,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,iCAAiC,CAAA;AAClF,cAAc,iCAAiC,CAAA;AAE/C,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,oDAAoD,CAAA;AAClG,cAAc,oDAAoD,CAAA;AAElE,aAAa;AAEb,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,8BAA8B,CAAA;AAC5E,cAAc,8BAA8B,CAAA;AAE5C,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,0BAA0B,CAAA;AACpE,cAAc,0BAA0B,CAAA;AAExC,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAChE,cAAc,wBAAwB,CAAA;AAEtC,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,4CAA4C,CAAA;AACtF,cAAc,4CAA4C,CAAA;AAE1D,cAAc;AAEd,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,0BAA0B,CAAA;AACpE,cAAc,0BAA0B,CAAA;AAExC,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,8CAA8C,CAAA;AACzF,cAAc,8CAA8C,CAAA;AAE5D,oBAAoB;AAEpB,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,gCAAgC,CAAA;AAChF,cAAc,gCAAgC,CAAA;AAE9C,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,0DAA0D,CAAA;AAC3G,cAAc,0DAA0D,CAAA;AAExE,mBAAmB;AAEnB,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,kCAAkC,CAAA;AACpF,cAAc,kCAAkC,CAAA;AAEhD,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,wDAAwD,CAAA;AACxG,cAAc,wDAAwD,CAAA;AAEtE,eAAe;AAEf,OAAO,EAAE,OAAO,IAAI,2BAA2B,EAAE,MAAM,uCAAuC,CAAA;AAC9F,cAAc,uCAAuC,CAAA;AAErD,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,gDAAgD,CAAA;AAC5F,cAAc,gDAAgD,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,aAAa;AAEb,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAClE,cAAc,yBAAyB,CAAA;AAEvC,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,4CAA4C,CAAA;AACtF,cAAc,4CAA4C,CAAA;AAE1D,aAAa;AAEb,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAClE,cAAc,yBAAyB,CAAA;AAEvC,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,4CAA4C,CAAA;AACtF,cAAc,4CAA4C,CAAA;AAE1D,iBAAiB;AAEjB,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,iCAAiC,CAAA;AAClF,cAAc,iCAAiC,CAAA;AAE/C,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,oDAAoD,CAAA;AAClG,cAAc,oDAAoD,CAAA;AAElE,aAAa;AAEb,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,8BAA8B,CAAA;AAC5E,cAAc,8BAA8B,CAAA;AAE5C,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,0BAA0B,CAAA;AACpE,cAAc,0BAA0B,CAAA;AAExC,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAChE,cAAc,wBAAwB,CAAA;AAEtC,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,4CAA4C,CAAA;AACtF,cAAc,4CAA4C,CAAA;AAE1D,cAAc;AAEd,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,0BAA0B,CAAA;AACpE,cAAc,0BAA0B,CAAA;AAExC,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,8CAA8C,CAAA;AACzF,cAAc,8CAA8C,CAAA;AAE5D,yBAAyB;AAEzB,OAAO,EAAE,OAAO,IAAI,yBAAyB,EAAE,MAAM,qCAAqC,CAAA;AAC1F,cAAc,qCAAqC,CAAA;AAEnD,OAAO,EAAE,OAAO,IAAI,0BAA0B,EAAE,MAAM,oEAAoE,CAAA;AAC1H,cAAc,oEAAoE,CAAA;AAElF,oBAAoB;AAEpB,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,gCAAgC,CAAA;AAChF,cAAc,gCAAgC,CAAA;AAE9C,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,0DAA0D,CAAA;AAC3G,cAAc,0DAA0D,CAAA;AAExE,mBAAmB;AAEnB,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,kCAAkC,CAAA;AACpF,cAAc,kCAAkC,CAAA;AAEhD,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,wDAAwD,CAAA;AACxG,cAAc,wDAAwD,CAAA;AAEtE,eAAe;AAEf,OAAO,EAAE,OAAO,IAAI,2BAA2B,EAAE,MAAM,uCAAuC,CAAA;AAC9F,cAAc,uCAAuC,CAAA;AAErD,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,gDAAgD,CAAA;AAC5F,cAAc,gDAAgD,CAAA"}

package/build/testDoubles/PropagationCoordinator/FakePropagationCoordinator.d.ts

@@ -0,0 +1,11 @@
+import { PropagationCoordinator } from '../../impl/NpmPropagationCoordinator.js';
+export default class FakePropagationCoordinator implements PropagationCoordinator {
+    static callsToConstructor: {
+        repoPath?: string;
+        repoPaths?: string[];
+    }[];
+    static numCallsToRun: number;
+    constructor(repoPath?: string, repoPaths?: string[]);
+    run(): Promise<void>;
+    static resetTestDouble(): void;
+}

package/build/testDoubles/PropagationCoordinator/FakePropagationCoordinator.js

@@ -0,0 +1,18 @@
+export default class FakePropagationCoordinator {
+    static callsToConstructor = [];
+    static numCallsToRun = 0;
+    constructor(repoPath, repoPaths) {
+        FakePropagationCoordinator.callsToConstructor.push({
+            repoPath,
+            repoPaths,
+        });
+    }
+    async run() {
+        FakePropagationCoordinator.numCallsToRun += 1;
+    }
+    static resetTestDouble() {
+        FakePropagationCoordinator.callsToConstructor = [];
+        FakePropagationCoordinator.numCallsToRun = 0;
+    }
+}
+//# sourceMappingURL=FakePropagationCoordinator.js.map

package/build/testDoubles/PropagationCoordinator/FakePropagationCoordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FakePropagationCoordinator.js","sourceRoot":"","sources":["../../../src/testDoubles/PropagationCoordinator/FakePropagationCoordinator.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,OAAO,OAAO,0BAA0B;IACpC,MAAM,CAAC,kBAAkB,GAG1B,EAAE,CAAA;IAED,MAAM,CAAC,aAAa,GAAG,CAAC,CAAA;IAE/B,YAAmB,QAAiB,EAAE,SAAoB;QACtD,0BAA0B,CAAC,kBAAkB,CAAC,IAAI,CAAC;YAC/C,QAAQ;YACR,SAAS;SACZ,CAAC,CAAA;IACN,CAAC;IAEM,KAAK,CAAC,GAAG;QACZ,0BAA0B,CAAC,aAAa,IAAI,CAAC,CAAA;IACjD,CAAC;IAEM,MAAM,CAAC,eAAe;QACzB,0BAA0B,CAAC,kBAAkB,GAAG,EAAE,CAAA;QAClD,0BAA0B,CAAC,aAAa,GAAG,CAAC,CAAA;IAChD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neurodevs/meta-node",
-  "version": "0.15.0",
+  "version": "0.16.1",
   "description": "Meta-layer utilities for maintaining Node.js package ecosystems.",
   "type": "module",
   "keywords": [

package/src/__tests__/impl/NpmPropagationCoordinator.test.ts

@@ -0,0 +1,109 @@
+import { readFile } from 'node:fs/promises'
+
+import {
+    fakeReadFile,
+    resetCallsToReadFile,
+    setFakeReadFileResult,
+} from '@neurodevs/fake-node-core'
+import AbstractModuleTest, { test, assert } from '@neurodevs/node-tdd'
+
+import NpmPropagationCoordinator, {
+    PropagationCoordinator,
+} from '../../impl/NpmPropagationCoordinator.js'
+import NpmReleasePropagator, {
+    PackageJson,
+} from '../../impl/NpmReleasePropagator.js'
+import FakeReleasePropagator from '../../testDoubles/ReleasePropagator/FakeReleasePropagator.js'
+
+export default class NpmPropagationCoordinatorTest extends AbstractModuleTest {
+    private static instance: PropagationCoordinator
+
+    private static readonly packageScope = this.generateId()
+    private static readonly packageName = this.generateId()
+    private static readonly scopedName = `${this.packageScope}/${this.packageName}`
+    private static readonly packageVersion = '7.8.9'
+    private static readonly repoPath = `${this.generateId()}/${this.packageName}`
+
+    private static readonly repoPaths = [
+        this.generateId(),
+        this.generateId(),
+        this.generateId(),
+        this.repoPath,
+    ]
+
+    private static readonly pkgJsons = [
+        this.generatePackageJson({
+            dependencies: { [this.scopedName]: '^1.2.3' },
+        }),
+        this.generatePackageJson({
+            devDependencies: { [this.scopedName]: '^4.5.6' },
+        }),
+        this.generatePackageJson(),
+        this.generatePackageJson({ version: this.packageVersion }),
+    ]
+
+    protected static async beforeEach() {
+        await super.beforeEach()
+
+        this.setFakeReadFile()
+        this.setFakeReleasePropagator()
+
+        this.instance = this.NpmPropagationCoordinator()
+    }
+
+    @test()
+    protected static async createsInstance() {
+        assert.isTruthy(this.instance, 'Failed to create instance!')
+    }
+
+    @test()
+    protected static async propagatesToCorrectRepoPaths() {
+        await this.run()
+
+        assert.isEqualDeep(
+            FakeReleasePropagator.callsToConstructor[0],
+            {
+                packageName: this.scopedName,
+                packageVersion: this.packageVersion,
+                repoPaths: [this.repoPaths[0], this.repoPaths[1]],
+            },
+            'Incorrect repo paths propagated to!'
+        )
+    }
+
+    private static async run() {
+        await this.instance.run()
+    }
+
+    private static generatePackageJson(options?: Partial<PackageJson>) {
+        return {
+            name: this.scopedName,
+            version: this.packageVersion,
+            dependencies: {},
+            devDependencies: {},
+            ...options,
+        }
+    }
+
+    private static setFakeReadFile() {
+        NpmPropagationCoordinator.readFile =
+            fakeReadFile as unknown as typeof readFile
+        resetCallsToReadFile()
+
+        this.repoPaths.forEach((repoPath, i) => {
+            setFakeReadFileResult(
+                `${repoPath}/package.json`,
+                JSON.stringify(this.pkgJsons[i], null, 4)
+            )
+        })
+    }
+
+    private static setFakeReleasePropagator() {
+        NpmReleasePropagator.Class = FakeReleasePropagator
+        FakeReleasePropagator.resetTestDouble()
+    }
+
+    private static NpmPropagationCoordinator() {
+        return NpmPropagationCoordinator.Create(this.repoPath, this.repoPaths)
+    }
+}

package/src/impl/NpmPropagationCoordinator.ts

@@ -0,0 +1,104 @@
+import { readFile } from 'node:fs/promises'
+
+import NpmReleasePropagator, {
+    PackageJson,
+    ReleasePropagatorOptions,
+} from './NpmReleasePropagator.js'
+
+export default class NpmPropagationCoordinator implements PropagationCoordinator {
+    public static Class?: PropagationCoordinatorConstructor
+    public static readFile = readFile
+
+    private repoPath: string
+    private repoPaths: string[]
+
+    private pkg!: PackageJson
+    private currentRepoPath!: string
+    private currentPkgJson!: PackageJson
+
+    protected constructor(repoPath: string, repoPaths: string[]) {
+        this.repoPath = repoPath
+        this.repoPaths = repoPaths
+    }
+
+    public static Create(repoPath: string, repoPaths: string[]) {
+        return new (this.Class ?? this)(repoPath, repoPaths)
+    }
+
+    public async run() {
+        await this.loadPackageJson()
+
+        const repoPaths = await this.determineWhereToPropagate()
+
+        const propagator = this.NpmReleaseCoordinator({
+            packageName: this.packageName,
+            packageVersion: this.packageVersion,
+            repoPaths,
+        })
+
+        await propagator.run()
+    }
+
+    private async loadPackageJson() {
+        const pkgJson = await this.readFile(
+            `${this.repoPath}/package.json`,
+            'utf-8'
+        )
+        this.pkg = JSON.parse(pkgJson)
+    }
+
+    private get packageName() {
+        return this.pkg.name
+    }
+
+    private get packageVersion() {
+        return this.pkg.version
+    }
+
+    private async determineWhereToPropagate() {
+        const repoPaths: string[] = []
+
+        for (const repoPath of this.repoPaths) {
+            this.currentRepoPath = repoPath
+            this.currentPkgJson = await this.loadCurrentPkgJson()
+
+            if (this.isDependency ?? this.isDevDependency) {
+                repoPaths.push(repoPath)
+            }
+        }
+        return repoPaths
+    }
+
+    private get isDependency() {
+        return this.currentPkgJson.dependencies[this.packageName]
+    }
+
+    private get isDevDependency() {
+        return this.currentPkgJson.devDependencies[this.packageName]
+    }
+
+    private async loadCurrentPkgJson() {
+        const pkgJson = await this.readFile(
+            `${this.currentRepoPath}/package.json`,
+            'utf-8'
+        )
+        return JSON.parse(pkgJson)
+    }
+
+    private get readFile() {
+        return NpmPropagationCoordinator.readFile
+    }
+
+    private NpmReleaseCoordinator(options: ReleasePropagatorOptions) {
+        return NpmReleasePropagator.Create(options)
+    }
+}
+
+export interface PropagationCoordinator {
+    run(): Promise<void>
+}
+
+export type PropagationCoordinatorConstructor = new (
+    repoPath: string,
+    repoPaths: string[]
+) => PropagationCoordinator

package/src/impl/NpmReleasePropagator.ts

@@ -129,6 +129,8 @@ export interface ReleasePropagatorOptions {
 }
 
 export interface PackageJson {
-    dependencies?: Record<string, string>
-    devDependencies?: Record<string, string>
+    name: string
+    version: string
+    dependencies: Record<string, string>
+    devDependencies: Record<string, string>
 }

package/src/index.ts

@@ -44,6 +44,14 @@ export * from './impl/NpmAutopackage.js'
 export { default as FakeAutopackage } from './testDoubles/Autopackage/FakeAutopackage.js'
 export * from './testDoubles/Autopackage/FakeAutopackage.js'
 
+// PropagationCoordinator
+
+export { default as NpmPropagationCoordinator } from './impl/NpmPropagationCoordinator.js'
+export * from './impl/NpmPropagationCoordinator.js'
+
+export { default as FakePropagationCoordinator } from './testDoubles/PropagationCoordinator/FakePropagationCoordinator.js'
+export * from './testDoubles/PropagationCoordinator/FakePropagationCoordinator.js'
+
 // ReleasePropagator
 
 export { default as NpmReleasePropagator } from './impl/NpmReleasePropagator.js'

package/src/testDoubles/PropagationCoordinator/FakePropagationCoordinator.ts

@@ -0,0 +1,26 @@
+import { PropagationCoordinator } from '../../impl/NpmPropagationCoordinator.js'
+
+export default class FakePropagationCoordinator implements PropagationCoordinator {
+    public static callsToConstructor: {
+        repoPath?: string
+        repoPaths?: string[]
+    }[] = []
+
+    public static numCallsToRun = 0
+
+    public constructor(repoPath?: string, repoPaths?: string[]) {
+        FakePropagationCoordinator.callsToConstructor.push({
+            repoPath,
+            repoPaths,
+        })
+    }
+
+    public async run() {
+        FakePropagationCoordinator.numCallsToRun += 1
+    }
+
+    public static resetTestDouble() {
+        FakePropagationCoordinator.callsToConstructor = []
+        FakePropagationCoordinator.numCallsToRun = 0
+    }
+}