From bec81107dfd06d4cde4d53b5e8620b6a5f71a20d Mon Sep 17 00:00:00 2001
From: Kevin Powell Noumbissie <10553243+KepoParis@users.noreply.github.com>
Date: Thu, 14 May 2026 00:02:00 +0200
Subject: [PATCH] feat: add deployment UI

---
 apps/client/src/components/DeploymentCard.vue |  46 ++++++
 .../client/src/components/DeploymentModal.vue | 135 ++++++++++++++++++
 .../src/components/DeploymentRepoOption.vue   |  65 +++++++++
 .../src/components/DeploymentRepoSelect.vue   |  60 ++++++++
 .../src/components/DeploymentResources.vue    |  78 ++++++++++
 .../src/components/ProjectResources.vue       |   9 +-
 apps/client/src/main.css                      |   5 +
 apps/client/src/utils/project-utils.ts        |  40 ++++++
 packages/shared/src/api-client.ts             |   1 +
 packages/shared/src/contracts/deployment.ts   |  91 ++++++++++++
 packages/shared/src/contracts/index.ts        |   1 +
 11 files changed, 528 insertions(+), 3 deletions(-)
 create mode 100644 apps/client/src/components/DeploymentCard.vue
 create mode 100644 apps/client/src/components/DeploymentModal.vue
 create mode 100644 apps/client/src/components/DeploymentRepoOption.vue
 create mode 100644 apps/client/src/components/DeploymentRepoSelect.vue
 create mode 100644 apps/client/src/components/DeploymentResources.vue
 create mode 100644 packages/shared/src/contracts/deployment.ts

diff --git a/apps/client/src/components/DeploymentCard.vue b/apps/client/src/components/DeploymentCard.vue
new file mode 100644
index 0000000000..3ca94c66b1
--- /dev/null
+++ b/apps/client/src/components/DeploymentCard.vue
@@ -0,0 +1,46 @@
+<script lang="ts" setup>
+import type { Deployment, Stage } from '@cpn-console/shared'
+
+defineProps<{ deployment: Deployment & { stage?: Stage } }>()
+</script>
+
+<template>
+  <div class="fr-card fr-enlarge-link cursor-pointer w-1/4">
+    <div class="fr-card__body">
+      <div class="fr-card__content fr-px-4v fr-pb-4v fr-pt-5v">
+        <p class="font-bold">
+          {{ deployment.name }}
+        </p>
+        <DsfrBadge
+          class="fr-mb-0"
+          :label="`${deployment.environment.name}${deployment.stage?.name ? ` • ${deployment.stage.name}` : ''}`"
+          no-icon
+          small
+          type="info"
+        />
+        <p class="fr-text--sm fr-text-mention--grey uppercase font-bold fr-my-4v">
+          {{ deployment.deploymentSources.length }}
+          <template v-if="deployment.deploymentSources.length > 1">
+            dépôts
+          </template>
+          <template v-else>
+            dépôt
+          </template>
+        </p>
+        <div class="flex flex-wrap items-start gap-2">
+          <div
+            v-for="source in deployment.deploymentSources"
+            :key="source.id"
+            class="px-2 py-1 shadow fr-background-alt--grey flex items-center gap-2 fr-text--sm"
+          >
+            <v-icon name="mdi:git" />
+            {{ source.repository.internalRepoName }}
+            <span class="text-xs fr-m-0 fr-text-mention--grey font-mono leading-none">
+              {{ source.targetRevision || 'HEAD' }}
+            </span>
+          </div>
+        </div>
+      </div>
+    </div>
+  </div>
+</template>
diff --git a/apps/client/src/components/DeploymentModal.vue b/apps/client/src/components/DeploymentModal.vue
new file mode 100644
index 0000000000..01dbf841b0
--- /dev/null
+++ b/apps/client/src/components/DeploymentModal.vue
@@ -0,0 +1,135 @@
+<script lang="ts" setup>
+import type { Cluster, Deployment, Environment, Stage, UpdateDeployment, Zone } from '@cpn-console/shared'
+import type { DsfrRadioButtonProps } from '@gouvminint/vue-dsfr'
+import type { Project } from '@/utils/project-utils.js'
+import { CreateDeploymentSchema, DeploymentSchema } from '@cpn-console/shared'
+import { useSnackbarStore } from '@/stores/snackbar.js'
+
+const props = withDefaults(defineProps<{
+  opened: boolean
+  environments: (Environment & { cluster?: Cluster, zone?: Zone, stage?: Stage })[]
+  repoOptions: { text: string, value: string }[]
+  deployment?: Deployment
+  project: Project
+}>(), { opened: false })
+
+const emit = defineEmits<{ close: [] }>()
+
+const snackbarStore = useSnackbarStore()
+
+const { opened } = toRefs(props)
+
+const options: ComputedRef<Omit<DsfrRadioButtonProps, 'modelValue'>[]> = computed(
+  () => props.environments.map(env => ({
+    hint: env.stage?.name,
+    label: env.name,
+    value: env.id,
+    class: 'fr-p-0',
+  })),
+)
+
+const deployment = ref<Partial<UpdateDeployment & { id: string }>>(
+  props.deployment ? { ...props.deployment } : { projectId: props.project.id, autosync: true },
+)
+
+watch(() => props.deployment, (newValue) => {
+  deployment.value = newValue ? { ...newValue } : { projectId: props.project.id, autosync: true }
+}, { deep: true })
+
+const deploymentSourcesModel = computed({
+  get: () => deployment.value?.deploymentSources ?? [],
+  set: (value: UpdateDeployment['deploymentSources']) =>
+    deployment.value = { ...deployment.value, deploymentSources: value },
+})
+
+const isLoading = ref(false)
+
+function upsertDeployment() {
+  if (isLoading.value) return
+
+  const body = CreateDeploymentSchema.safeParse(deployment.value)
+  if (!body.success) {
+    snackbarStore.setMessage(body.error.message, 'error')
+    return
+  }
+
+  isLoading.value = true
+  if (deployment.value.id) {
+    props.project.Deployments.update(deployment.value.id, body.data)
+      .then(closeModal)
+      .catch(reason => snackbarStore.setMessage(reason, 'error'))
+      .finally(() => isLoading.value = false)
+  } else {
+    props.project.Deployments.create(body.data)
+      .then(closeModal)
+      .catch(reason => snackbarStore.setMessage(reason, 'error'))
+      .finally(() => isLoading.value = false)
+  }
+}
+
+function closeModal() {
+  deployment.value = { projectId: props.project.id, autosync: true }
+  emit('close')
+}
+</script>
+
+<template>
+  <DsfrModal title="" :opened is-alert @close="closeModal">
+    <div class="w-full">
+      <h4>
+        <template v-if="deployment.id">
+          Modifier le déploiement
+        </template>
+        <template v-else>
+          Ajouter un déploiement au projet
+        </template>
+      </h4>
+
+      <div class="w-full">
+        <DsfrInputGroup
+          v-model="deployment.name"
+          label="Nom du déploiement"
+          class="fr-mb-2v"
+          label-visible
+          :required="true"
+          :error-message="!!deployment.name && !DeploymentSchema.pick({ name: true }).safeParse({ name: deployment.name }).success ? `Le nom du déploiement ne doit pas contenir d\'espace, doit être unique pour le projet et le cluster sélectionnés, être en minuscules.` : undefined"
+          placeholder="deploy0"
+        />
+      </div>
+
+      <h6 class="fr-mb-0">
+        Environnement cible
+      </h6>
+      <p class="fr-text--sm fr-text-mention--grey fr-mb-0">
+        Un déploiement est lié à exactement 1 environnement
+      </p>
+      <DsfrRadioButtonSet
+        v-model="deployment.environmentId"
+        :options="options"
+        :rich="true"
+        :required="true"
+      />
+
+      <h6 class="fr-mb-0">
+        Dépôts à inclure
+      </h6>
+      <DeploymentRepoSelect v-model="deploymentSourcesModel" :repo-options="repoOptions" />
+    </div>
+    <div class="w-full flex justify-end gap-4">
+      <DsfrButton
+        label="Enregistrer"
+        primary
+        size="md"
+        :icon="isLoading ? { name: 'ri:loader-4-line', animation: 'spin' } : undefined"
+        :icon-right="isLoading"
+        @click="upsertDeployment"
+      />
+      <DsfrButton
+        label="Annuler"
+        secondary
+        size="md"
+        @click="closeModal"
+      />
+    </div>
+  </DsfrModal>
+</template>
diff --git a/apps/client/src/components/DeploymentRepoOption.vue b/apps/client/src/components/DeploymentRepoOption.vue
new file mode 100644
index 0000000000..8cf4e656ca
--- /dev/null
+++ b/apps/client/src/components/DeploymentRepoOption.vue
@@ -0,0 +1,65 @@
+<script setup lang="ts">
+import type { UpdateDeployment } from '@cpn-console/shared'
+
+withDefaults(defineProps<{
+  cantDelete: boolean
+  options: { text: string, value: string }[]
+}>(), {
+  options: () => [],
+  cantDelete: false,
+})
+defineEmits<{ delete: [] }>()
+
+const model = defineModel<Partial<UpdateDeployment['deploymentSources'][0]>>(
+  {
+    default: {
+      id: undefined,
+      type: 'git',
+      repositoryId: undefined,
+      targetRevision: undefined,
+      path: undefined,
+      helmValuesFiles: undefined,
+    },
+  },
+)
+</script>
+
+<template>
+  <div class="w-full">
+    <div v-if="!$props.cantDelete" class="flex w-full justify-end">
+      <DsfrButton icon-only icon="ri:delete-bin-7-line" secondary @click="$emit('delete')" />
+    </div>
+    <DsfrSelect v-model="model.repositoryId" label="Dépôt" :options="$props.options" />
+    <DsfrInputGroup
+      v-model="model.targetRevision"
+      class="mb-2"
+      placeholder="HEAD"
+      label="Nom de la révision à déployer (branche, tag, commit)"
+      label-visible
+    />
+    <DsfrInputGroup
+      v-model="model.path"
+      class="mb-2"
+      placeholder="manifest/"
+      label="Chemin du répertoire à déployer"
+      label-visible
+    />
+    <DsfrInputGroup
+      v-model="model.helmValuesFiles"
+      class="mb-2"
+      is-textarea
+      label="Fichiers values (Helm)"
+      label-visible
+      hint="Un fichier par ligne, chemin relatif par rapport au répertoire à déployer. La balise <env> sera remplacée par le nom de l'environnement. L'ordre des fichiers est déterminant pour la surcharge des valeurs communes. Champ optionnel."
+      placeholder="values/extra.yaml
+values-<env>/custom.yaml"
+    />
+  </div>
+</template>
+
+<style lang="css" scoped>
+.fr-select-group,
+.fr-input-group {
+  margin-bottom: .75rem;
+}
+</style>
diff --git a/apps/client/src/components/DeploymentRepoSelect.vue b/apps/client/src/components/DeploymentRepoSelect.vue
new file mode 100644
index 0000000000..e44d933b34
--- /dev/null
+++ b/apps/client/src/components/DeploymentRepoSelect.vue
@@ -0,0 +1,60 @@
+<script lang="ts" setup>
+import type { UpdateDeployment } from '@cpn-console/shared'
+
+defineProps<{
+  repoOptions: { text: string, value: string }[]
+}>()
+const depots = defineModel<Partial<UpdateDeployment['deploymentSources'][0]>[]>({ default: [] })
+
+if (depots.value.length === 0) {
+  addDepot()
+}
+
+function addDepot() {
+  depots.value = [
+    ...depots.value,
+    {
+      id: undefined,
+      type: 'git',
+      repositoryId: undefined,
+      targetRevision: undefined,
+      path: undefined,
+      helmValuesFiles: undefined,
+    },
+  ]
+}
+
+function removeDepot(index: number) {
+  depots.value = depots.value.filter((_, i) => i !== index)
+}
+
+function updateDepot(index: number, value: Partial<UpdateDeployment['deploymentSources'][0]>) {
+  depots.value[index] = value
+}
+</script>
+
+<template>
+  <div class="p-2">
+    <div class="w-full flex flex-col gap-2">
+      <DeploymentRepoOption
+        v-for="(depot, index) in depots"
+        :key="depot.id ?? `new-${index}`"
+        :model-value="depot"
+        :options="$props.repoOptions"
+        class="w-full py-2 px-4 border border-solid border-gray-300"
+        :cant-delete="index === 0"
+        @update:model-value="value => updateDepot(index, value)"
+        @delete="removeDepot(index)"
+      />
+    </div>
+    <div class="w-full flex mt-4">
+      <DsfrButton
+        type="button"
+        label="Ajouter un dépôt"
+        icon="ri:add-line"
+        secondary
+        @click="addDepot"
+      />
+    </div>
+  </div>
+</template>
diff --git a/apps/client/src/components/DeploymentResources.vue b/apps/client/src/components/DeploymentResources.vue
new file mode 100644
index 0000000000..4a165305fc
--- /dev/null
+++ b/apps/client/src/components/DeploymentResources.vue
@@ -0,0 +1,78 @@
+<script setup lang="ts">
+import type { Cluster, Deployment, Environment, Repo, Stage, Zone } from '@cpn-console/shared'
+import type { Project } from '@/utils/project-utils.js'
+
+const props = defineProps<{
+  environments: (Environment & { cluster?: Cluster, zone?: Zone, stage?: Stage })[]
+  repositories: (Repo & { source: string })[]
+  project: Project
+}>()
+const deployments = ref<Deployment[]>([])
+const repoOptions = computed(() => props.repositories.map(repo => ({
+  text: repo.internalRepoName,
+  value: repo.id,
+})))
+
+const deploymentsWithStage = computed(() => deployments.value.map((deployment) => {
+  const stage = props.environments.find(env => env.id === deployment.environmentId)?.stage
+  return {
+    ...deployment,
+    stage,
+  }
+}))
+
+const isModalOpen = ref(false)
+const selectedDeployment = ref<Deployment>()
+
+function openModal(deployment?: Deployment) {
+  selectedDeployment.value = deployment
+  isModalOpen.value = true
+}
+
+function closeModal() {
+  loadDeployments()
+  isModalOpen.value = false
+}
+
+async function loadDeployments() {
+  deployments.value = await props.project.Deployments.list()
+}
+
+onMounted(loadDeployments)
+</script>
+
+<template>
+  <div class="w-full">
+    <div class="w-full flex justify-between items-start">
+      <div>
+        <h4 class="fr-mb-0">
+          Déploiements
+        </h4>
+        <p>Associez un environnement à un ou plusieurs dépôts pour configurer un déploiment.</p>
+      </div>
+      <DsfrButton
+        label="Ajouter un nouveau déploiement"
+        tertiary
+        title="Ajouter un déploiement"
+        icon="ri:add-line"
+        @click="() => openModal()"
+      />
+    </div>
+    <div class="w-full flex items-start gap-4">
+      <DeploymentCard
+        v-for="deployment in deploymentsWithStage"
+        :key="deployment.id"
+        :deployment="deployment"
+        @click="() => openModal(deployment)"
+      />
+    </div>
+  </div>
+  <DeploymentModal
+    v-model:opened="isModalOpen"
+    :environments="props.environments"
+    :repo-options="repoOptions"
+    :project="props.project"
+    :deployment="selectedDeployment"
+    @close="closeModal"
+  />
+</template>
diff --git a/apps/client/src/components/ProjectResources.vue b/apps/client/src/components/ProjectResources.vue
index 7b82bdfd4f..20a495fd28 100644
--- a/apps/client/src/components/ProjectResources.vue
+++ b/apps/client/src/components/ProjectResources.vue
@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import type { CleanedCluster, Cluster, CreateEnvironmentBody, Environment, Repo, UpdateEnvironmentBody, Zone } from '@cpn-console/shared'
+import type { CleanedCluster, Cluster, CreateEnvironmentBody, Deployment, Environment, Repo, Stage, UpdateEnvironmentBody, Zone } from '@cpn-console/shared'
 import type { Project } from '@/utils/project-utils.js'
 import { logger } from '@cpn-console/logger/browser'
 import { AdminAuthorized, ProjectAuthorized, projectIsLockedInfo } from '@cpn-console/shared'
@@ -25,8 +25,8 @@ const snackbarStore = useSnackbarStore()
 const stageStore = useStageStore()
 const userStore = useUserStore()
 
-const environments = ref<(Environment & { cluster?: Cluster, zone?: Zone })[]>()
-const repositories = ref<(Repo & { source: Source })[]>()
+const environments = ref<(Environment & { cluster?: Cluster, zone?: Zone, stage?: Stage })[]>([])
+const repositories = ref<(Repo & { source: Source })[]>([])
 const projectUsage = ref<({
   hprod: { cpu: number, gpu: number, memory: number }
   prod: { cpu: number, gpu: number, memory: number }
@@ -135,10 +135,12 @@ async function reload() {
     .then(envs => envs.map((environment: Environment) => {
       const cluster = clusterStore.clusters.find(cluster => cluster.id === environment.clusterId)
       const zone = zoneStore.zones.find(zone => zone.id === cluster?.zoneId)
+      const stage = stageStore.stages.find(stage => stage.id === environment.stageId)
       return {
         ...environment,
         cluster,
         zone,
+        stage,
       }
     }))
   repositories.value = await props.project.Repositories.list()
@@ -201,6 +203,7 @@ async function copyToClipboard(text: string) {
 </script>
 
 <template>
+  <DeploymentResources :environments :repositories :project />
   <div
     class="grow"
   >
diff --git a/apps/client/src/main.css b/apps/client/src/main.css
index f9098d4dee..58f1adca7f 100644
--- a/apps/client/src/main.css
+++ b/apps/client/src/main.css
@@ -42,6 +42,7 @@ body,
 .fr-fieldset {
   margin: 1rem 0 0;
   align-items: flex-start;
+  min-width: 0;
 }
 
 .fr-checkbox-group {
@@ -72,6 +73,10 @@ body,
   background-color: var(--background-alt-grey);
 }
 
+.fr-alert pre {
+  white-space: normal;
+}
+
 .log-panel, .log-btn {
   background-color: var(--background-default-grey);
 }
diff --git a/apps/client/src/utils/project-utils.ts b/apps/client/src/utils/project-utils.ts
index 7aa201b8ad..cc20822824 100644
--- a/apps/client/src/utils/project-utils.ts
+++ b/apps/client/src/utils/project-utils.ts
@@ -1,6 +1,8 @@
 import type {
+  CreateDeploymentBody,
   CreateEnvironmentBody,
   CreateRepositoryBody,
+  Deployment,
   Environment,
   GetLogsQuery,
   PermissionTarget,
@@ -13,6 +15,7 @@ import type {
   Repo,
   RepositoryParams,
   Role,
+  UpdateDeploymentBody,
   UpdateEnvironmentBody,
   UpdateRepositoryBody,
   User,
@@ -35,6 +38,7 @@ import { getRandomId } from './func.js'
 
 export type ProjectOperations = 'create'
   | 'delete'
+  | 'deploymentManagement'
   | 'envManagement'
   | 'repoManagement'
   | 'teamManagement'
@@ -80,6 +84,7 @@ export class Project implements ProjectV2 {
   myPerms: bigint
   repositories: Ref<Repo[]>
   environments: Ref<Environment[]>
+  deployments: Ref<Deployment[]>
   services: ProjectService[] = []
   lastSuccessProvisionningVersion: string | null
   needReplay: Ref<boolean>
@@ -112,6 +117,7 @@ export class Project implements ProjectV2 {
     this.environments = ref([])
     this.repositories = ref([])
     this.needReplay = ref(false)
+    this.deployments = ref([])
   }
 
   private removeOperation(operationName: ProjectOperations) {
@@ -229,6 +235,40 @@ export class Project implements ProjectV2 {
     },
   }
 
+  Deployments = {
+    list: async () => {
+      this.deployments.value = await apiClient.Deployments.listDeployments({ query: { projectId: this.id } })
+        .then((response: any) => extractData(response, 200))
+      return this.deployments.value
+    },
+    create: async (deploymentData: Omit<CreateDeploymentBody, 'projectId'>) => {
+      const callback = this.addOperation('deploymentManagement')
+      try {
+        await apiClient.Deployments.createDeployment({ body: { ...deploymentData, projectId: this.id } })
+          .then((response: any) => extractData(response, 201))
+        return this.Deployments.list()
+      } finally { callback() }
+    },
+    update: async (id: Deployment['id'], deployment: UpdateDeploymentBody) => {
+      const callback = this.addOperation('deploymentManagement')
+      try {
+        await apiClient.Deployments.updateDeployment({ body: deployment, params: { deploymentId: id } })
+          .then((response: any) => extractData(response, 200))
+        await this.Deployments.list()
+        return this.deployments
+      } finally { callback() }
+    },
+    delete: async (deploymentId: Deployment['id']) => {
+      const callback = this.addOperation('deploymentManagement')
+      try {
+        await apiClient.Deployments.deleteDeployment({ params: { deploymentId } })
+          .then((response: any) => extractData(response, 204))
+        await this.Deployments.list()
+        return this.deployments
+      } finally { callback() }
+    },
+  }
+
   Environments = {
     list: async () => {
       this.environments.value = await apiClient.Environments.listEnvironments({ query: { projectId: this.id } })
diff --git a/packages/shared/src/api-client.ts b/packages/shared/src/api-client.ts
index 6c877a08de..96532b6a4d 100644
--- a/packages/shared/src/api-client.ts
+++ b/packages/shared/src/api-client.ts
@@ -11,6 +11,7 @@ export async function getContract() {
     AdminRoles: (await import('./contracts/index.js')).adminRoleContract,
     Clusters: (await import('./contracts/index.js')).clusterContract,
     ServiceChains: (await import('./contracts/index.js')).serviceChainContract,
+    Deployments: (await import('./contracts/index.js')).deploymentContract,
     Environments: (await import('./contracts/index.js')).environmentContract,
     Logs: (await import('./contracts/index.js')).logContract,
     PersonalAccessTokens: (await import('./contracts/index.js'))
diff --git a/packages/shared/src/contracts/deployment.ts b/packages/shared/src/contracts/deployment.ts
new file mode 100644
index 0000000000..556e96d899
--- /dev/null
+++ b/packages/shared/src/contracts/deployment.ts
@@ -0,0 +1,91 @@
+import type { ClientInferRequest } from '@ts-rest/core'
+import { z } from 'zod'
+import { apiPrefix, contractInstance } from '../api-client.js'
+import {
+  CreateDeploymentSchema,
+  DeploymentSchema,
+  UpdateDeploymentSchema,
+} from '../schemas/index.js'
+import { baseHeaders, ErrorSchema } from './_utils.js'
+
+export const deploymentContract = contractInstance.router({
+  createDeployment: {
+    method: 'POST',
+    path: '',
+    contentType: 'application/json',
+    summary: 'Create deployment',
+    description: 'Create new deployment.',
+    body: CreateDeploymentSchema,
+    responses: {
+      201: DeploymentSchema,
+      400: ErrorSchema,
+      401: ErrorSchema,
+      500: ErrorSchema,
+    },
+  },
+
+  listDeployments: {
+    method: 'GET',
+    path: '',
+    summary: 'Get deployments',
+    description: 'Retrieved project deployments.',
+    query: z.object({
+      projectId: z.string()
+        .uuid(),
+    }),
+    responses: {
+      200: DeploymentSchema.array(),
+      400: ErrorSchema,
+      401: ErrorSchema,
+      403: ErrorSchema,
+      404: ErrorSchema,
+      500: ErrorSchema,
+    },
+  },
+
+  updateDeployment: {
+    method: 'PUT',
+    path: `/:deploymentId`,
+    summary: 'Update deployment',
+    description: 'Update a deployment by its ID.',
+    pathParams: z.object({
+      deploymentId: z.string()
+        .uuid(),
+    }),
+    body: UpdateDeploymentSchema,
+    responses: {
+      200: DeploymentSchema,
+      400: ErrorSchema,
+      401: ErrorSchema,
+      403: ErrorSchema,
+      404: ErrorSchema,
+      500: ErrorSchema,
+    },
+  },
+
+  deleteDeployment: {
+    method: 'DELETE',
+    path: `/:deploymentId`,
+    summary: 'Delete deployment',
+    description: 'Delete a deployment by its ID.',
+    body: null,
+    pathParams: z.object({
+      deploymentId: z.string()
+        .uuid(),
+    }),
+    responses: {
+      204: null,
+      400: ErrorSchema,
+      401: ErrorSchema,
+      403: ErrorSchema,
+      404: ErrorSchema,
+      500: ErrorSchema,
+    },
+  },
+}, {
+  baseHeaders,
+  pathPrefix: `${apiPrefix}/deployments`,
+})
+
+export type CreateDeploymentBody = ClientInferRequest<typeof deploymentContract.createDeployment>['body']
+export type UpdateDeploymentBody = ClientInferRequest<typeof deploymentContract.updateDeployment>['body']
diff --git a/packages/shared/src/contracts/index.ts b/packages/shared/src/contracts/index.ts
index 85488f73ac..c5c88fab16 100644
--- a/packages/shared/src/contracts/index.ts
+++ b/packages/shared/src/contracts/index.ts
@@ -1,6 +1,7 @@
 export * from './admin-role.js'
 export * from './admin-token.js'
 export * from './cluster.js'
+export * from './deployment.js'
 export * from './environment.js'
 export * from './log.js'
 export * from './personal-access-token.js'