forklaunch 1.32.0

Launch faster with forklaunch
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92

use std::io::Write;

use anyhow::{Context, Result};
use clap::{Arg, ArgAction, ArgMatches, Command};
use termcolor::{ColorChoice, StandardStream, WriteColor};

use crate::{
    CliCommand,
    core::command::command,
    managed::client::{
        Missing, delete_text, print_dryrun, require_managed_mode, resolve_managed_auth,
    },
};

#[derive(Debug)]
pub(super) struct ClearAppClaimHookCommand;

impl ClearAppClaimHookCommand {
    pub(super) fn new() -> Self {
        Self
    }
}

impl CliCommand for ClearAppClaimHookCommand {
    fn command(&self) -> Command {
        command(
            "clear-app-claim-hook",
            "Stop asking this product to mint its own sign-up link",
        )
        .long_about(
            "Stop asking this product to mint its own sign-up link.\n\n\
             With a hook declared, the platform calls the product the moment a customer\n\
             claims an instance and holds the link it returns. Clearing it means new\n\
             instances get the platform claim only, and whoever operates the product hands\n\
             out the first login some other way.\n\n\
             THIS IS A SEPARATE COMMAND RATHER THAN A FLAG ON `update`, and the reason is\n\
             worth stating: the PATCH's documentation used to say passing `null` withdrew\n\
             the hook, while the schema rejected null outright — an object field has no\n\
             nullable form in this validator. So the documented way to turn a hook off did\n\
             not exist, and nobody found out until they tried. Withdrawing something is an\n\
             action, and it gets a verb.\n\n\
             This affects instances launched AFTERWARDS. An instance that already holds a\n\
             minted link keeps it, and clearing the hook does not revoke a link already\n\
             given to a customer.",
        )
        .arg(
            Arg::new("slug")
                .long("slug")
                .required(true)
                .help("Slug of the template whose app claim hook should be withdrawn"),
        )
        .arg(
            Arg::new("dryrun")
                .long("dryrun")
                .help("Print the request that would be sent without sending it")
                .action(ArgAction::SetTrue),
        )
    }

    fn handler(&self, matches: &ArgMatches) -> Result<()> {
        let mut stdout = StandardStream::stdout(ColorChoice::Always);

        let slug = matches
            .get_one::<String>("slug")
            .context("--slug is required")?;
        let path = format!("/templates/{}/app-claim-hook", urlencoding::encode(slug));

        if matches.get_flag("dryrun") {
            return print_dryrun("DELETE", &path, None);
        }

        let auth_mode = resolve_managed_auth()?;
        require_managed_mode(&auth_mode)?;

        delete_text(&path, Missing::Resource(format!("template '{}'", slug)))?;

        writeln!(stdout)?;
        log_ok!(
            stdout,
            "Template '{}' no longer declares an app claim hook.",
            slug
        );
        log_info!(
            stdout,
            "Instances launched from now on get the platform claim link only. Declare it again with: forklaunch managed template update --slug {} --app-claim-hook <component>:<path>",
            slug
        );
        writeln!(stdout)?;

        Ok(())
    }
}