fix(projects): keep the disabled-flag 503 that realtime treats as transient

Author: waleedlatif1

apps/sim/app/api/projects/route.test.ts

@@ -1,6 +1,7 @@
 'use client'
 
 import { Checkbox, Chip, Info, OverflowText } from '@sim/emcn'
+import { isApiClientError } from '@/lib/api/client/errors'
 import { SettingsSection } from '@/app/workspace/[workspaceId]/settings/components/settings-section/settings-section'
 import { useProjects } from '@/hooks/queries/projects'
 
@@ -20,7 +21,13 @@ export function ProjectIssueRestrictions({
   onChange,
 }: ProjectIssueRestrictionsProps) {
   const projects = useProjects(organizationId)
-  if (!projects.isEnabled || projects.isPending) return null
+  if (
+    !projects.isEnabled ||
+    projects.isPending ||
+    (isApiClientError(projects.error) && projects.error.status === 503)
+  ) {
+    return null
+  }
   const choices = projects.data?.pages.flatMap((page) => page.projects) ?? []
   if (!projects.error && choices.length === 0) return null
   const selected = new Set(value)

apps/sim/ee/access-control/components/project-issue-restrictions.tsx

@@ -29,7 +29,7 @@ export function useProjects(organizationId: string) {
       (!isApiClientError(error) ||
         error.status === 408 ||
         error.status === 429 ||
-        error.status >= 500),
+        (error.status >= 500 && error.status !== 503)),
     enabled: projectsEnabled && Boolean(organizationId),
   })
 }

apps/sim/hooks/queries/projects.ts

@@ -2,7 +2,7 @@
 
 A Project groups environments. An environment is an existing `workspace` record; there is no separate environment table. Every newly created Project starts with an environment.
 
-Project APIs return HTTP 403 until the `projects` feature flag is on (AppConfig on hosted deployments; the `PROJECTS` secret elsewhere). The flag defaults off and gates Project and Project-file APIs through `requireProjectApiEnabled()`: workspace creation always assigns a Project atomically, and assigned Projects keep their lifecycle protections (fork inheritance, disconnect) either way. Disabling the flag does not disable retention or cleanup of existing Project data.
+Project APIs return HTTP 503 until the `projects` feature flag is on (AppConfig on hosted deployments; the `PROJECTS` secret elsewhere). The flag defaults off and gates Project and Project-file APIs through `requireProjectApiEnabled()`: workspace creation always assigns a Project atomically, and assigned Projects keep their lifecycle protections (fork inheritance, disconnect) either way. Disabling the flag does not disable retention or cleanup of existing Project data.
 
 ## Storage and consistency
 

apps/sim/lib/projects/README.md

@@ -459,7 +459,7 @@ describe('Project foundation at the database and application boundary', () => {
         () => archiveProject.execute({ principal: f.owner, input, request }),
         () => getProjectIssueAccess.execute({ principal: f.owner, input, request }),
       ]
-      for (const call of calls) await expect(call()).rejects.toMatchObject({ code: 'forbidden' })
+      for (const call of calls) await expect(call()).rejects.toMatchObject({ statusCode: 503 })
       expect(
         await db.select().from(workspace).where(eq(workspace.ownerId, f.ownerId))
       ).toHaveLength(1)

apps/sim/lib/projects/__integration__/foundation.integration.ts

@@ -1,13 +1,18 @@
 import { isFeatureEnabled } from '@/lib/core/config/feature-flags'
-import { OrchestrationError } from '@/lib/core/orchestration/types'
+import { HttpError } from '@/lib/core/utils/http-error'
+
+class ProjectUnavailableError extends HttpError {
+  readonly statusCode = 503
+  constructor() {
+    super('Projects are not enabled on this deployment')
+  }
+}
 
 /** Project rollout is a global switch; it never varies by organization or user. */
 export function isProjectsEnabled(): Promise<boolean> {
   return isFeatureEnabled('projects')
 }
 
 export async function requireProjectApiEnabled(): Promise<void> {
-  if (!(await isProjectsEnabled())) {
-    throw new OrchestrationError('forbidden', 'Projects are not enabled')
-  }
+  if (!(await isProjectsEnabled())) throw new ProjectUnavailableError()
 }