@aventara/build 1.0.0-rc.4 → 1.0.0-rc.8

package/CHANGELOG.md

@@ -1,5 +1,52 @@
 # @aventara/build
 
+## 1.0.0-rc.8
+
+1.0.0-rc.5, rc.6 and rc.7 were tagged but never published; 1.0.0-rc.8 contains everything listed under them and the changes below.
+
+### Patch Changes
+
+- 1c8e4ee: `aventara-build --check` says what changed when the prebuilt Contracts file is stale, in the same words as the
+  `AVENTARA_PREBUILT_STALE` warning at startup. Before, anything outside a single Resource read "an input that belongs
+  to no single Resource, the core version or the file format changed". Now it names the versions or the inputs:
+
+  ```text
+  aventara-build: src/generated/aventara/contracts.generated.ts is stale: it was built by @aventara/core 1.0.0-rc.7, and this is 1.0.0-rc.8. Run aventara-build (npm run aventara:prepare) and deploy the file it writes.
+  aventara-build: src/generated/aventara/contracts.generated.ts is stale: Resource User changed and the configuration or model outside the Resources changed since it was written. Run aventara-build (npm run aventara:prepare) and deploy the file it writes.
+  ```
+
+  It also names a file format or protocol version that differs, the Resources that are new or gone, and a file that
+  no longer reads as a prebuilt Contracts file.
+
+- Updated dependencies [1c8e4ee]
+  - @aventara/core@1.0.0-rc.8
+
+## 1.0.0-rc.7
+
+1.0.0-rc.5 and 1.0.0-rc.6 were tagged but never published; 1.0.0-rc.7 contains everything listed under them and the changes below.
+
+### Patch Changes
+
+- Updated dependencies [f917c1c]
+  - @aventara/core@1.0.0-rc.7
+
+## 1.0.0-rc.6
+
+1.0.0-rc.5 was tagged but never published. 1.0.0-rc.6 contains everything listed under 1.0.0-rc.5 and the fix below.
+
+### Patch Changes
+
+- Updated dependencies [1cf72e0]
+  - @aventara/core@1.0.0-rc.6
+
+## 1.0.0-rc.5
+
+### Patch Changes
+
+- Updated dependencies [4795ff1]
+- Updated dependencies [9e178ca]
+  - @aventara/core@1.0.0-rc.5
+
 ## 1.0.0-rc.4
 
 ### Patch Changes

package/dist/cli.js

@@ -54,11 +54,6 @@ function parse(argv) {
     }
     return { check };
 }
-function listed(names) {
-    return names.length < 2
-        ? names.join("")
-        : `${names.slice(0, -1).join(", ")} and ${names.at(-1)}`;
-}
 function counted(count) {
     return `${count} Resource${count === 1 ? "" : "s"}`;
 }
@@ -137,7 +132,7 @@ export async function runBuild(argv, projectDirectory, output) {
             output.stdout(wrote(writeContractsFile(projectDirectory, generated.contracts, compiled), generated.contracts, counted(resources)));
             return 0;
         }
-        const contracts = await checkContractsFile(projectDirectory, generated.contracts, compiled);
+        const contracts = await checkContractsFile(projectDirectory, generated.contracts, compiled, project.internal.prebuiltFileChanges);
         if (contracts.kind === "fresh") {
             output.stdout(`aventara-build: ${generated.resources}, ${generated.computedFields} and ${generated.contracts} are up to date.`);
             return 0;
@@ -147,18 +142,7 @@ export async function runBuild(argv, projectDirectory, output) {
             deploy: true,
             what: contracts.kind === "missing"
                 ? "is missing"
-                : `is stale: ${[
-                    ...(contracts.resources.length === 0
-                        ? []
-                        : [
-                            `the inputs of ${listed(contracts.resources)} changed since it was written`,
-                        ]),
-                    ...(contracts.shared
-                        ? [
-                            "an input that belongs to no single Resource, the core version or the file format changed",
-                        ]
-                        : []),
-                ].join("; ")}`,
+                : `is stale: ${contracts.changes.join("; ")}`,
         }));
         return 1;
     }

package/dist/contracts/contracts-file.js

@@ -5,7 +5,7 @@ import { readGeneratedFile, writeGeneratedFile, } from "../project/generated-fil
 export function writeContractsFile(projectDirectory, contractsFile, compiled) {
     return writeGeneratedFile(projectDirectory, contractsFile, compiled.source);
 }
-export async function checkContractsFile(projectDirectory, contractsFile, compiled) {
+export async function checkContractsFile(projectDirectory, contractsFile, compiled, changesOf) {
     const file = path.join(projectDirectory, contractsFile);
     const text = readGeneratedFile(projectDirectory, contractsFile);
     if (text === undefined) {
@@ -15,9 +15,21 @@ export async function checkContractsFile(projectDirectory, contractsFile, compil
         return { kind: "fresh" };
     }
     const previous = await previousContracts(projectDirectory, file);
-    return previous === undefined
-        ? { kind: "stale", resources: [], shared: true }
-        : difference(previous, compiled.prebuilt);
+    if (previous === undefined) {
+        return {
+            kind: "stale",
+            changes: ["it could not be read as a prebuilt Contracts file"],
+        };
+    }
+    const changes = changesOf(previous, compiled.prebuilt);
+    return {
+        kind: "stale",
+        changes: changes.length > 0
+            ? changes
+            : [
+                "its text is not what this build writes, though it records the same core version, file format and inputs",
+            ],
+    };
 }
 async function previousContracts(projectDirectory, file) {
     const jiti = createJiti(pathToFileURL(path.join(projectDirectory, "package.json")).href, { moduleCache: false, fsCache: false, interopDefault: false });
@@ -31,21 +43,3 @@ async function previousContracts(projectDirectory, file) {
         return undefined;
     }
 }
-function difference(previous, current) {
-    const before = previous.fingerprints.resources;
-    const after = current.fingerprints.resources;
-    const resources = [
-        ...new Set([...Object.keys(before), ...Object.keys(after)]),
-    ]
-        .filter((name) => before[name] !== after[name])
-        .sort();
-    const shared = previous.fingerprints.shared !== current.fingerprints.shared ||
-        previous.core !== current.core ||
-        previous.protocol !== current.protocol ||
-        previous.format !== current.format;
-    return {
-        kind: "stale",
-        resources,
-        shared: shared || resources.length === 0,
-    };
-}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aventara/build",
-  "version": "1.0.0-rc.4",
+  "version": "1.0.0-rc.8",
   "license": "SEE LICENSE IN LICENSE",
   "description": "Compiles an Aventara application's Contracts at build time, for serverless and edge cold starts.",
   "type": "module",
@@ -19,14 +19,14 @@
     "jiti": "2.7.0"
   },
   "peerDependencies": {
-    "@aventara/core": "1.0.0-rc.4",
+    "@aventara/core": "1.0.0-rc.8",
     "typescript": ">=5.7.0 <7"
   },
   "publishConfig": {
     "access": "public"
   },
   "devDependencies": {
-    "@aventara/core": "1.0.0-rc.4",
+    "@aventara/core": "1.0.0-rc.8",
     "@types/node": "24.10.1",
     "typescript": "^5.9.2"
   },