chore: import upstream snapshot with attribution

2026-07-13 13:32:57 +08:00
commit cd420f9332
4811 changed files with 884702 additions and 0 deletions
@@ -0,0 +1,44 @@
+import { EnvironmentPauseSource } from "@trigger.dev/database";
+import type { PauseStatus } from "~/v3/services/pauseEnvironment.server";
+
+/**
+ * Guards manual pause/resume API calls while an environment is billing-paused.
+ *
+ * Design trade-off: billing-limit converge unpauses every environment with
+ * `pauseSource=BILLING_LIMIT` on resolve. We therefore do not record a
+ * separate manual pause on top of billing enforcement — a manual pause attempt
+ * while already billing-paused is a silent no-op (`success: true`, still
+ * paused). If the limit is later resolved, that environment is unpaused with
+ * the rest, even if the caller intended to keep it paused.
+ *
+ * The queues UI hides pause/resume while `pauseSource=BILLING_LIMIT`; API
+ * callers can still hit this path and should treat the no-op as idempotent.
+ */
+export function getManualPauseEnvironmentResult(
+  action: PauseStatus,
+  pauseSource: EnvironmentPauseSource | null | undefined
+):
+  | { proceed: true }
+  | { proceed: false; success: true; state: PauseStatus }
+  | { proceed: false; success: false; error: string } {
+  if (action === "resumed" && pauseSource === EnvironmentPauseSource.BILLING_LIMIT) {
+    return {
+      proceed: false,
+      success: false,
+      error:
+        "This environment is paused because your organization reached its billing limit. Resolve the limit on the billing limits settings page to resume.",
+    };
+  }
+
+  if (action === "paused" && pauseSource === EnvironmentPauseSource.BILLING_LIMIT) {
+    // Already billing-paused; do not overwrite pauseSource so resolve converge
+    // can still find and unpause this environment.
+    return {
+      proceed: false,
+      success: true,
+      state: "paused",
+    };
+  }
+
+  return { proceed: true };
+}