@ogygie/studio 0.27.0 → 0.28.0

package/dist/server.js

@@ -1705,6 +1705,26 @@ var EnvironmentsStatusSchema = z6.object({
   /** release/<date>.<n>, most recent first. */
   releases: z6.array(z6.string())
 });
+var EnvironmentReadParamsSchema = z6.object({ environment: EnvironmentNameSchema });
+var CommitReachSchema = z6.enum(["deployed", "forward", "backward", "unreachable"]);
+var EnvironmentCommitSchema = z6.object({
+  sha: z6.string(),
+  /** The first line of the message without its `spec: merge` prefix and its `(#n)` suffix. */
+  title: z6.string(),
+  specId: FeatureNameSchema.nullable(),
+  author: z6.string(),
+  authoredAt: z6.string(),
+  releaseTag: z6.string().nullable(),
+  reach: CommitReachSchema,
+  /** The reason, in the client's language. */
+  why: z6.string()
+});
+var EnvironmentCommitsSchema = z6.object({
+  environment: EnvironmentNameSchema,
+  ref: z6.string(),
+  deployedSha: z6.string().nullable(),
+  commits: z6.array(EnvironmentCommitSchema).max(30)
+});
 var PromotionInputSchema = z6.object({
   sha: z6.string().regex(/^[0-9a-f]{40}$/),
   /** Operator only: a step back, forced, with its reason. */
@@ -3237,6 +3257,48 @@ async function environmentsStatus(deps) {
     releases: releases.sort().reverse()
   };
 }
+var LINE_LENGTH = 30;
+function commitTitleOf(message) {
+  const firstLine = message.split("\n")[0] ?? "";
+  return firstLine.replace(/^spec: merge /u, "").replace(/\s*\(#\d+\)\s*$/u, "").trim();
+}
+function reachOf(environment, index, deployedIndex, stagingIndex) {
+  if (index === deployedIndex) return { reach: "deployed", why: "d\xE9ploy\xE9" };
+  if (environment === "development") return { reach: "unreachable", why: "le d\xE9veloppement suit la branche par d\xE9faut, il ne se promeut pas" };
+  const newer = deployedIndex === -1 || index < deployedIndex;
+  if (environment === "staging") {
+    return newer ? { reach: "forward", why: "avance rapide depuis le d\xE9veloppement" } : { reach: "backward", why: "retour arri\xE8re : op\xE9rateur, avec un motif" };
+  }
+  if (index === stagingIndex && newer) return { reach: "forward", why: "le commit de la pr\xE9production" };
+  if (newer) return { reach: "unreachable", why: stagingIndex !== -1 && index < stagingIndex ? "la pr\xE9production ne l'a pas re\xE7u (PROMOTION_ORDER_VIOLATED)" : "seul le commit de la pr\xE9production est promouvable" };
+  return { reach: "backward", why: "retour arri\xE8re : op\xE9rateur, avec un motif" };
+}
+async function environmentCommits(deps, environment) {
+  const ref = environment === "development" ? deps.defaultBranch : ENVIRONMENT_REFS[environment];
+  const [deployedSha, stagingSha, commits, tags] = await Promise.all([
+    deps.deploy.getRefSha(ref),
+    environment === "production" ? deps.deploy.getRefSha(ENVIRONMENT_REFS.staging) : Promise.resolve(null),
+    deps.deploy.listCommits(deps.defaultBranch, LINE_LENGTH),
+    deps.deploy.listReleaseTags("release/")
+  ]);
+  const tagOf = new Map(tags.map((tag) => [tag.sha, tag.name]));
+  const deployedIndex = commits.findIndex((commit) => commit.sha === deployedSha);
+  const stagingIndex = stagingSha === null ? -1 : commits.findIndex((commit) => commit.sha === stagingSha);
+  return {
+    environment,
+    ref,
+    deployedSha,
+    commits: commits.map((commit, index) => ({
+      sha: commit.sha,
+      title: commitTitleOf(commit.message),
+      specId: MERGED_SPEC.exec(commit.message.split("\n")[0] ?? "")?.[1] ?? null,
+      author: commit.author,
+      authoredAt: commit.authoredAt,
+      releaseTag: tagOf.get(commit.sha) ?? null,
+      ...reachOf(environment, index, deployedIndex, stagingIndex)
+    }))
+  };
+}
 function pullRequestsOf(commits) {
   const included = [];
   for (const commit of commits) {
@@ -3367,6 +3429,15 @@ async function registerPromotionRoutes(app, deps) {
       return reply.code(200).send(await environmentsStatus(promotionDeps));
     }
   });
+  route.route({
+    method: "GET",
+    url: "/api/environments/:environment/commits",
+    schema: { params: EnvironmentReadParamsSchema, response: { 200: EnvironmentCommitsSchema } },
+    handler: async (request, reply) => {
+      hostedUserOf(request);
+      return reply.code(200).send(await environmentCommits(promotionDeps, request.params.environment));
+    }
+  });
   route.route({
     method: "POST",
     url: "/api/environments/:environment/promotions",
@@ -4082,6 +4153,29 @@ function createGithubDeployClient(deps) {
         commits: (answer?.commits ?? []).map((entry) => ({ sha: entry.sha, message: entry.commit.message, authoredAt: entry.commit.author.date }))
       };
     },
+    async listReleaseTags(prefix) {
+      const refs = await request("GET", `${repoUrl}/git/matching-refs/tags/${prefix}`, void 0) ?? [];
+      const tags = [];
+      for (const entry of refs) {
+        const name = entry.ref.replace(/^refs\/tags\//u, "");
+        if (entry.object.type !== "tag") {
+          tags.push({ name, sha: entry.object.sha });
+          continue;
+        }
+        const tag = await request("GET", `${repoUrl}/git/tags/${entry.object.sha}`, void 0, true);
+        if (tag !== null) tags.push({ name, sha: tag.object.sha });
+      }
+      return tags;
+    },
+    async listCommits(ref, perPage) {
+      const answer = await request(
+        "GET",
+        `${repoUrl}/commits?sha=${encodeURIComponent(ref)}&per_page=${Math.min(Math.max(perPage, 1), 100)}`,
+        void 0,
+        true
+      );
+      return (answer ?? []).map((entry) => ({ sha: entry.sha, message: entry.commit.message, authoredAt: entry.commit.author.date, author: entry.commit.author.name }));
+    },
     async updateRef(ref, sha, force) {
       await request("PATCH", `${repoUrl}/git/refs/heads/${encodeURIComponent(ref)}`, { sha, force });
     },