alchemy 0.75.0 → 0.76.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "alchemy",
-  "version": "0.75.0",
+  "version": "0.76.0",
   "license": "Apache-2.0",
   "author": "Sam Goodwin <sam@alchemy.run>",
   "homepage": "https://alchemy.run",

package/src/alchemy.ts

@@ -5,14 +5,14 @@ import { isReplacedSignal } from "./apply.ts";
 import { DestroyStrategy, destroy, isDestroyedSignal } from "./destroy.ts";
 import { env } from "./env.ts";
 import {
+  type PendingResource,
   ResourceFQN,
   ResourceID,
   ResourceKind,
   ResourceScope,
   ResourceSeq,
-  type PendingResource,
 } from "./resource.ts";
-import { DEFAULT_STAGE, Scope, type ProviderCredentials } from "./scope.ts";
+import { DEFAULT_STAGE, type ProviderCredentials, Scope } from "./scope.ts";
 import { secret } from "./secret.ts";
 import type { StateStoreType } from "./state.ts";
 import { cliArgs, parseOption } from "./util/cli-args.ts";
@@ -125,6 +125,7 @@ async function _alchemy(
           : cliArgs.includes("--read")
             ? "read"
             : "up",
+
     local: cliArgs.includes("--local") || cliArgs.includes("--dev"),
     watch: cliArgs.includes("--watch") || execArgv.includes("--watch"),
     quiet: cliArgs.includes("--quiet"),
@@ -151,7 +152,7 @@ async function _alchemy(
     process.env.CI &&
     process.env.ALCHEMY_CI_STATE_STORE_CHECK !== "false"
   ) {
-    throw new Error(`You are running Alchemy in a CI environment with the default local state store. 
+    throw new Error(`You are running Alchemy in a CI environment with the default local state store.
 This can lead to orphaned infrastructure and is rarely what you want to do.
 
 Instead, you should choose a persistent state store:

package/src/apply.ts

@@ -97,6 +97,7 @@ async function _apply<Out extends ResourceAttributes>(
 
       // -> poll until it does not (i.e. when the owner process applies the change and updates the state store)
       async function waitForConsistentState() {
+        let startTime = Date.now();
         while (true) {
           if (state === undefined) {
             // state doesn't exist yet
@@ -115,6 +116,18 @@ async function _apply<Out extends ResourceAttributes>(
           } else if (await inputsAreEqual(state)) {
             // sweet, we've reached a stable state and read can progress
             return state;
+          } else {
+            const elapsed = Date.now() - startTime;
+            if (
+              // looks stable but the props are different on our side, it's likely that the input props are not deterministic
+              (state.status === "created" || state.status === "updated") &&
+              elapsed > 1_000
+            ) {
+              logger.warn(
+                `Resource '${resource[ResourceFQN]}' is not in a stable state after ${elapsed}ms, be sure to check if your input props are deterministic:`,
+                state.props,
+              );
+            }
           }
           // jitter between 100-300ms
           const jitter = 100 + Math.random() * 200;
@@ -332,7 +345,9 @@ async function _apply<Out extends ResourceAttributes>(
           phase === "create" ? "created" : isReplaced ? "replaced" : "updated",
         prefixColor: "greenBright",
         resource: formatFQN(resource[ResourceFQN]),
-        message: `${phase === "create" ? "Created" : isReplaced ? "Replaced" : "Updated"} Resource`,
+        message: `${
+          phase === "create" ? "Created" : isReplaced ? "Replaced" : "Updated"
+        } Resource`,
         status: "success",
       });
     }