@smartsoft001/core 2.143.0 → 2.145.0

package/migrations.json

@@ -0,0 +1,11 @@
+{
+  "generators": {
+    "use-stack-packages": {
+      "cli": "nx",
+      "version": "2.145.0",
+      "description": "Replace individually installed @smartsoft001 packages with the stack package that already pins them.",
+      "factory": "./src/migrations/use-stack-packages/use-stack-packages",
+      "documentation": "./src/migrations/use-stack-packages/README.md"
+    }
+  }
+}

package/package.json

@@ -1,21 +1,25 @@
 {
   "name": "@smartsoft001/core",
-  "version": "2.143.0",
+  "version": "2.145.0",
   "publishConfig": {
     "access": "public"
   },
+  "ng-update": {
+    "migrations": "./migrations.json",
+    "supportsOptionalMigrations": true
+  },
   "description": "Every framework-agnostic @smartsoft001 package in one install: the model decorators, the domain contracts, the helpers and the shared DTOs.",
   "license": "MIT",
   "dependencies": {
-    "@smartsoft001/models": "2.143.0",
-    "@smartsoft001/domain-core": "2.143.0",
-    "@smartsoft001/utils": "2.143.0",
-    "@smartsoft001/users": "2.143.0",
-    "@smartsoft001/auth-domain": "2.143.0",
-    "@smartsoft001/crud-domain": "2.143.0",
-    "@smartsoft001/crud-shell-dtos": "2.143.0",
-    "@smartsoft001/auth-shell-dtos": "2.143.0",
-    "@smartsoft001/crud-shell-app-services": "2.143.0",
-    "@smartsoft001/auth-shell-app-services": "2.143.0"
+    "@smartsoft001/models": "2.145.0",
+    "@smartsoft001/domain-core": "2.145.0",
+    "@smartsoft001/utils": "2.145.0",
+    "@smartsoft001/users": "2.145.0",
+    "@smartsoft001/auth-domain": "2.145.0",
+    "@smartsoft001/crud-domain": "2.145.0",
+    "@smartsoft001/crud-shell-dtos": "2.145.0",
+    "@smartsoft001/auth-shell-dtos": "2.145.0",
+    "@smartsoft001/crud-shell-app-services": "2.145.0",
+    "@smartsoft001/auth-shell-app-services": "2.145.0"
   }
 }

package/src/migrations/use-stack-packages/README.md

@@ -0,0 +1,52 @@
+# use-stack-packages
+
+Since 2.143.0 the framework publishes four meta packages that pin a set of libraries at one
+version: `@smartsoft001/core`, `@smartsoft001/angular-stack`, `@smartsoft001/nestjs-stack` and
+`@smartsoft001/payments-stack`. This migration rewrites your `package.json` so a project that
+already installs a whole set installs the set instead of listing its parts.
+
+## What it changes
+
+In `dependencies` and in `devDependencies`, whenever a section lists **two or more** packages that
+one stack pins, those entries are replaced by a single entry for the stack:
+
+```diff
+ "dependencies": {
+-  "@smartsoft001/angular": "2.143.0",
+-  "@smartsoft001/crud-shell-angular": "2.143.0"
++  "@smartsoft001/angular-stack": "2.143.0"
+ }
+```
+
+Details worth knowing:
+
+- The stack takes the version the replaced entries carried. They are normally in lockstep. When
+  they are not, the highest version wins and the log line says so.
+- `@smartsoft001/core` is resolved first, and is itself part of the Angular and the NestJS stack.
+  A project with the full core set plus `@smartsoft001/angular` ends up with `angular-stack` alone,
+  because that stack already pins `core`.
+- An entry for a stack you already install is folded into the result rather than duplicated.
+- The new entry keeps the position and the section of the first entry it replaces. If the section
+  was sorted alphabetically it stays sorted.
+- Every replacement is logged, and one final line names the packages that stayed individually
+  installed.
+
+## What it deliberately does not change
+
+- **A single member of a stack.** Installing one library on purpose is a legitimate choice, so one
+  entry is never turned into a stack that would pull in the rest.
+- **Packages no stack pins**: `@smartsoft001/fb`, `@smartsoft001/google` and
+  `@smartsoft001/claude-plugins` are left exactly as they are.
+- **Members split across sections.** Each section is counted on its own, so one member in
+  `dependencies` and one in `devDependencies` is two lonely entries, not a stack.
+- **Anything outside `package.json`.** Imports keep working because the stacks re-export nothing and
+  hide nothing: every library stays installed, just by way of the stack. Your lockfile is not
+  touched, so run your package manager's install afterwards.
+
+Running the migration a second time changes nothing.
+
+## How to undo it
+
+The change is confined to `package.json`, so `git checkout -- package.json` before you install is
+enough. If you have already installed, put the individual entries back at the version the stack
+carried and install again. The stacks add no code of their own, so nothing else needs reverting.

package/src/migrations/use-stack-packages/use-stack-packages.d.ts

@@ -0,0 +1,2 @@
+import { Tree } from '@nx/devkit';
+export default function update(tree: Tree): Promise<void>;

package/src/migrations/use-stack-packages/use-stack-packages.js

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = update;
+const devkit_1 = require("@nx/devkit");
+/**
+ * The meta packages and the packages each of them pins.
+ *
+ * This mirrors the `dependencies` block of every `package.json` under
+ * `packages/meta` and has to be kept in step with them by hand: a consumer's
+ * `node_modules` is not guaranteed to contain the meta packages, so the
+ * migration cannot read the lists at runtime.
+ *
+ * `@smartsoft001/core` comes first, and is itself a member of the Angular and
+ * the NestJS stack, so a project that pulls in the whole core set collapses to
+ * `core` and from there into the framework stack.
+ */
+const STACKS = {
+    '@smartsoft001/core': [
+        '@smartsoft001/models',
+        '@smartsoft001/domain-core',
+        '@smartsoft001/utils',
+        '@smartsoft001/users',
+        '@smartsoft001/auth-domain',
+        '@smartsoft001/crud-domain',
+        '@smartsoft001/crud-shell-dtos',
+        '@smartsoft001/auth-shell-dtos',
+        '@smartsoft001/crud-shell-app-services',
+        '@smartsoft001/auth-shell-app-services',
+    ],
+    '@smartsoft001/angular-stack': [
+        '@smartsoft001/core',
+        '@smartsoft001/angular',
+        '@smartsoft001/crud-shell-angular',
+    ],
+    '@smartsoft001/nestjs-stack': [
+        '@smartsoft001/core',
+        '@smartsoft001/nestjs',
+        '@smartsoft001/mongo',
+        '@smartsoft001/crud-shell-nestjs',
+        '@smartsoft001/auth-shell-nestjs',
+    ],
+    '@smartsoft001/payments-stack': [
+        '@smartsoft001/trans-domain',
+        '@smartsoft001/trans-shell-app-services',
+        '@smartsoft001/trans-shell-nestjs',
+        '@smartsoft001/paypal',
+        '@smartsoft001/payu',
+        '@smartsoft001/paynow',
+        '@smartsoft001/revolut',
+    ],
+};
+/** Every package a stack pins, the stacks themselves excluded. */
+const MEMBERS = new Set(Object.values(STACKS)
+    .flat()
+    .filter((name) => !(name in STACKS)));
+const SECTIONS = ['dependencies', 'devDependencies'];
+/** Compares the numbers in two npm specifiers, so `^2.143.0` beats `2.140.0`. */
+function compareVersions(a, b) {
+    const numbers = (value) => (value.match(/\d+/g) ?? []).map(Number);
+    const left = numbers(a);
+    const right = numbers(b);
+    for (let index = 0; index < Math.max(left.length, right.length); index++) {
+        const difference = (left[index] ?? 0) - (right[index] ?? 0);
+        if (difference !== 0) {
+            return difference;
+        }
+    }
+    return 0;
+}
+function highestVersion(versions) {
+    return versions.reduce((highest, version) => compareVersions(version, highest) > 0 ? version : highest);
+}
+function isSorted(names) {
+    return names.every((name, index) => index === 0 || names[index - 1] <= name);
+}
+/**
+ * Replaces every group of two or more members of one stack with the stack,
+ * in the position of the first entry it replaces.
+ */
+function collapse(deps) {
+    const keepSorted = isSorted(Object.keys(deps));
+    const replacements = [];
+    let entries = Object.entries(deps);
+    for (const [stack, members] of Object.entries(STACKS)) {
+        const present = entries.filter(([name]) => members.includes(name));
+        if (present.length < 2) {
+            continue;
+        }
+        // An entry for the stack itself is folded in rather than left duplicated.
+        const replaces = ([name]) => members.includes(name) || name === stack;
+        const versions = entries.filter(replaces).map(([, version]) => version);
+        const version = highestVersion(versions);
+        replacements.push({
+            stack,
+            version,
+            versions,
+            replaced: present.map(([name]) => name),
+        });
+        const next = [];
+        for (const entry of entries) {
+            if (!replaces(entry)) {
+                next.push(entry);
+            }
+            else if (next.every(([name]) => name !== stack)) {
+                next.push([stack, version]);
+            }
+        }
+        entries = next;
+    }
+    if (keepSorted) {
+        entries.sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
+    }
+    return { deps: Object.fromEntries(entries), replacements };
+}
+function describeReplacement(section, replacement) {
+    const { stack, version, versions, replaced } = replacement;
+    const disagreed = versions.some((other) => other !== versions[0])
+        ? `, versions differed (${versions.join(', ')}), kept the highest`
+        : '';
+    return `${section}: ${replaced.join(', ')} -> ${stack}@${version}${disagreed}`;
+}
+async function update(tree) {
+    const leftovers = [];
+    (0, devkit_1.updateJson)(tree, 'package.json', (json) => {
+        for (const section of SECTIONS) {
+            const current = json[section];
+            if (!current) {
+                continue;
+            }
+            const { deps, replacements } = collapse(current);
+            json[section] = deps;
+            for (const replacement of replacements) {
+                devkit_1.logger.info(describeReplacement(section, replacement));
+            }
+            for (const name of Object.keys(deps)) {
+                if (MEMBERS.has(name) && !leftovers.includes(name)) {
+                    leftovers.push(name);
+                }
+            }
+        }
+        return json;
+    });
+    if (leftovers.length > 0) {
+        devkit_1.logger.info(`Still installed individually: ${leftovers.join(', ')}`);
+    }
+}
+//# sourceMappingURL=use-stack-packages.js.map

package/src/migrations/use-stack-packages/use-stack-packages.js.map

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