Skip to content

Where people and agents ship software together. The open-source git platform for the whole job: issues, agents, checks and deploys to the edge.

g1t.sh
1,955 linesCodeBlameRaw
1//! A repository's lifecycle after it is made: renaming it, archiving it,
2//! making it public or private, changing or renaming its default branch,
3//! and deleting it with a window to restore it.
4//!
5//! Deleting is soft. The row gets `deleted_at` and `purge_after`
6//! ([`RESTORE_DAYS`] on), every read in the registry leaves it out, git
7//! refuses it, and `repo.deleted` tells every service to stop what runs for
8//! it and hide it. Restoring clears the columns (`repo.restored`). Purging,
9//! by an owner from the Recently deleted list or by the hourly sweep once
10//! `purge_after` has passed, removes the git data from the store, then the
11//! rows (its pull requests' working copies with it) and its redirects, and
12//! announces `repo.purged`, on which services drop what they keep for it.
13//! Until then its name stays taken, so a restore always has its path back.
14//!
15//! A rename is a path change like a transfer: the old path is kept in
16//! `repo_redirects`, the git store key never changes, the tokens of agents
17//! at work on it are moved with identity, and `repo.renamed` is handled by
18//! services with the same helper as `repo.transferred`
19//! (`g1t_kit::transfer`).
20
21use g1t_contracts::audit::{
22 AuditActor, AuditOutcome, AuditTarget, NewAuditEntry, RecordAuditArgs, Surface,
23};
24use g1t_contracts::events::{
25 BranchRenamed, NewEvent, RepoArchived, RepoDefaultBranchChanged, RepoDeleted, RepoPurged,
26 RepoRenamed, RepoRestored, RepoUpdated, RepoVisibilityChanged, WorkspaceDeleted,
27 WorkspaceDeleting, WorkspaceRestored,
28};
29use g1t_contracts::identity::TransferRepoScopesArgs;
30use g1t_contracts::repos::{
31 ArchiveArgs, Branch, CreateBranchArgs, DeleteArgs, DeletedArgs, DeletedRepo, DeletedRepoArgs,
32 PurgeDueArgs, RESTORE_DAYS, RemoveBranchArgs, RenameArgs, RenameBranchArgs, Repo, RepoPath,
33 RepoStatus, ResolveBranchArgs,
34 SetDefaultBranchArgs, SetVisibilityArgs, StatusByIdArgs, archived_message,
35 is_valid_branch_name,
36};
37use g1t_contracts::access::{self, Capability, RepoRole};
38use g1t_contracts::time::rfc3339;
39use g1t_contracts::{FailureCode, Outcome, PrincipalKind, Role, User, is_valid_repo_name, new_id};
40use g1t_kit::now_ms;
41use serde::Deserialize;
42use worker::Result;
43use worker::wasm_bindgen::JsValue;
44
45use crate::registry::{Registry, remember_store, store_key};
46use crate::store::{GitRepo, GitStore, Scope};
47use crate::{Repos, SOURCE, UNVERIFIED, git_ops, land, not_found};
48
49use crate::land::EMPTY_PACK;
50
51/// How many pull request working copies follow a change of the default
52/// branch (newest first). Older ones keep the branch they were made with.
53const FORKS_FOLLOWING: u32 = 100;
54
55/// How many deleted repositories one sweep purges.
56const PURGES_PER_SWEEP: u32 = 25;
57
58type Refusal = (FailureCode, String);
59
60/// Who is asking, as far as an owner's or an admin's action cares.
61#[derive(Clone, Copy, Debug)]
62pub struct Asker {
63 /// A person, not a workspace's or an agent's token.
64 pub person: bool,
65 pub verified: bool,
66 /// Their role in the repository's workspace.
67 pub role: Option<Role>,
68 /// Their role on the repository itself (see g1t_contracts::access).
69 /// None where only the workspace is known, as for deleted ones.
70 pub repo_role: Option<RepoRole>,
71 /// The workspace's member privileges, as their membership carries them.
72 pub privileges: g1t_contracts::MemberPrivileges,
73}
74
75impl Asker {
76 pub fn of(user: &User, namespace: &str) -> Self {
77 Asker {
78 person: user.kind == PrincipalKind::User,
79 verified: user.verified,
80 role: user.role_in(&namespace.to_lowercase()),
81 repo_role: None,
82 privileges: user.privileges_in(&namespace.to_lowercase()),
83 }
84 }
85
86 /// The asker, with their role on `repo`.
87 pub fn on(user: &User, repo: &Repo) -> Self {
88 Asker {
89 repo_role: crate::registry::role(repo, &Some(user.clone())),
90 ..Asker::of(user, &repo.namespace)
91 }
92 }
93}
94
95/// Whether `asker` may `what` ("rename", "archive"...) a repository of
96/// `namespace` that takes `capability`: a verified person with the role
97/// the permission table asks (Admin), and for changing visibility,
98/// transferring and deleting, an owner of the workspace as well, unless its
99/// member privileges let its members with Admin do it.
100pub fn admin_only(asker: Asker, namespace: &str, what: &str, capability: Capability) -> std::result::Result<(), Refusal> {
101 let admins_may = asker.role == Some(Role::Member)
102 && asker.repo_role == Some(RepoRole::Admin)
103 && !access::owner_only(capability, &asker.privileges);
104 if access::OWNER_ONLY.contains(&capability) && !admins_may {
105 // Someone who can see the repository is told why, not that it is missing.
106 if asker.role.is_none() && asker.repo_role.is_some() && asker.person {
107 return Err((
108 FailureCode::Forbidden,
109 format!("Only an owner of {namespace} can {what} its repositories."),
110 ));
111 }
112 return owner_only(asker, namespace, what);
113 }
114 if asker.role.is_none() && asker.repo_role.is_none() {
115 return Err((FailureCode::NotFound, "Repository not found.".into()));
116 }
117 if !asker.person {
118 return Err((
119 FailureCode::Forbidden,
120 format!("Only a person can {what} a repository. Sign in, or use a personal access token."),
121 ));
122 }
123 if !asker.repo_role.is_some_and(|role| access::allows(role, capability)) {
124 return Err((
125 FailureCode::Forbidden,
126 format!(
127 "You need the {} role on a repository of {namespace} to {what} it.",
128 access::least_role(capability).label()
129 ),
130 ));
131 }
132 if !asker.verified {
133 return Err((FailureCode::Forbidden, UNVERIFIED.into()));
134 }
135 Ok(())
136}
137
138/// Making a repository public or private is, as far as the workspace's
139/// member privileges go, creating one of that kind: a member may only make
140/// it what they may create.
141pub fn visibility_refusal(actor: &User, repo: &Repo, private: bool) -> Option<String> {
142 if repo.is_private == private {
143 return None;
144 }
145 let role = actor.role_in(&repo.namespace.to_lowercase())?;
146 actor.privileges_in(&repo.namespace.to_lowercase()).creation_refusal(role, private, &repo.namespace)
147}
148
149/// Whether `asker` may `what` ("delete", "rename"...) a repository of
150/// `namespace`: a verified person who owns the workspace.
151pub fn owner_only(asker: Asker, namespace: &str, what: &str) -> std::result::Result<(), Refusal> {
152 if asker.role.is_none() {
153 return Err((FailureCode::NotFound, "Repository not found.".into()));
154 }
155 if !asker.person {
156 return Err((
157 FailureCode::Forbidden,
158 format!("Only a person can {what} a repository. Sign in, or use a personal access token."),
159 ));
160 }
161 if asker.role != Some(Role::Owner) {
162 return Err((
163 FailureCode::Forbidden,
164 format!("Only an owner of {namespace} can {what} its repositories."),
165 ));
166 }
167 if !asker.verified {
168 return Err((FailureCode::Forbidden, UNVERIFIED.into()));
169 }
170 Ok(())
171}
172
173/// Whether what was typed to confirm names the repository: its full name,
174/// `namespace/name`, in any case.
175pub fn confirmed(path: &RepoPath, typed: &str) -> bool {
176 typed.trim().to_lowercase() == format!("{}/{}", path.namespace, path.name).to_lowercase()
177}
178
179fn confirm_refusal(path: &RepoPath) -> Refusal {
180 (
181 FailureCode::Invalid,
182 format!("Type {}/{} to confirm.", path.namespace, path.name),
183 )
184}
185
186/// When a repository deleted at `now_ms` is purged.
187pub fn purge_after(now_ms: u64) -> String {
188 rfc3339(now_ms + RESTORE_DAYS * 86_400_000)
189}
190
191/// Whether a repository to be purged at `purge_after` can still be
192/// restored at `now` (both RFC 3339, which compare as text).
193pub fn restorable(purge_after: &str, now: &str) -> bool {
194 now < purge_after
195}
196
197/// Whether a workspace's repositories may go with it: never a protected
198/// workspace's (`protected` is `g1t_contracts::identity::protected_names`),
199/// however the event came to be published.
200pub fn may_go_with_workspace(namespace: &str, protected: &[String]) -> std::result::Result<(), String> {
201 if protected.iter().any(|name| name.eq_ignore_ascii_case(namespace)) {
202 return Err(g1t_contracts::identity::protected_refusal(namespace));
203 }
204 Ok(())
205}
206
207/// Whether a deleted repository comes back when the workspace
208/// `workspace_id` is restored: only if it went with that workspace
209/// (`deleted_with`), not if it was deleted on its own before.
210pub fn comes_back_with(deleted_with: Option<&str>, workspace_id: &str) -> bool {
211 deleted_with == Some(workspace_id)
212}
213
214/// Where a repository is in its life, from its row.
215#[derive(Clone, Copy, Debug, PartialEq, Eq)]
216pub enum State {
217 Active,
218 Archived,
219 /// Deleted, and restorable until purged.
220 Deleted,
221 /// Deleted, and due to be purged by the next sweep.
222 Due,
223}
224
225pub fn state(archived_at: Option<&str>, deleted: Option<(&str, &str)>, now: &str) -> State {
226 match deleted {
227 Some((_, purge_after)) if !restorable(purge_after, now) => State::Due,
228 Some(_) => State::Deleted,
229 None if archived_at.is_some() => State::Archived,
230 None => State::Active,
231 }
232}
233
234/// What holds a name in a workspace.
235#[derive(Clone, Copy, Debug, PartialEq, Eq)]
236pub enum Held {
237 Free,
238 ByRepo,
239 /// A repository deleted but not yet purged.
240 ByDeleted,
241}
242
243/// The name a repository at `current` can be renamed to, tidied, or why
244/// not.
245pub fn new_name(namespace: &str, current: &str, wanted: &str, held: Held) -> std::result::Result<String, Refusal> {
246 let name = wanted.trim().to_lowercase();
247 if !is_valid_repo_name(&name) {
248 return Err((
249 FailureCode::Invalid,
250 "Use letters, digits, dots, hyphens and underscores only.".into(),
251 ));
252 }
253 if name == current {
254 return Err((FailureCode::Invalid, format!("It is already called {name}.")));
255 }
256 match held {
257 Held::Free => Ok(name),
258 Held::ByRepo => Err((
259 FailureCode::Conflict,
260 format!("{namespace} already has a repository named {name}."),
261 )),
262 Held::ByDeleted => Err((
263 FailureCode::Conflict,
264 format!(
265 "{namespace}/{name} was deleted recently and can still be restored. Restore it and rename it, or delete it permanently from the workspace's Recently deleted list first."
266 ),
267 )),
268 }
269}
270
271/// Why a write to `repo` is refused because it is archived, if it is.
272pub fn archived_refusal(repo: &Repo) -> Option<Refusal> {
273 repo.archived()
274 .then(|| (FailureCode::Forbidden, archived_message(&repo.namespace, &repo.name)))
275}
276
277/// Why a repository takes no pushes, merges or new work now: it is
278/// archived.
279pub fn read_only_refusal(repo: &Repo) -> Option<Refusal> {
280 repo.read_only_reason().map(|message| (FailureCode::Forbidden, message))
281}
282
283/// Everything that decides whether a repository may go private or public.
284#[derive(Debug, Default)]
285pub struct VisibilityFacts {
286 pub to_private: bool,
287 /// The workspace is on no plan, so its private storage is capped.
288 pub free: bool,
289 /// What its private repositories hold now.
290 pub private_bytes: i64,
291 /// What this repository holds.
292 pub bytes: i64,
293 /// What a free workspace's private repositories may hold.
294 pub free_private_bytes: i64,
295}
296
297/// Whether the visibility change `facts` describe may happen.
298pub fn visibility_check(namespace: &str, facts: &VisibilityFacts) -> std::result::Result<(), Refusal> {
299 if facts.to_private
300 && facts.free
301 && git_ops::storage_full(facts.private_bytes + facts.bytes, facts.free_private_bytes)
302 {
303 return Err((
304 FailureCode::PaymentRequired,
305 format!(
306 "{namespace}'s private repositories would hold {:.2} GB, more than the {:.0} GB a free workspace has. Start the g1t plan in {namespace}, or keep the repository public.",
307 (facts.private_bytes + facts.bytes) as f64 / 1e9,
308 facts.free_private_bytes as f64 / 1e9,
309 ),
310 ));
311 }
312 Ok(())
313}
314
315/// Whether `from` can be renamed to `to` in a repository whose branches
316/// are `branches`. `to` is tidied of surrounding space.
317pub fn branch_rename(from: &str, to: &str, branches: &[String]) -> std::result::Result<String, Refusal> {
318 let to = to.trim().to_owned();
319 if !branches.iter().any(|branch| branch == from) {
320 return Err((FailureCode::NotFound, format!("There is no branch named {from}.")));
321 }
322 if !is_valid_branch_name(&to) {
323 return Err((
324 FailureCode::Invalid,
325 format!("{to:?} cannot be a branch name. Use letters, digits, '/', '-', '_' and '.', and no spaces."),
326 ));
327 }
328 if to == from {
329 return Err((FailureCode::Invalid, format!("It is already called {to}.")));
330 }
331 if branches.contains(&to) {
332 return Err((FailureCode::Conflict, format!("There is already a branch named {to}.")));
333 }
334 Ok(to)
335}
336
337/// Whether a branch named `name` can be made in a repository whose
338/// branches are `branches`: a valid name, free, and neither inside nor
339/// holding another branch's name as a folder (git keeps `feature` and
340/// `feature/login` apart only as a file and a directory, which cannot
341/// both be). `name` is tidied of surrounding space.
342pub fn branch_creation(name: &str, branches: &[Branch]) -> std::result::Result<String, Refusal> {
343 let name = name.trim().to_owned();
344 if !is_valid_branch_name(&name) {
345 return Err((
346 FailureCode::Invalid,
347 format!("{name:?} cannot be a branch name. Use letters, digits, '/', '-', '_' and '.', and no spaces."),
348 ));
349 }
350 if branches.iter().any(|branch| branch.name == name) {
351 return Err((FailureCode::Conflict, format!("There is already a branch named {name}.")));
352 }
353 if let Some(clash) = branches.iter().find(|branch| {
354 name.starts_with(&format!("{}/", branch.name)) || branch.name.starts_with(&format!("{name}/"))
355 }) {
356 return Err((
357 FailureCode::Conflict,
358 format!("{name} cannot sit beside {}: one name would be a folder of the other.", clash.name),
359 ));
360 }
361 Ok(name)
362}
363
364/// The commit `branch` points to, when it may be deleted from a repository
365/// whose default branch is `default_branch` and whose branches are
366/// `branches`: never the default, and, when the caller says which commit
367/// it saw (`head`), only while it still points there.
368pub fn branch_removal(
369 branch: &str,
370 default_branch: &str,
371 head: Option<&str>,
372 branches: &[Branch],
373) -> std::result::Result<String, Refusal> {
374 if branch == default_branch {
375 return Err((
376 FailureCode::Forbidden,
377 format!("{branch} is the default branch, which is never deleted. Make another branch the default first."),
378 ));
379 }
380 let Some(found) = branches.iter().find(|found| found.name == branch) else {
381 return Err((FailureCode::NotFound, format!("There is no branch named {branch}.")));
382 };
383 if head.is_some_and(|head| !head.is_empty() && head != found.hash) {
384 return Err((
385 FailureCode::Conflict,
386 format!("{branch} has new commits since you looked, so it was left alone. Reload to see them."),
387 ));
388 }
389 Ok(found.hash.clone())
390}
391
392/// The row of a deleted repository.
393#[derive(Deserialize)]
394struct DeletedRow {
395 id: String,
396 namespace: String,
397 name: String,
398 description: Option<String>,
399 is_private: u8,
400 deleted_at: String,
401 #[serde(default)]
402 deleted_by: Option<String>,
403 purge_after: String,
404 #[serde(default)]
405 deleted_with: Option<String>,
406}
407
408impl From<DeletedRow> for DeletedRepo {
409 fn from(row: DeletedRow) -> Self {
410 DeletedRepo {
411 id: row.id,
412 namespace: row.namespace,
413 name: row.name,
414 description: row.description,
415 is_private: row.is_private != 0,
416 deleted_at: row.deleted_at,
417 deleted_by: row.deleted_by.unwrap_or_default(),
418 purge_after: row.purge_after,
419 }
420 }
421}
422
423const DELETED_COLUMNS: &str =
424 "id, namespace, name, description, is_private, deleted_at, deleted_by, purge_after, deleted_with";
425
426impl Registry {
427 /// Deletes a repository and its pull requests' working copies, softly.
428 pub async fn soft_delete(&self, id: &str, by: &str, at: &str, purge_after: &str) -> Result<()> {
429 self.db
430 .prepare(
431 "UPDATE repos SET deleted_at = ?1, deleted_by = ?2, purge_after = ?3
432 WHERE (id = ?4 OR fork_of = ?4) AND deleted_at IS NULL",
433 )
434 .bind(&[at.into(), by.into(), purge_after.into(), id.into()])?
435 .run()
436 .await?;
437 Ok(())
438 }
439
440 /// Brings a deleted repository and its working copies back.
441 pub async fn undelete(&self, id: &str) -> Result<()> {
442 self.db
443 .prepare(
444 "UPDATE repos SET deleted_at = NULL, deleted_by = NULL, purge_after = NULL
445 WHERE id = ?1 OR fork_of = ?1",
446 )
447 .bind(&[id.into()])?
448 .run()
449 .await?;
450 Ok(())
451 }
452
453 /// Deletes every live repository of `namespace`, and the working
454 /// copies of its repositories, softly, each marked as gone with the
455 /// workspace `workspace_id`. Those already deleted are left as they
456 /// are. Returns every repository so marked, this time or before, so a
457 /// delivery again tells services again.
458 pub async fn delete_with_workspace(
459 &self,
460 namespace: &str,
461 workspace_id: &str,
462 by: &str,
463 at: &str,
464 purge_after: &str,
465 ) -> Result<Vec<DeletedRepo>> {
466 self.db
467 .prepare(
468 "UPDATE repos SET deleted_at = ?1, deleted_by = ?2, purge_after = ?3, deleted_with = ?4
469 WHERE deleted_at IS NULL
470 AND (namespace = ?5 OR fork_of IN (SELECT id FROM repos WHERE namespace = ?5))",
471 )
472 .bind(&[at.into(), by.into(), purge_after.into(), workspace_id.into(), namespace.into()])?
473 .run()
474 .await?;
475 self.deleted_with(workspace_id).await
476 }
477
478 /// The repositories deleted with the workspace `workspace_id`.
479 pub async fn deleted_with(&self, workspace_id: &str) -> Result<Vec<DeletedRepo>> {
480 Ok(self
481 .db
482 .prepare(format!(
483 "SELECT {DELETED_COLUMNS} FROM repos WHERE deleted_with = ? AND fork_of IS NULL"
484 ))
485 .bind(&[workspace_id.into()])?
486 .all()
487 .await?
488 .results::<DeletedRow>()?
489 .into_iter()
490 .filter(|row| comes_back_with(row.deleted_with.as_deref(), workspace_id))
491 .map(DeletedRepo::from)
492 .collect())
493 }
494
495 /// Brings back the repositories, and their working copies, deleted
496 /// with the workspace `workspace_id`, and only those.
497 pub async fn undelete_with_workspace(&self, workspace_id: &str) -> Result<()> {
498 self.db
499 .prepare(
500 "UPDATE repos SET deleted_at = NULL, deleted_by = NULL, purge_after = NULL, deleted_with = NULL
501 WHERE deleted_with = ?",
502 )
503 .bind(&[workspace_id.into()])?
504 .run()
505 .await?;
506 Ok(())
507 }
508
509 /// A workspace's deleted repositories, newest first.
510 pub async fn deleted_in(&self, namespace: &str) -> Result<Vec<DeletedRepo>> {
511 Ok(self
512 .db
513 .prepare(format!(
514 "SELECT {DELETED_COLUMNS} FROM repos
515 WHERE namespace = ? AND deleted_at IS NOT NULL AND fork_of IS NULL
516 ORDER BY deleted_at DESC LIMIT 200"
517 ))
518 .bind(&[namespace.to_lowercase().into()])?
519 .all()
520 .await?
521 .results::<DeletedRow>()?
522 .into_iter()
523 .map(DeletedRepo::from)
524 .collect())
525 }
526
527 /// The deleted repository at `path`, if that is what holds it.
528 pub async fn deleted_at(&self, path: &RepoPath) -> Result<Option<DeletedRepo>> {
529 Ok(self
530 .db
531 .prepare(format!(
532 "SELECT {DELETED_COLUMNS} FROM repos
533 WHERE namespace = ? AND name = ? AND deleted_at IS NOT NULL AND fork_of IS NULL"
534 ))
535 .bind(&[
536 path.namespace.to_lowercase().into(),
537 path.name.to_lowercase().into(),
538 ])?
539 .first::<DeletedRow>(None)
540 .await?
541 .map(DeletedRepo::from))
542 }
543
544 /// Deleted repositories whose time to be restored has passed.
545 pub async fn due(&self, now: &str, limit: u32) -> Result<Vec<DeletedRepo>> {
546 Ok(self
547 .db
548 .prepare(format!(
549 "SELECT {DELETED_COLUMNS} FROM repos
550 WHERE deleted_at IS NOT NULL AND purge_after <= ? AND fork_of IS NULL
551 ORDER BY purge_after LIMIT ?"
552 ))
553 .bind(&[now.into(), limit.into()])?
554 .all()
555 .await?
556 .results::<DeletedRow>()?
557 .into_iter()
558 .map(DeletedRepo::from)
559 .collect())
560 }
561
562 /// Every deleted repository left in a workspace, for when the
563 /// workspace itself is deleted.
564 pub async fn deleted_ids_in(&self, namespace: &str) -> Result<Vec<DeletedRepo>> {
565 self.deleted_in(namespace).await
566 }
567
568 /// The git store keys of a repository and of its working copies.
569 pub async fn store_keys(&self, id: &str) -> Result<Vec<String>> {
570 #[derive(Deserialize)]
571 struct Row {
572 namespace: String,
573 name: String,
574 #[serde(default)]
575 store: Option<String>,
576 }
577 Ok(self
578 .db
579 .prepare("SELECT namespace, name, store FROM repos WHERE id = ?1 OR fork_of = ?1")
580 .bind(&[id.into()])?
581 .all()
582 .await?
583 .results::<Row>()?
584 .into_iter()
585 .map(|row| row.store.unwrap_or_else(|| format!("{}--{}", row.namespace, row.name)))
586 .collect())
587 }
588
589 /// Forgets a purged repository: its rows, its working copies' rows and
590 /// every redirect to it.
591 pub async fn erase(&self, id: &str) -> Result<()> {
592 self.db
593 .batch(vec![
594 self.db.prepare("DELETE FROM repos WHERE fork_of = ?1").bind(&[id.into()])?,
595 self.db.prepare("DELETE FROM repos WHERE id = ?1").bind(&[id.into()])?,
596 self.db
597 .prepare("DELETE FROM repo_redirects WHERE repo_id = ?1")
598 .bind(&[id.into()])?,
599 self.db
600 .prepare("DELETE FROM branch_redirects WHERE repo_id = ?1")
601 .bind(&[id.into()])?,
602 // Its About, stars and releases (about.rs).
603 self.db.prepare("DELETE FROM repo_stats WHERE repo_id = ?1").bind(&[id.into()])?,
604 self.db.prepare("DELETE FROM repo_stars WHERE repo_id = ?1").bind(&[id.into()])?,
605 self.db.prepare("DELETE FROM releases WHERE repo_id = ?1").bind(&[id.into()])?,
606 ])
607 .await?;
608 Ok(())
609 }
610
611 /// Renames a repository, keeping its old path as a redirect. Any
612 /// redirect held by the new path gives way.
613 pub async fn rename(&self, repo: &Repo, name: &str) -> Result<()> {
614 let now = rfc3339(now_ms());
615 self.db
616 .batch(vec![
617 self.db
618 .prepare("UPDATE repos SET name = ? WHERE id = ? AND name = ?")
619 .bind(&[name.into(), repo.id.as_str().into(), repo.name.as_str().into()])?,
620 self.db
621 .prepare("DELETE FROM repo_redirects WHERE namespace = ? AND name = ?")
622 .bind(&[repo.namespace.as_str().into(), name.into()])?,
623 self.db
624 .prepare(
625 "INSERT OR REPLACE INTO repo_redirects (namespace, name, repo_id, created_at)
626 VALUES (?, ?, ?, ?)",
627 )
628 .bind(&[
629 repo.namespace.as_str().into(),
630 repo.name.as_str().into(),
631 repo.id.as_str().into(),
632 now.as_str().into(),
633 ])?,
634 ])
635 .await?;
636 Ok(())
637 }
638
639 pub async fn set_archived(&self, id: &str, at: Option<&str>) -> Result<()> {
640 self.db
641 .prepare("UPDATE repos SET archived_at = ? WHERE id = ?")
642 .bind(&[at.map_or(JsValue::NULL, JsValue::from), id.into()])?
643 .run()
644 .await?;
645 Ok(())
646 }
647
648 /// Makes a repository and its working copies public or private.
649 pub async fn set_private(&self, id: &str, private: bool) -> Result<()> {
650 self.db
651 .prepare("UPDATE repos SET is_private = ?1 WHERE id = ?2 OR fork_of = ?2")
652 .bind(&[u32::from(private).into(), id.into()])?
653 .run()
654 .await?;
655 Ok(())
656 }
657
658 pub async fn set_default_branch(&self, id: &str, branch: &str) -> Result<()> {
659 self.db
660 .prepare("UPDATE repos SET default_branch = ? WHERE id = ?")
661 .bind(&[branch.into(), id.into()])?
662 .run()
663 .await?;
664 Ok(())
665 }
666
667 /// Working copies of a repository, newest first, at most `limit`.
668 pub async fn forks_of(&self, id: &str, limit: u32) -> Result<Vec<Repo>> {
669 let rows = self
670 .db
671 .prepare(
672 "SELECT * FROM repos WHERE fork_of = ? AND deleted_at IS NULL AND retired_at IS NULL
673 ORDER BY created_at DESC LIMIT ?",
674 )
675 .bind(&[id.into(), limit.into()])?
676 .all()
677 .await?
678 .results::<crate::registry::RepoRow>()?;
679 Ok(rows.into_iter().map(Repo::from).collect())
680 }
681
682 /// Records that `from` is now called `to`. Redirects that pointed at
683 /// `from` point at `to`, and one held by `to` itself ends.
684 pub async fn add_branch_redirect(&self, repo_id: &str, from: &str, to: &str) -> Result<()> {
685 let now = rfc3339(now_ms());
686 self.db
687 .batch(vec![
688 self.db
689 .prepare("DELETE FROM branch_redirects WHERE repo_id = ? AND branch = ?")
690 .bind(&[repo_id.into(), to.into()])?,
691 self.db
692 .prepare("UPDATE branch_redirects SET now = ? WHERE repo_id = ? AND now = ?")
693 .bind(&[to.into(), repo_id.into(), from.into()])?,
694 self.db
695 .prepare(
696 "INSERT OR REPLACE INTO branch_redirects (repo_id, branch, now, created_at)
697 VALUES (?, ?, ?, ?)",
698 )
699 .bind(&[repo_id.into(), from.into(), to.into(), now.as_str().into()])?,
700 ])
701 .await?;
702 Ok(())
703 }
704
705 pub async fn branch_redirect(&self, repo_id: &str, branch: &str) -> Result<Option<String>> {
706 #[derive(Deserialize)]
707 struct Row {
708 now: String,
709 }
710 Ok(self
711 .db
712 .prepare("SELECT now FROM branch_redirects WHERE repo_id = ? AND branch = ?")
713 .bind(&[repo_id.into(), branch.into()])?
714 .first::<Row>(None)
715 .await?
716 .map(|row| row.now))
717 }
718
719 /// Whether a repository is archived or deleted; unknown is deleted.
720 pub async fn status(&self, id: &str) -> Result<RepoStatus> {
721 #[derive(Deserialize)]
722 struct Row {
723 #[serde(default)]
724 archived_at: Option<String>,
725 #[serde(default)]
726 deleted_at: Option<String>,
727 }
728 Ok(self
729 .db
730 .prepare("SELECT archived_at, deleted_at FROM repos WHERE id = ?")
731 .bind(&[id.into()])?
732 .first::<Row>(None)
733 .await?
734 .map_or(
735 RepoStatus {
736 archived: false,
737 deleted: true,
738 },
739 |row| RepoStatus {
740 archived: row.archived_at.is_some(),
741 deleted: row.deleted_at.is_some(),
742 },
743 ))
744 }
745}
746
747/// An audit entry for something done to a repository.
748fn entry(actor: AuditActor, action: &str, surface: Option<Surface>, path: &RepoPath, rule: &str, message: String) -> NewAuditEntry {
749 NewAuditEntry {
750 actor,
751 action: action.to_owned(),
752 surface: surface.unwrap_or(Surface::Web),
753 target: AuditTarget {
754 workspace: path.namespace.clone(),
755 repo: Some(format!("{}/{}", path.namespace, path.name)),
756 ..AuditTarget::default()
757 },
758 outcome: AuditOutcome::Allowed,
759 rule: rule.to_owned(),
760 result: Some("ok".to_owned()),
761 message: Some(message),
762 request_id: new_id("req", now_ms()),
763 }
764}
765
766/// g1t itself, as the actor of what its schedule does.
767fn g1t_actor() -> AuditActor {
768 AuditActor::system()
769}
770
771fn fail<T>((code, message): Refusal) -> Outcome<T> {
772 Outcome::fail(code, message)
773}
774
775fn path_of(repo: &Repo) -> RepoPath {
776 RepoPath {
777 namespace: repo.namespace.clone(),
778 name: repo.name.clone(),
779 }
780}
781
782impl<S: GitStore> Repos<S> {
783 pub(crate) async fn record(&self, entries: Vec<NewAuditEntry>) {
784 let recorded: Result<u32> =
785 g1t_kit::call(&self.events, "audit_record", &RecordAuditArgs { entries }).await;
786 if let Err(error) = recorded {
787 worker::console_error!("audit entries not recorded: {error}");
788 }
789 }
790
791 /// The repository at `path` an admin is acting on: found, not a
792 /// working copy, and the actor allowed `capability` on it (Admin, and
793 /// for deleting, an owner of its workspace).
794 async fn owned(
795 &self,
796 actor: &User,
797 path: &RepoPath,
798 what: &str,
799 capability: Capability,
800 ) -> Result<std::result::Result<Repo, Refusal>> {
801 let viewer = Some(actor.clone());
802 let Some(repo) = self.readable(path, &viewer).await? else {
803 return Ok(Err((FailureCode::NotFound, "Repository not found.".into())));
804 };
805 if repo.fork_of.is_some() {
806 return Ok(Err((FailureCode::NotFound, "Repository not found.".into())));
807 }
808 if let Err(refusal) = admin_only(Asker::on(actor, &repo), &repo.namespace, what, capability) {
809 return Ok(Err(refusal));
810 }
811 Ok(Ok(repo))
812 }
813
814 /// `delete`: see `g1t_contracts::repos::DeleteArgs`.
815 pub(crate) async fn delete(&self, a: DeleteArgs) -> Result<Outcome<DeletedRepo>> {
816 let repo = match self.owned(&a.actor, &a.path, "delete", Capability::Delete).await? {
817 Ok(repo) => repo,
818 Err(refusal) => return Ok(fail(refusal)),
819 };
820 let path = path_of(&repo);
821 if !confirmed(&path, &a.confirm) {
822 return Ok(fail(confirm_refusal(&path)));
823 }
824 let now = now_ms();
825 let at = rfc3339(now);
826 let purge = purge_after(now);
827 self.registry
828 .soft_delete(&repo.id, &a.actor.username, &at, &purge)
829 .await?;
830 self.publish(NewEvent {
831 kind: "repo.deleted",
832 source: SOURCE,
833 repo_id: Some(repo.id.clone()),
834 actor: Some(a.actor.id.clone()),
835 data: RepoDeleted {
836 repo_id: repo.id.clone(),
837 namespace: repo.namespace.clone(),
838 name: repo.name.clone(),
839 is_private: repo.is_private,
840 purge_after: purge.clone(),
841 with_workspace: false,
842 },
843 })
844 .await?;
845 self.record(vec![entry(
846 AuditActor::of(&a.actor),
847 "repo.deleted",
848 a.surface,
849 &path,
850 "owner",
851 format!("Deleted; restorable until {purge}"),
852 )])
853 .await;
854 Ok(Outcome::Ok(DeletedRepo {
855 id: repo.id,
856 namespace: repo.namespace,
857 name: repo.name,
858 description: repo.description,
859 is_private: repo.is_private,
860 deleted_at: at,
861 deleted_by: a.actor.username,
862 purge_after: purge,
863 }))
864 }
865
866 /// `deleted`: see `g1t_contracts::repos::DeletedArgs`.
867 pub(crate) async fn deleted(&self, a: DeletedArgs) -> Result<Vec<DeletedRepo>> {
868 let namespace = a.namespace.to_lowercase();
869 let owner = a
870 .viewer
871 .as_ref()
872 .is_some_and(|user| user.role_in(&namespace) == Some(Role::Owner));
873 if !owner {
874 return Ok(Vec::new());
875 }
876 self.registry.deleted_in(&namespace).await
877 }
878
879 /// The deleted repository an owner is acting on.
880 async fn owned_deleted(
881 &self,
882 actor: &User,
883 path: &RepoPath,
884 what: &str,
885 ) -> Result<std::result::Result<DeletedRepo, Refusal>> {
886 if let Err(refusal) = owner_only(Asker::of(actor, &path.namespace), &path.namespace.to_lowercase(), what) {
887 return Ok(Err(refusal));
888 }
889 Ok(match self.registry.deleted_at(path).await? {
890 Some(deleted) => Ok(deleted),
891 None => Err((
892 FailureCode::NotFound,
893 format!(
894 "{}/{} is not among the workspace's recently deleted repositories.",
895 path.namespace, path.name
896 ),
897 )),
898 })
899 }
900
901 /// `restore`: see `g1t_contracts::repos::DeletedRepoArgs`.
902 pub(crate) async fn restore(&self, a: DeletedRepoArgs) -> Result<Outcome<Repo>> {
903 let deleted = match self.owned_deleted(&a.actor, &a.path, "restore").await? {
904 Ok(deleted) => deleted,
905 Err(refusal) => return Ok(fail(refusal)),
906 };
907 let deleted_state = state(
908 None,
909 Some((&deleted.deleted_at, &deleted.purge_after)),
910 &rfc3339(now_ms()),
911 );
912 if deleted_state == State::Due {
913 return Ok(Outcome::fail(
914 FailureCode::Conflict,
915 format!("{}/{} is being purged and can no longer be restored.", deleted.namespace, deleted.name),
916 ));
917 }
918 self.registry.undelete(&deleted.id).await?;
919 let Some(repo) = self.registry.by_id(&deleted.id).await? else {
920 return Ok(not_found());
921 };
922 self.publish(NewEvent {
923 kind: "repo.restored",
924 source: SOURCE,
925 repo_id: Some(repo.id.clone()),
926 actor: Some(a.actor.id.clone()),
927 data: RepoRestored {
928 repo_id: repo.id.clone(),
929 namespace: repo.namespace.clone(),
930 name: repo.name.clone(),
931 is_private: repo.is_private,
932 with_workspace: false,
933 },
934 })
935 .await?;
936 self.record(vec![entry(
937 AuditActor::of(&a.actor),
938 "repo.restored",
939 a.surface,
940 &path_of(&repo),
941 "owner",
942 format!("Restored; deleted by {} at {}", deleted.deleted_by, deleted.deleted_at),
943 )])
944 .await;
945 Ok(Outcome::Ok(repo))
946 }
947
948 /// `purge`: see `g1t_contracts::repos::DeletedRepoArgs`.
949 pub(crate) async fn purge(&self, a: DeletedRepoArgs) -> Result<Outcome<bool>> {
950 let deleted = match self.owned_deleted(&a.actor, &a.path, "permanently delete").await? {
951 Ok(deleted) => deleted,
952 Err(refusal) => return Ok(fail(refusal)),
953 };
954 let path = RepoPath {
955 namespace: deleted.namespace.clone(),
956 name: deleted.name.clone(),
957 };
958 if !confirmed(&path, a.confirm.as_deref().unwrap_or_default()) {
959 return Ok(fail(confirm_refusal(&path)));
960 }
961 self.purge_now(&deleted, Some(&a.actor.id)).await?;
962 self.record(vec![entry(
963 AuditActor::of(&a.actor),
964 "repo.purged",
965 a.surface,
966 &path,
967 "owner",
968 "Permanently deleted, with its git data".to_owned(),
969 )])
970 .await;
971 Ok(Outcome::Ok(true))
972 }
973
974 /// Removes a deleted repository for good: git data first, so a failure
975 /// leaves it to the next sweep, then its rows; then says so.
976 async fn purge_now(&self, deleted: &DeletedRepo, actor: Option<&str>) -> Result<()> {
977 for key in self.registry.store_keys(&deleted.id).await? {
978 self.store.delete(&key).await?;
979 }
980 self.registry.erase(&deleted.id).await?;
981 // Who had access to it goes with it.
982 if let Some(identity) = &self.identity {
983 let forgotten: Result<bool> = g1t_kit::call(
984 identity,
985 "forget_repo_access",
986 &g1t_contracts::access::ForgetRepoAccessArgs {
987 repo_id: deleted.id.clone(),
988 },
989 )
990 .await;
991 if let Err(error) = forgotten {
992 worker::console_error!("access to {} not forgotten: {error}", deleted.id);
993 }
994 }
995 self.publish(NewEvent {
996 kind: "repo.purged",
997 source: SOURCE,
998 repo_id: Some(deleted.id.clone()),
999 actor: actor.map(str::to_owned),
1000 data: RepoPurged {
1001 repo_id: deleted.id.clone(),
1002 namespace: deleted.namespace.clone(),
1003 name: deleted.name.clone(),
1004 },
1005 })
1006 .await
1007 }
1008
1009 /// `purge_due`: see `g1t_contracts::repos::PurgeDueArgs`.
1010 pub(crate) async fn purge_due(&self, a: PurgeDueArgs) -> Result<u32> {
1011 let limit = a.limit.unwrap_or(PURGES_PER_SWEEP).clamp(1, 100);
1012 let due = self.registry.due(&rfc3339(now_ms()), limit).await?;
1013 let mut purged = 0;
1014 for deleted in due {
1015 match self.purge_now(&deleted, None).await {
1016 Ok(()) => {
1017 purged += 1;
1018 let path = RepoPath {
1019 namespace: deleted.namespace.clone(),
1020 name: deleted.name.clone(),
1021 };
1022 self.record(vec![entry(
1023 g1t_actor(),
1024 "repo.purged",
1025 None,
1026 &path,
1027 "schedule",
1028 format!("Purged {RESTORE_DAYS} days after {} deleted it", deleted.deleted_by),
1029 )])
1030 .await;
1031 }
1032 Err(error) => worker::console_error!("{} not purged: {error}", deleted.id),
1033 }
1034 }
1035 Ok(purged)
1036 }
1037
1038 /// `workspace.deleting`: every live repository of the workspace is
1039 /// deleted with it, marked so its restore brings back exactly these,
1040 /// and `repo.deleted` (with `with_workspace`) tells services to stop
1041 /// what runs for each and hide it. They are purged with the workspace,
1042 /// or by the sweep at the same `purge_after`. Never for a protected
1043 /// workspace, whoever published it.
1044 pub(crate) async fn delete_with_workspace(&self, deleting: &WorkspaceDeleting, protected: &[String]) -> Result<()> {
1045 let namespace = deleting.slug.to_lowercase();
1046 if let Err(why) = may_go_with_workspace(&namespace, protected) {
1047 worker::console_error!("workspace.deleting for {namespace} ignored: {why}");
1048 return Ok(());
1049 }
1050 let marked = self
1051 .registry
1052 .delete_with_workspace(
1053 &namespace,
1054 &deleting.workspace_id,
1055 &deleting.by,
1056 &rfc3339(now_ms()),
1057 &deleting.purge_after,
1058 )
1059 .await?;
1060 for repo in marked {
1061 self.publish(NewEvent {
1062 kind: "repo.deleted",
1063 source: SOURCE,
1064 repo_id: Some(repo.id.clone()),
1065 actor: None,
1066 data: RepoDeleted {
1067 repo_id: repo.id.clone(),
1068 namespace: repo.namespace.clone(),
1069 name: repo.name.clone(),
1070 is_private: repo.is_private,
1071 purge_after: repo.purge_after.clone(),
1072 with_workspace: true,
1073 },
1074 })
1075 .await?;
1076 }
1077 Ok(())
1078 }
1079
1080 /// `workspace.restored`: the repositories deleted with the workspace
1081 /// come back, and `repo.restored` (with `with_workspace`) says so for
1082 /// each. Ones deleted on their own before stay deleted.
1083 pub(crate) async fn restore_with_workspace(&self, restored: &WorkspaceRestored) -> Result<()> {
1084 let marked = self.registry.deleted_with(&restored.workspace_id).await?;
1085 self.registry.undelete_with_workspace(&restored.workspace_id).await?;
1086 for deleted in marked {
1087 let Some(repo) = self.registry.by_id(&deleted.id).await? else {
1088 continue;
1089 };
1090 self.publish(NewEvent {
1091 kind: "repo.restored",
1092 source: SOURCE,
1093 repo_id: Some(repo.id.clone()),
1094 actor: None,
1095 data: RepoRestored {
1096 repo_id: repo.id.clone(),
1097 namespace: repo.namespace.clone(),
1098 name: repo.name.clone(),
1099 is_private: repo.is_private,
1100 with_workspace: true,
1101 },
1102 })
1103 .await?;
1104 }
1105 Ok(())
1106 }
1107
1108 /// `workspace.deleted`: the workspace is purged, and every repository
1109 /// it had goes with it: those deleted with it, those deleted before,
1110 /// and any still live (a `workspace.deleting` that never arrived).
1111 pub(crate) async fn purge_workspace(&self, deleted: &WorkspaceDeleted, protected: &[String]) -> Result<()> {
1112 let namespace = deleted.slug.to_lowercase();
1113 if let Err(why) = may_go_with_workspace(&namespace, protected) {
1114 worker::console_error!("workspace.deleted for {namespace} ignored: {why}");
1115 return Ok(());
1116 }
1117 let now = rfc3339(now_ms());
1118 self.registry
1119 .delete_with_workspace(&namespace, &deleted.workspace_id, "g1t", &now, &now)
1120 .await?;
1121 // A page at a time; one that fails is left to the hourly sweep.
1122 loop {
1123 let page = self.registry.deleted_ids_in(&namespace).await?;
1124 let mut purged = 0;
1125 for repo in &page {
1126 match self.purge_now(repo, None).await {
1127 Ok(()) => purged += 1,
1128 Err(error) => worker::console_error!("{} not purged with its workspace: {error}", repo.id),
1129 }
1130 }
1131 if purged == 0 {
1132 break;
1133 }
1134 }
1135 Ok(())
1136 }
1137
1138 /// `rename`: see `g1t_contracts::repos::RenameArgs`.
1139 pub(crate) async fn rename(&self, a: RenameArgs) -> Result<Outcome<Repo>> {
1140 let repo = match self.owned(&a.actor, &a.path, "rename", Capability::Administer).await? {
1141 Ok(repo) => repo,
1142 Err(refusal) => return Ok(fail(refusal)),
1143 };
1144 let wanted = RepoPath {
1145 namespace: repo.namespace.clone(),
1146 name: a.name.trim().to_lowercase(),
1147 };
1148 let held = match self.registry.by_path_any(&wanted).await? {
1149 None => Held::Free,
1150 Some((_, None)) => Held::ByRepo,
1151 Some((_, Some(_))) => Held::ByDeleted,
1152 };
1153 let name = match new_name(&repo.namespace, &repo.name, &a.name, held) {
1154 Ok(name) => name,
1155 Err(refusal) => return Ok(fail(refusal)),
1156 };
1157 // The git store key stays what it was; the new path must not
1158 // change where it is read from.
1159 let key = store_key(&repo);
1160 self.registry.rename(&repo, &name).await?;
1161 let renamed = Repo {
1162 name: name.clone(),
1163 ..repo.clone()
1164 };
1165 remember_store(&renamed, &key);
1166 let from = path_of(&repo);
1167 let to = path_of(&renamed);
1168 if let Some(identity) = &self.identity {
1169 let moved: Result<bool> = g1t_kit::call(
1170 identity,
1171 "transfer_repo_scopes",
1172 &TransferRepoScopesArgs {
1173 from: from.clone(),
1174 to: to.clone(),
1175 },
1176 )
1177 .await;
1178 if let Err(error) = moved {
1179 worker::console_error!("agent scopes for {} not moved: {error}", repo.id);
1180 }
1181 }
1182 self.publish(NewEvent {
1183 kind: "repo.renamed",
1184 source: SOURCE,
1185 repo_id: Some(repo.id.clone()),
1186 actor: Some(a.actor.id.clone()),
1187 data: RepoRenamed {
1188 repo_id: repo.id.clone(),
1189 namespace: repo.namespace.clone(),
1190 from: repo.name.clone(),
1191 to: name.clone(),
1192 },
1193 })
1194 .await?;
1195 self.record(vec![entry(
1196 AuditActor::of(&a.actor),
1197 "repo.renamed",
1198 a.surface,
1199 &to,
1200 "owner",
1201 format!("Renamed from {}/{}", from.namespace, from.name),
1202 )])
1203 .await;
1204 Ok(Outcome::Ok(renamed))
1205 }
1206
1207 /// `archive`: see `g1t_contracts::repos::ArchiveArgs`.
1208 pub(crate) async fn archive(&self, a: ArchiveArgs) -> Result<Outcome<Repo>> {
1209 let what = if a.archived { "archive" } else { "unarchive" };
1210 let repo = match self.owned(&a.actor, &a.path, what, Capability::Administer).await? {
1211 Ok(repo) => repo,
1212 Err(refusal) => return Ok(fail(refusal)),
1213 };
1214 if repo.archived() == a.archived {
1215 return Ok(Outcome::Ok(repo));
1216 }
1217 let at = a.archived.then(|| rfc3339(now_ms()));
1218 self.registry.set_archived(&repo.id, at.as_deref()).await?;
1219 let changed = Repo {
1220 archived_at: at,
1221 ..repo
1222 };
1223 let kind = if a.archived { "repo.archived" } else { "repo.unarchived" };
1224 self.publish(NewEvent {
1225 kind,
1226 source: SOURCE,
1227 repo_id: Some(changed.id.clone()),
1228 actor: Some(a.actor.id.clone()),
1229 data: RepoArchived {
1230 repo_id: changed.id.clone(),
1231 namespace: changed.namespace.clone(),
1232 name: changed.name.clone(),
1233 archived: a.archived,
1234 },
1235 })
1236 .await?;
1237 self.record(vec![entry(
1238 AuditActor::of(&a.actor),
1239 kind,
1240 a.surface,
1241 &path_of(&changed),
1242 "owner",
1243 if a.archived {
1244 "Archived: read-only".to_owned()
1245 } else {
1246 "Unarchived".to_owned()
1247 },
1248 )])
1249 .await;
1250 Ok(Outcome::Ok(changed))
1251 }
1252
1253 /// `set_visibility`: see `g1t_contracts::repos::SetVisibilityArgs`.
1254 pub(crate) async fn set_visibility(&self, a: SetVisibilityArgs) -> Result<Outcome<Repo>> {
1255 let repo = match self.owned(&a.actor, &a.path, "change the visibility of", Capability::ChangeVisibility).await? {
1256 Ok(repo) => repo,
1257 Err(refusal) => return Ok(fail(refusal)),
1258 };
1259 if !confirmed(&path_of(&repo), &a.confirm) {
1260 return Ok(fail(confirm_refusal(&path_of(&repo))));
1261 }
1262 if let Some(why) = visibility_refusal(&a.actor, &repo, a.is_private) {
1263 return Ok(Outcome::fail(FailureCode::Forbidden, why));
1264 }
1265 self.change_visibility(repo, a.is_private, &a.actor, a.surface).await
1266 }
1267
1268 /// Makes `repo` public or private, if the workspace's storage allows,
1269 /// and says so: `repo.updated` and `repo.visibility_changed`. The
1270 /// caller has checked the actor may.
1271 pub(crate) async fn change_visibility(
1272 &self,
1273 repo: Repo,
1274 private: bool,
1275 actor: &User,
1276 surface: Option<Surface>,
1277 ) -> Result<Outcome<Repo>> {
1278 if repo.is_private == private {
1279 return Ok(Outcome::Ok(repo));
1280 }
1281 let facts = if private {
1282 VisibilityFacts {
1283 to_private: true,
1284 free: git_ops::is_free(self.billing.as_ref(), &repo.namespace).await,
1285 private_bytes: self.registry.private_bytes(&repo.namespace).await.unwrap_or(0),
1286 bytes: self.registry.stored_bytes(&repo.id).await?,
1287 free_private_bytes: self.free_private_bytes,
1288 }
1289 } else {
1290 VisibilityFacts::default()
1291 };
1292 if let Err(refusal) = visibility_check(&repo.namespace, &facts) {
1293 return Ok(fail(refusal));
1294 }
1295 self.registry.set_private(&repo.id, private).await?;
1296 let changed = Repo {
1297 is_private: private,
1298 ..repo
1299 };
1300 self.publish(NewEvent {
1301 kind: "repo.updated",
1302 source: SOURCE,
1303 repo_id: Some(changed.id.clone()),
1304 actor: Some(actor.id.clone()),
1305 data: RepoUpdated {
1306 repo_id: changed.id.clone(),
1307 namespace: changed.namespace.clone(),
1308 name: changed.name.clone(),
1309 is_private: private,
1310 visibility_changed: true,
1311 },
1312 })
1313 .await?;
1314 self.publish(NewEvent {
1315 kind: "repo.visibility_changed",
1316 source: SOURCE,
1317 repo_id: Some(changed.id.clone()),
1318 actor: Some(actor.id.clone()),
1319 data: RepoVisibilityChanged {
1320 repo_id: changed.id.clone(),
1321 is_private: private,
1322 },
1323 })
1324 .await?;
1325 self.record(vec![entry(
1326 AuditActor::of(actor),
1327 "repo.visibility_changed",
1328 surface,
1329 &path_of(&changed),
1330 "owner",
1331 if private { "Made private".to_owned() } else { "Made public".to_owned() },
1332 )])
1333 .await;
1334 Ok(Outcome::Ok(changed))
1335 }
1336
1337 /// The repository at `path` someone is changing the branches of:
1338 /// found, not a working copy, the actor allowed `capability` on it
1339 /// (Push to rename a branch, Administer to change the default),
1340 /// verified, and not archived.
1341 async fn writable_by(
1342 &self,
1343 actor: &User,
1344 path: &RepoPath,
1345 capability: Capability,
1346 ) -> Result<std::result::Result<Repo, Refusal>> {
1347 let viewer = Some(actor.clone());
1348 let Some(repo) = self.readable(path, &viewer).await? else {
1349 return Ok(Err((FailureCode::NotFound, "Repository not found.".into())));
1350 };
1351 if repo.fork_of.is_some() || !crate::registry::can(&repo, &viewer, capability) {
1352 return Ok(Err((
1353 FailureCode::Forbidden,
1354 access::needs(capability, &format!("{}/{}", repo.namespace, repo.name)),
1355 )));
1356 }
1357 if !actor.verified {
1358 return Ok(Err((FailureCode::Forbidden, UNVERIFIED.into())));
1359 }
1360 if let Some(refusal) = archived_refusal(&repo) {
1361 return Ok(Err(refusal));
1362 }
1363 // Moving between namespaces: wait for it (moves.rs).
1364 self.unpaused(repo).await
1365 }
1366
1367 /// `set_default_branch`: see `g1t_contracts::repos::SetDefaultBranchArgs`.
1368 pub(crate) async fn set_default_branch(&self, a: SetDefaultBranchArgs) -> Result<Outcome<Repo>> {
1369 let repo = match self.writable_by(&a.actor, &a.path, Capability::Administer).await? {
1370 Ok(repo) => repo,
1371 Err(refusal) => return Ok(fail(refusal)),
1372 };
1373 let branch = a.branch.trim().to_owned();
1374 if branch == repo.default_branch {
1375 return Ok(Outcome::Ok(repo));
1376 }
1377 let git = self.store.open(&store_key(&repo)).await?;
1378 if !git.branches().await?.iter().any(|b| b.name == branch) {
1379 return Ok(Outcome::fail(
1380 FailureCode::Invalid,
1381 format!("There is no branch named {branch}. Push it first."),
1382 ));
1383 }
1384 self.registry.set_default_branch(&repo.id, &branch).await?;
1385 // HEAD in what git is told follows it.
1386 self.refs_moved(&repo.id).await;
1387 let from = repo.default_branch.clone();
1388 let changed = Repo {
1389 default_branch: branch.clone(),
1390 ..repo
1391 };
1392 self.forks_follow(&changed, &from, &branch, false).await;
1393 self.publish(NewEvent {
1394 kind: "repo.default_branch_changed",
1395 source: SOURCE,
1396 repo_id: Some(changed.id.clone()),
1397 actor: Some(a.actor.id.clone()),
1398 data: RepoDefaultBranchChanged {
1399 repo_id: changed.id.clone(),
1400 from: from.clone(),
1401 to: branch.clone(),
1402 renamed: false,
1403 },
1404 })
1405 .await?;
1406 self.record(vec![entry(
1407 AuditActor::of(&a.actor),
1408 "repo.default_branch_changed",
1409 a.surface,
1410 &path_of(&changed),
1411 "member",
1412 format!("Default branch changed from {from} to {branch}"),
1413 )])
1414 .await;
1415 Ok(Outcome::Ok(changed))
1416 }
1417
1418 /// `rename_branch`: see `g1t_contracts::repos::RenameBranchArgs`.
1419 pub(crate) async fn rename_branch(&self, a: RenameBranchArgs) -> Result<Outcome<Repo>> {
1420 let repo = match self.writable_by(&a.actor, &a.path, Capability::Push).await? {
1421 Ok(repo) => repo,
1422 Err(refusal) => return Ok(fail(refusal)),
1423 };
1424 let from = a.from.trim().to_owned();
1425 let is_default = from == repo.default_branch;
1426 if is_default
1427 && let Err(refusal) = admin_only(
1428 Asker::on(&a.actor, &repo),
1429 &repo.namespace,
1430 "rename the default branch of",
1431 Capability::Administer,
1432 )
1433 {
1434 return Ok(fail(refusal));
1435 }
1436 let git = self.store.open(&store_key(&repo)).await?;
1437 let branches = git.branches().await?;
1438 let names: Vec<String> = branches.iter().map(|b| b.name.clone()).collect();
1439 let to = match branch_rename(&from, &a.to, &names) {
1440 Ok(to) => to,
1441 Err(refusal) => return Ok(fail(refusal)),
1442 };
1443 let Some(head) = branches.iter().find(|b| b.name == from).map(|b| b.hash.clone()) else {
1444 return Ok(not_found());
1445 };
1446 // A rename deletes one name and creates another: the rules of both
1447 // hold (rules.rs).
1448 let renamed = vec![
1449 g1t_rules::push::RefChange {
1450 git_ref: format!("refs/heads/{from}"),
1451 old: Some(head.clone()),
1452 new: None,
1453 complete: true,
1454 ..Default::default()
1455 },
1456 g1t_rules::push::RefChange {
1457 git_ref: format!("refs/heads/{to}"),
1458 old: None,
1459 new: Some(head.clone()),
1460 complete: true,
1461 ..Default::default()
1462 },
1463 ];
1464 if let crate::rules::Ruled::Refused { message, .. } =
1465 self.check_changes(&repo, &a.actor, g1t_contracts::rules::Action::RenameRef, renamed).await?
1466 {
1467 return Ok(Outcome::fail(FailureCode::Forbidden, message));
1468 }
1469 let access = git.access(Scope::Write).await?;
1470 let made = land::push_pack(&access, &to, None, &head, EMPTY_PACK.to_vec()).await?;
1471 self.refs_moved(&repo.id).await;
1472 if let Err(reason) = made {
1473 return Ok(Outcome::fail(FailureCode::Conflict, format!("{to} could not be made: {reason}")));
1474 }
1475 // The default moves before the old name goes, so it never names a
1476 // branch that is not there.
1477 if is_default {
1478 self.registry.set_default_branch(&repo.id, &to).await?;
1479 }
1480 let removed = land::delete_ref(&access, &from, &head).await;
1481 self.refs_moved(&repo.id).await;
1482 if let Err(reason) = removed? {
1483 worker::console_error!("{from} not removed after renaming it to {to}: {reason}");
1484 }
1485 self.registry.add_branch_redirect(&repo.id, &from, &to).await?;
1486 let changed = if is_default {
1487 Repo {
1488 default_branch: to.clone(),
1489 ..repo
1490 }
1491 } else {
1492 repo
1493 };
1494 if is_default {
1495 self.forks_follow(&changed, &from, &to, true).await;
1496 }
1497 self.publish(NewEvent {
1498 kind: "branch.renamed",
1499 source: SOURCE,
1500 repo_id: Some(changed.id.clone()),
1501 actor: Some(a.actor.id.clone()),
1502 data: BranchRenamed {
1503 repo_id: changed.id.clone(),
1504 from: from.clone(),
1505 to: to.clone(),
1506 default_branch: is_default,
1507 },
1508 })
1509 .await?;
1510 if is_default {
1511 self.publish(NewEvent {
1512 kind: "repo.default_branch_changed",
1513 source: SOURCE,
1514 repo_id: Some(changed.id.clone()),
1515 actor: Some(a.actor.id.clone()),
1516 data: RepoDefaultBranchChanged {
1517 repo_id: changed.id.clone(),
1518 from: from.clone(),
1519 to: to.clone(),
1520 renamed: true,
1521 },
1522 })
1523 .await?;
1524 }
1525 self.record(vec![entry(
1526 AuditActor::of(&a.actor),
1527 "branch.renamed",
1528 a.surface,
1529 &path_of(&changed),
1530 if is_default { "owner" } else { "member" },
1531 format!("Branch {from} renamed to {to}"),
1532 )])
1533 .await;
1534 Ok(Outcome::Ok(changed))
1535 }
1536
1537 /// `create_branch`: see `g1t_contracts::repos::CreateBranchArgs`.
1538 pub(crate) async fn create_branch(&self, a: CreateBranchArgs) -> Result<Outcome<Branch>> {
1539 let repo = match self.writable_by(&a.actor, &a.path, Capability::Push).await? {
1540 Ok(repo) => repo,
1541 Err(refusal) => return Ok(fail(refusal)),
1542 };
1543 let git = self.store.open(&store_key(&repo)).await?;
1544 let branches = git.branches().await?;
1545 let name = match branch_creation(&a.name, &branches) {
1546 Ok(name) => name,
1547 Err(refusal) => return Ok(fail(refusal)),
1548 };
1549 let from = a.from.trim();
1550 let from = if from.is_empty() { repo.default_branch.as_str() } else { from };
1551 // A branch by its name, else whatever git makes of it: a tag or a commit.
1552 let head = match branches.iter().find(|branch| branch.name == from) {
1553 Some(branch) => Some(branch.hash.clone()),
1554 None => git.log(from, 1).await?.into_iter().next().map(|commit| commit.hash),
1555 };
1556 let Some(head) = head else {
1557 return Ok(Outcome::fail(FailureCode::NotFound, format!("There is no branch, tag or commit {from}.")));
1558 };
1559 let made = vec![g1t_rules::push::RefChange {
1560 git_ref: format!("refs/heads/{name}"),
1561 old: None,
1562 new: Some(head.clone()),
1563 complete: true,
1564 ..Default::default()
1565 }];
1566 if let crate::rules::Ruled::Refused { message, .. } =
1567 self.check_changes(&repo, &a.actor, g1t_contracts::rules::Action::CreateRef, made).await?
1568 {
1569 return Ok(Outcome::fail(FailureCode::Forbidden, message));
1570 }
1571 let access = git.access(Scope::Write).await?;
1572 let pushed = land::push_pack(&access, &name, None, &head, EMPTY_PACK.to_vec()).await?;
1573 self.refs_moved(&repo.id).await;
1574 if let Err(reason) = pushed {
1575 return Ok(Outcome::fail(FailureCode::Conflict, format!("{name} could not be made: {reason}")));
1576 }
1577 self.publish_push(&repo, &format!("refs/heads/{name}"), None, &head, Some(&a.actor), Some(0)).await?;
1578 self.record(vec![entry(
1579 AuditActor::of(&a.actor),
1580 "branch.created",
1581 a.surface,
1582 &path_of(&repo),
1583 "member",
1584 format!("Branch {name} created at {}", &head[..head.len().min(7)]),
1585 )])
1586 .await;
1587 Ok(Outcome::Ok(Branch { name, hash: head }))
1588 }
1589
1590 /// `remove_branch`: see `g1t_contracts::repos::RemoveBranchArgs`.
1591 pub(crate) async fn remove_branch(&self, a: RemoveBranchArgs) -> Result<Outcome<Branch>> {
1592 let repo = match self.writable_by(&a.actor, &a.path, Capability::Push).await? {
1593 Ok(repo) => repo,
1594 Err(refusal) => return Ok(fail(refusal)),
1595 };
1596 let branch = a.branch.trim().to_owned();
1597 let git = self.store.open(&store_key(&repo)).await?;
1598 let branches = git.branches().await?;
1599 let head = match branch_removal(&branch, &repo.default_branch, a.head.as_deref(), &branches) {
1600 Ok(head) => head,
1601 Err(refusal) => return Ok(fail(refusal)),
1602 };
1603 let removed = vec![g1t_rules::push::RefChange {
1604 git_ref: format!("refs/heads/{branch}"),
1605 old: Some(head.clone()),
1606 new: None,
1607 complete: true,
1608 ..Default::default()
1609 }];
1610 if let crate::rules::Ruled::Refused { message, .. } =
1611 self.check_changes(&repo, &a.actor, g1t_contracts::rules::Action::DeleteRef, removed).await?
1612 {
1613 return Ok(Outcome::fail(FailureCode::Forbidden, message));
1614 }
1615 let access = git.access(Scope::Write).await?;
1616 let deleted = land::delete_ref(&access, &branch, &head).await?;
1617 self.refs_moved(&repo.id).await;
1618 if let Err(reason) = deleted {
1619 return Ok(Outcome::fail(FailureCode::Conflict, format!("{branch} could not be deleted: {reason}")));
1620 }
1621 let git_ref = format!("refs/heads/{branch}");
1622 self.publish_deleted(&repo, &[(git_ref, head.clone())], Some(&a.actor.id), None).await?;
1623 self.record(vec![entry(
1624 AuditActor::of(&a.actor),
1625 "branch.deleted",
1626 a.surface,
1627 &path_of(&repo),
1628 "member",
1629 format!("Branch {branch} deleted at {}", &head[..head.len().min(7)]),
1630 )])
1631 .await;
1632 Ok(Outcome::Ok(Branch { name: branch, hash: head }))
1633 }
1634
1635 /// Pull requests' working copies name their branch after the default
1636 /// branch of the repository they came from. When it changes, the
1637 /// newest of them get a branch of the new name at the same commit (and,
1638 /// for a rename, lose the old one), so agents and merges find it.
1639 /// Best effort: a copy that cannot follow is logged and left.
1640 async fn forks_follow(&self, repo: &Repo, from: &str, to: &str, renamed: bool) {
1641 let forks = match self.registry.forks_of(&repo.id, FORKS_FOLLOWING).await {
1642 Ok(forks) => forks,
1643 Err(error) => {
1644 worker::console_error!("working copies of {} not listed: {error}", repo.id);
1645 return;
1646 }
1647 };
1648 for fork in forks {
1649 let followed: Result<()> = async {
1650 let git = self.store.open(&store_key(&fork)).await?;
1651 let branches = git.branches().await?;
1652 let Some(head) = branches.iter().find(|b| b.name == from).map(|b| b.hash.clone()) else {
1653 return Ok(());
1654 };
1655 let access = git.access(Scope::Write).await?;
1656 if !branches.iter().any(|b| b.name == to) {
1657 let made = land::push_pack(&access, to, None, &head, EMPTY_PACK.to_vec()).await;
1658 self.refs_moved(&fork.id).await;
1659 if let Err(reason) = made? {
1660 worker::console_error!("working copy {} did not get {to}: {reason}", fork.id);
1661 return Ok(());
1662 }
1663 }
1664 self.registry.set_default_branch(&fork.id, to).await?;
1665 if renamed {
1666 let removed = land::delete_ref(&access, from, &head).await;
1667 self.refs_moved(&fork.id).await;
1668 if let Err(reason) = removed? {
1669 worker::console_error!("working copy {} kept {from}: {reason}", fork.id);
1670 }
1671 }
1672 Ok(())
1673 }
1674 .await;
1675 if let Err(error) = followed {
1676 worker::console_error!("working copy {} did not follow {from} → {to}: {error}", fork.id);
1677 }
1678 }
1679 }
1680
1681 /// `resolve_branch`: see `g1t_contracts::repos::ResolveBranchArgs`.
1682 pub(crate) async fn resolve_branch(&self, a: ResolveBranchArgs) -> Result<Option<String>> {
1683 let Some(now) = self.registry.branch_redirect(&a.repo_id, &a.branch).await? else {
1684 return Ok(None);
1685 };
1686 // A branch made again under the old name ends the redirect.
1687 let Some(repo) = self.registry.by_id(&a.repo_id).await? else {
1688 return Ok(None);
1689 };
1690 let git = self.store.open(&store_key(&repo)).await?;
1691 let branches = git.branches().await?;
1692 if branches.iter().any(|b| b.name == a.branch) || !branches.iter().any(|b| b.name == now) {
1693 return Ok(None);
1694 }
1695 Ok(Some(now))
1696 }
1697
1698 /// `status_by_id`: see `g1t_contracts::repos::StatusByIdArgs`.
1699 pub(crate) async fn status_by_id(&self, a: StatusByIdArgs) -> Result<RepoStatus> {
1700 self.registry.status(&a.id).await
1701 }
1702}
1703
1704#[cfg(test)]
1705mod tests {
1706 use super::*;
1707
1708 fn owner() -> Asker {
1709 Asker {
1710 person: true,
1711 verified: true,
1712 role: Some(Role::Owner),
1713 repo_role: Some(RepoRole::Admin),
1714 privileges: g1t_contracts::MemberPrivileges::default(),
1715 }
1716 }
1717
1718 fn path() -> RepoPath {
1719 RepoPath {
1720 namespace: "acme".into(),
1721 name: "rocket".into(),
1722 }
1723 }
1724
1725 #[test]
1726 fn only_a_verified_person_who_owns_the_workspace_may() {
1727 assert!(owner_only(owner(), "acme", "delete").is_ok());
1728 let member = Asker { role: Some(Role::Member), ..owner() };
1729 let (code, message) = owner_only(member, "acme", "delete").unwrap_err();
1730 assert_eq!(code, FailureCode::Forbidden);
1731 assert_eq!(message, "Only an owner of acme can delete its repositories.");
1732 assert_eq!(owner_only(Asker { person: false, ..owner() }, "acme", "delete").unwrap_err().0, FailureCode::Forbidden);
1733 assert_eq!(owner_only(Asker { verified: false, ..owner() }, "acme", "delete").unwrap_err().0, FailureCode::Forbidden);
1734 // Outside the workspace, a private repository is not there at all.
1735 assert_eq!(owner_only(Asker { role: None, ..owner() }, "acme", "delete").unwrap_err().0, FailureCode::NotFound);
1736 }
1737
1738 /// Renaming, archiving and changing visibility take Admin on the
1739 /// repository, which a direct grant can give; deleting and
1740 /// transferring still take an owner of the workspace.
1741 #[test]
1742 fn admin_on_the_repository_may_administer_but_not_delete() {
1743 let admin = Asker { role: None, repo_role: Some(RepoRole::Admin), ..owner() };
1744 assert!(admin_only(admin, "acme", "rename", Capability::Administer).is_ok());
1745 let (code, message) = admin_only(admin, "acme", "delete", Capability::Delete).unwrap_err();
1746 assert_eq!(code, FailureCode::Forbidden);
1747 assert_eq!(message, "Only an owner of acme can delete its repositories.");
1748 let member_admin = Asker { role: Some(Role::Member), ..admin };
1749 assert_eq!(admin_only(member_admin, "acme", "delete", Capability::Delete).unwrap_err().0, FailureCode::Forbidden);
1750 // Write (the default base permission) cannot rename.
1751 // By default a member with Admin changes visibility but does not
1752 // delete; the workspace's member privileges change both.
1753 assert!(admin_only(member_admin, "acme", "change the visibility of", Capability::ChangeVisibility).is_ok());
1754 let open = Asker {
1755 privileges: g1t_contracts::MemberPrivileges { members_can_delete_repositories: true, ..g1t_contracts::MemberPrivileges::default() },
1756 ..member_admin
1757 };
1758 assert!(admin_only(open, "acme", "delete", Capability::Delete).is_ok());
1759 let closed = Asker {
1760 privileges: g1t_contracts::MemberPrivileges { members_can_change_repo_visibility: false, ..g1t_contracts::MemberPrivileges::default() },
1761 ..member_admin
1762 };
1763 assert_eq!(
1764 admin_only(closed, "acme", "change the visibility of", Capability::ChangeVisibility).unwrap_err().0,
1765 FailureCode::Forbidden
1766 );
1767 // An outside collaborator with Admin never can.
1768 assert_eq!(admin_only(Asker { privileges: open.privileges, ..admin }, "acme", "delete", Capability::Delete).unwrap_err().0, FailureCode::Forbidden);
1769 let writer = Asker { role: Some(Role::Member), repo_role: Some(RepoRole::Write), ..owner() };
1770 let (code, message) = admin_only(writer, "acme", "rename", Capability::Administer).unwrap_err();
1771 assert_eq!(code, FailureCode::Forbidden);
1772 assert_eq!(message, "You need the Admin role on a repository of acme to rename it.");
1773 // Someone who can read a public repository is refused, not told it is missing.
1774 let reader = Asker { role: None, repo_role: Some(RepoRole::Read), ..owner() };
1775 assert_eq!(admin_only(reader, "acme", "archive", Capability::Administer).unwrap_err().0, FailureCode::Forbidden);
1776 let stranger = Asker { role: None, repo_role: None, ..owner() };
1777 assert_eq!(admin_only(stranger, "acme", "archive", Capability::Administer).unwrap_err().0, FailureCode::NotFound);
1778 assert_eq!(admin_only(Asker { person: false, ..owner() }, "acme", "rename", Capability::Administer).unwrap_err().0, FailureCode::Forbidden);
1779 }
1780
1781 #[test]
1782 fn a_workspace_restore_brings_back_only_what_went_with_it() {
1783 assert!(comes_back_with(Some("wsp_1"), "wsp_1"));
1784 // Deleted on its own before the workspace was.
1785 assert!(!comes_back_with(None, "wsp_1"));
1786 // Went with another workspace (it was transferred since).
1787 assert!(!comes_back_with(Some("wsp_2"), "wsp_1"));
1788 }
1789
1790 #[test]
1791 fn a_protected_workspace_keeps_its_repositories_whatever_is_published() {
1792 let protected = g1t_contracts::identity::protected_names(None);
1793 assert_eq!(
1794 may_go_with_workspace("flagon-io", &protected).unwrap_err(),
1795 "flagon-io is protected and can never be deleted."
1796 );
1797 assert!(may_go_with_workspace("FLAGON-IO", &protected).is_err());
1798 assert!(may_go_with_workspace("acme", &protected).is_ok());
1799 let configured = g1t_contracts::identity::protected_names(Some("acme"));
1800 assert!(may_go_with_workspace("acme", &configured).is_err());
1801 }
1802
1803 #[test]
1804 fn the_full_name_confirms_in_any_case() {
1805 assert!(confirmed(&path(), "acme/rocket"));
1806 assert!(confirmed(&path(), " ACME/Rocket "));
1807 assert!(!confirmed(&path(), "rocket"));
1808 assert!(!confirmed(&path(), ""));
1809 }
1810
1811 #[test]
1812 fn a_deleted_repository_is_restorable_for_thirty_days_then_due() {
1813 let deleted_at = 1_790_000_000_000u64;
1814 let purge = purge_after(deleted_at);
1815 assert_eq!(purge, rfc3339(deleted_at + 30 * 86_400_000));
1816 let day = 86_400_000u64;
1817 let at = |ms: u64| rfc3339(ms);
1818 assert_eq!(state(None, None, &at(deleted_at)), State::Active);
1819 assert_eq!(state(Some("2026-10-01T00:00:00.000Z"), None, &at(deleted_at)), State::Archived);
1820 let deleted = Some((at(deleted_at), purge.clone()));
1821 let deleted = deleted.as_ref().map(|(a, b)| (a.as_str(), b.as_str()));
1822 assert_eq!(state(None, deleted, &at(deleted_at + day)), State::Deleted);
1823 assert_eq!(state(None, deleted, &at(deleted_at + 30 * day - 1)), State::Deleted);
1824 assert_eq!(state(None, deleted, &at(deleted_at + 30 * day)), State::Due);
1825 // Archived and then deleted: deleted is what counts.
1826 assert_eq!(state(Some("x"), deleted, &at(deleted_at + day)), State::Deleted);
1827 assert!(restorable(&purge, &at(deleted_at + 29 * day)));
1828 assert!(!restorable(&purge, &at(deleted_at + 31 * day)));
1829 }
1830
1831 #[test]
1832 fn a_rename_needs_a_valid_free_name() {
1833 assert_eq!(new_name("acme", "rocket", " Booster ", Held::Free).unwrap(), "booster");
1834 assert_eq!(new_name("acme", "rocket", "rocket", Held::Free).unwrap_err().0, FailureCode::Invalid);
1835 assert_eq!(new_name("acme", "rocket", "no spaces", Held::Free).unwrap_err().0, FailureCode::Invalid);
1836 assert_eq!(new_name("acme", "rocket", "x.git", Held::Free).unwrap_err().0, FailureCode::Invalid);
1837 let (code, message) = new_name("acme", "rocket", "booster", Held::ByRepo).unwrap_err();
1838 assert_eq!(code, FailureCode::Conflict);
1839 assert_eq!(message, "acme already has a repository named booster.");
1840 let (code, message) = new_name("acme", "rocket", "booster", Held::ByDeleted).unwrap_err();
1841 assert_eq!(code, FailureCode::Conflict);
1842 assert!(message.contains("deleted recently"));
1843 }
1844
1845 fn repo(archived: bool) -> Repo {
1846 Repo {
1847 id: "rep_1".into(),
1848 namespace: "acme".into(),
1849 name: "rocket".into(),
1850 description: None,
1851 is_private: false,
1852 owner_id: "usr_1".into(),
1853 default_branch: "main".into(),
1854 fork_of: None,
1855 protected: false,
1856 created_at: String::new(),
1857 topics: Vec::new(),
1858 website: None,
1859 archived_at: archived.then(|| "2026-10-05T00:00:00.000Z".to_owned()),
1860 }
1861 }
1862
1863 #[test]
1864 fn an_archived_repository_refuses_writes() {
1865 let (code, message) = read_only_refusal(&repo(true)).unwrap();
1866 assert_eq!(code, FailureCode::Forbidden);
1867 assert!(message.contains("archived"));
1868 assert!(read_only_refusal(&repo(false)).is_none());
1869 }
1870
1871 #[test]
1872 fn an_archived_repository_refuses_writes_with_the_reason() {
1873 assert!(archived_refusal(&repo(false)).is_none());
1874 let (code, message) = archived_refusal(&repo(true)).unwrap();
1875 assert_eq!(code, FailureCode::Forbidden);
1876 assert_eq!(message, "acme/rocket is archived, so it is read-only. An owner can unarchive it in its settings.");
1877 }
1878
1879 #[test]
1880 fn going_private_on_a_free_workspace_needs_room() {
1881 let full = VisibilityFacts {
1882 to_private: true,
1883 free: true,
1884 private_bytes: 900_000_000,
1885 bytes: 200_000_000,
1886 free_private_bytes: 1_000_000_000,
1887 };
1888 assert_eq!(visibility_check("acme", &full).unwrap_err().0, FailureCode::PaymentRequired);
1889 assert!(visibility_check("acme", &VisibilityFacts { free: false, ..full }).is_ok());
1890 let full = VisibilityFacts {
1891 to_private: true,
1892 free: true,
1893 private_bytes: 900_000_000,
1894 bytes: 200_000_000,
1895 free_private_bytes: 1_000_000_000,
1896 };
1897 // Going public is never refused.
1898 assert!(visibility_check("acme", &VisibilityFacts { to_private: false, ..full }).is_ok());
1899 let light = VisibilityFacts {
1900 to_private: true,
1901 free: true,
1902 private_bytes: 1_000,
1903 bytes: 1_000,
1904 free_private_bytes: 1_000_000_000,
1905 };
1906 assert!(visibility_check("acme", &light).is_ok());
1907 }
1908
1909 #[test]
1910 fn a_branch_is_renamed_to_a_free_valid_name() {
1911 let branches = vec!["main".to_owned(), "dev".to_owned()];
1912 assert_eq!(branch_rename("main", " trunk ", &branches).unwrap(), "trunk");
1913 assert_eq!(branch_rename("nope", "trunk", &branches).unwrap_err().0, FailureCode::NotFound);
1914 assert_eq!(branch_rename("main", "dev", &branches).unwrap_err().0, FailureCode::Conflict);
1915 assert_eq!(branch_rename("main", "main", &branches).unwrap_err().0, FailureCode::Invalid);
1916 assert_eq!(branch_rename("main", "a b", &branches).unwrap_err().0, FailureCode::Invalid);
1917 assert_eq!(branch_rename("main", "g1t-queue", &branches).unwrap_err().0, FailureCode::Invalid);
1918 }
1919
1920 fn branch(name: &str, hash: &str) -> Branch {
1921 Branch { name: name.to_owned(), hash: hash.to_owned() }
1922 }
1923
1924 #[test]
1925 fn a_branch_is_made_with_a_free_valid_name_that_is_no_other_branch_folder() {
1926 let branches = vec![branch("main", "aaa"), branch("feature", "bbb"), branch("fix/login", "ccc")];
1927 assert_eq!(branch_creation(" docs/intro ", &branches).unwrap(), "docs/intro");
1928 assert_eq!(branch_creation("main", &branches).unwrap_err().0, FailureCode::Conflict);
1929 // `feature` is a branch, so it cannot also be a folder of one.
1930 assert_eq!(branch_creation("feature/new", &branches).unwrap_err().0, FailureCode::Conflict);
1931 // `fix` holds `fix/login`, so it cannot be a branch itself.
1932 assert_eq!(branch_creation("fix", &branches).unwrap_err().0, FailureCode::Conflict);
1933 assert!(branch_creation("fixes", &branches).is_ok());
1934 assert_eq!(branch_creation("a b", &branches).unwrap_err().0, FailureCode::Invalid);
1935 assert_eq!(branch_creation("g1t-queue/1", &branches).unwrap_err().0, FailureCode::Invalid);
1936 assert_eq!(branch_creation("", &branches).unwrap_err().0, FailureCode::Invalid);
1937 }
1938
1939 #[test]
1940 fn a_branch_is_deleted_only_when_it_is_not_the_default_and_has_not_moved() {
1941 let branches = vec![branch("main", "aaa"), branch("feature", "bbb")];
1942 assert_eq!(branch_removal("feature", "main", None, &branches).unwrap(), "bbb");
1943 assert_eq!(branch_removal("feature", "main", Some("bbb"), &branches).unwrap(), "bbb");
1944 assert_eq!(branch_removal("feature", "main", Some(""), &branches).unwrap(), "bbb");
1945 assert_eq!(branch_removal("feature", "main", Some("ccc"), &branches).unwrap_err().0, FailureCode::Conflict);
1946 assert_eq!(branch_removal("main", "main", None, &branches).unwrap_err().0, FailureCode::Forbidden);
1947 assert_eq!(branch_removal("gone", "main", None, &branches).unwrap_err().0, FailureCode::NotFound);
1948 }
1949
1950 #[test]
1951 fn the_empty_pack_is_well_formed() {
1952 assert_eq!(EMPTY_PACK.len(), 32);
1953 assert!(EMPTY_PACK.starts_with(b"PACK\0\0\0\x02\0\0\0\0"));
1954 }
1955}