g1t/services/billing/src/rename.rs

318 lines18,233 bytesCodeBlame

Pick any line to see why it is the way it is: the commit, the pull request and issue it came from, and what the agent was thinking.

Agents and memory, checks and conflicts, profiles, slug renames, custom domains1//! A workspace renamed: everything billing keeps under its slug moves to
2//! the new one.
3//!
4//! Identity publishes `workspace.renamed` with the old and new slugs. The
5//! handler asks identity what the workspace is called now, so that a late
6//! or repeated delivery still converges on the current slug, and moves the
7//! rows of each stale slug in one D1 batch (one transaction).
8//!
9//! Rows may already exist under the current slug: usage recorded in the
10//! seconds between the rename and this event. Those are merged, never
11//! dropped where money is concerned: balances are summed, sandbox seconds
12//! are summed, and owners' limits are kept field by field.
13
14use g1t_contracts::events::{Event, WorkspaceRenamed};
15use g1t_contracts::identity::UsernamesArgs;
16use serde::Deserialize;
17use serde_json::Value;
18use worker::wasm_bindgen::JsValue;
19use worker::{Fetcher, Result};
20
21use crate::Billing;
22use crate::accounts::own_account;
23
24/// The event this module handles.
25pub(crate) const RENAMED: &str = "workspace.renamed";
26
27/// The statements that move one stale slug's rows to the current slug, in
28/// order. Parameters: `?1` the current slug, `?2` the stale one, `?3` and
29/// `?4` their own billing accounts (`ws_<slug>`).
30///
31/// Every statement is a no-op once the stale slug has no rows, so running
32/// the batch again changes nothing.
33pub(crate) const STATEMENTS: &[&str] = &[
34 // Plain rows: many per workspace, keyed by their own id.
35 "UPDATE ledger SET workspace = ?1 WHERE workspace = ?2",
36 "UPDATE runs SET workspace = ?1 WHERE workspace = ?2",
37 "UPDATE checkouts SET workspace = ?1 WHERE workspace = ?2",
38 "UPDATE workspace_invoices SET workspace = ?1 WHERE workspace = ?2",
39 "UPDATE sales_notes SET workspace = ?1 WHERE workspace = ?2",
40 // Repositories are named `<slug>/<name>`. Compared exactly rather than
41 // with LIKE, so nothing in a slug is read as a wildcard.
42 "UPDATE ledger SET repo = ?1 || substr(repo, length(?2) + 1) WHERE substr(repo, 1, length(?2) + 1) = ?2 || '/'",
43 "UPDATE runs SET repo = ?1 || substr(repo, length(?2) + 1) WHERE substr(repo, 1, length(?2) + 1) = ?2 || '/'",
44 // The balance is the sum of the ledger, and both ledgers are now the
45 // current slug's: the balances add. The older customer (with the card
46 // and the payment history) is kept when both have one.
47 "INSERT INTO accounts (workspace, balance_micros, customer_id, created_at)
48 SELECT ?1, balance_micros, customer_id, created_at FROM accounts WHERE workspace = ?2
49 ON CONFLICT (workspace) DO UPDATE SET
50 balance_micros = accounts.balance_micros + excluded.balance_micros,
51 customer_id = COALESCE(excluded.customer_id, accounts.customer_id),
52 created_at = MIN(accounts.created_at, excluded.created_at)",
53 "DELETE FROM accounts WHERE workspace = ?2",
54 // Replaced on each report with the month's whole figure: the newer
55 // report wins.
status.g1t.sh with incident management, invites that land you in the workspace, settings as pages, usage without quotas56 "INSERT INTO pending_usage (workspace, source, month, charge_micros, cost_micros, charged_at, updated_at, detail)
57 SELECT ?1, source, month, charge_micros, cost_micros, charged_at, updated_at, detail FROM pending_usage WHERE workspace = ?2
Agents and memory, checks and conflicts, profiles, slug renames, custom domains58 ON CONFLICT (workspace, source, month) DO UPDATE SET
59 charge_micros = CASE WHEN excluded.updated_at > pending_usage.updated_at
60 THEN excluded.charge_micros ELSE pending_usage.charge_micros END,
Team plan, an open-source pool, monthly trials and honest metering; the sidebar for everyone; a workspace that stays put61 cost_micros = CASE WHEN excluded.updated_at > pending_usage.updated_at
62 THEN excluded.cost_micros ELSE pending_usage.cost_micros END,
status.g1t.sh with incident management, invites that land you in the workspace, settings as pages, usage without quotas63 detail = CASE WHEN excluded.updated_at > pending_usage.updated_at
64 THEN excluded.detail ELSE pending_usage.detail END,
Team plan, an open-source pool, monthly trials and honest metering; the sidebar for everyone; a workspace that stays put65 charged_at = COALESCE(pending_usage.charged_at, excluded.charged_at),
Agents and memory, checks and conflicts, profiles, slug renames, custom domains66 updated_at = MAX(pending_usage.updated_at, excluded.updated_at)",
67 "DELETE FROM pending_usage WHERE workspace = ?2",
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look68 // Monthly allowances drawn by the workspace (its plan's included usage,
69 // its build time) add up; a repository's share of the open-source pool
Team plan, an open-source pool, monthly trials and honest metering; the sidebar for everyone; a workspace that stays put70 // follows the repository's new name.
71 "INSERT INTO allowance_use (kind, scope, month, used)
72 SELECT kind, ?1, month, used FROM allowance_use WHERE scope = ?2
73 ON CONFLICT (kind, scope, month) DO UPDATE SET used = allowance_use.used + excluded.used",
74 "DELETE FROM allowance_use WHERE scope = ?2",
75 "UPDATE OR IGNORE allowance_use SET scope = ?1 || substr(scope, length(?2) + 1)
76 WHERE kind = 'oss_repo' AND substr(scope, 1, length(?2) + 1) = ?2 || '/'",
77 // One trial grant per workspace: the current slug's stays if it has one.
78 "UPDATE OR IGNORE trial_grants SET workspace = ?1 WHERE workspace = ?2",
79 "DELETE FROM trial_grants WHERE workspace = ?2",
80 "UPDATE OR IGNORE storage_days SET workspace = ?1 WHERE workspace = ?2",
81 "DELETE FROM storage_days WHERE workspace = ?2",
Billing: a workspace rename moves its token usage, package storage, month-end snapshots, price notices, cost and count rows, margin alert and budget alerts too; a test keeps the rename and the reset naming the same tables82 "UPDATE OR IGNORE package_storage_days SET workspace = ?1 WHERE workspace = ?2",
83 "DELETE FROM package_storage_days WHERE workspace = ?2",
84 // Month-end snapshots, by day: the current slug's stays if it has one.
85 "UPDATE OR IGNORE pending_days SET workspace = ?1 WHERE workspace = ?2",
86 "DELETE FROM pending_days WHERE workspace = ?2",
87 // Model tokens, by day, person, session and model: the counts add.
88 "INSERT INTO token_usage (day, workspace, person, session, model, tier, input, output, cache_read, cache_write, requests)
89 SELECT day, ?1, person, session, model, tier, input, output, cache_read, cache_write, requests FROM token_usage WHERE workspace = ?2
90 ON CONFLICT (day, workspace, person, session, model) DO UPDATE SET
91 input = token_usage.input + excluded.input,
92 output = token_usage.output + excluded.output,
93 cache_read = token_usage.cache_read + excluded.cache_read,
94 cache_write = token_usage.cache_write + excluded.cache_write,
95 requests = token_usage.requests + excluded.requests",
96 "DELETE FROM token_usage WHERE workspace = ?2",
97 // Price notices sent, one per version: told once is told.
98 "UPDATE OR IGNORE price_notices SET workspace = ?1 WHERE workspace = ?2",
99 "DELETE FROM price_notices WHERE workspace = ?2",
100 "UPDATE OR IGNORE closed_workspaces SET workspace = ?1 WHERE workspace = ?2",
101 "DELETE FROM closed_workspaces WHERE workspace = ?2",
102 // The margin figures and counts are redone each day from the ledger and
103 // the meters; moved so the days between keep adding up.
104 "UPDATE OR IGNORE workspace_costs SET workspace = ?1 WHERE workspace = ?2",
105 "DELETE FROM workspace_costs WHERE workspace = ?2",
106 "UPDATE OR IGNORE own_counts SET workspace = ?1 WHERE workspace = ?2",
107 "DELETE FROM own_counts WHERE workspace = ?2",
108 "UPDATE margin_alerts SET subject = ?1 WHERE kind = 'workspace' AND subject = ?2",
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look109 // Holds, spikes, requests and the plan's payments: many per workspace.
110 "UPDATE reservations SET workspace = ?1 WHERE workspace = ?2",
111 "UPDATE reservations SET repo = ?1 || substr(repo, length(?2) + 1) WHERE substr(repo, 1, length(?2) + 1) = ?2 || '/'",
112 "UPDATE spikes SET workspace = ?1 WHERE workspace = ?2",
113 "UPDATE limit_requests SET workspace = ?1 WHERE workspace = ?2",
114 "UPDATE plan_payments SET workspace = ?1 WHERE workspace = ?2",
115 // One card check per workspace; alerts sent, one per level a month.
116 "UPDATE OR IGNORE card_checks SET workspace = ?1 WHERE workspace = ?2",
117 "DELETE FROM card_checks WHERE workspace = ?2",
118 "UPDATE OR IGNORE alerts_sent SET workspace = ?1 WHERE workspace = ?2",
119 "DELETE FROM alerts_sent WHERE workspace = ?2",
Agents and memory, checks and conflicts, profiles, slug renames, custom domains120 // Limits, field by field: a ceiling or an owner's spend limit set under
121 // either slug is kept (the current slug's if both), a stop for a
122 // declined card stays, and the highest warning this month is kept.
123 "INSERT INTO limits (workspace, ceiling_micros, spend_limit_micros, spend_limit_full, autopay_failed_at,
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look124 autopay_error, warned_month, warned_level, declined_told_at, updated_at,
125 max_ceiling_micros, granted_ceiling_micros, raised_at)
Agents and memory, checks and conflicts, profiles, slug renames, custom domains126 SELECT ?1, ceiling_micros, spend_limit_micros, spend_limit_full, autopay_failed_at,
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look127 autopay_error, warned_month, warned_level, declined_told_at, updated_at,
128 max_ceiling_micros, granted_ceiling_micros, raised_at
Agents and memory, checks and conflicts, profiles, slug renames, custom domains129 FROM limits WHERE workspace = ?2
130 ON CONFLICT (workspace) DO UPDATE SET
131 ceiling_micros = COALESCE(limits.ceiling_micros, excluded.ceiling_micros),
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look132 max_ceiling_micros = MAX(COALESCE(limits.max_ceiling_micros, 0), COALESCE(excluded.max_ceiling_micros, 0)),
133 granted_ceiling_micros = MAX(COALESCE(limits.granted_ceiling_micros, 0), COALESCE(excluded.granted_ceiling_micros, 0)),
134 raised_at = COALESCE(limits.raised_at, excluded.raised_at),
Agents and memory, checks and conflicts, profiles, slug renames, custom domains135 spend_limit_micros = CASE WHEN limits.spend_limit_micros IS NOT NULL OR limits.spend_limit_full = 1
136 THEN limits.spend_limit_micros ELSE excluded.spend_limit_micros END,
137 spend_limit_full = CASE WHEN limits.spend_limit_micros IS NOT NULL OR limits.spend_limit_full = 1
138 THEN limits.spend_limit_full ELSE excluded.spend_limit_full END,
139 autopay_error = CASE WHEN limits.autopay_failed_at IS NOT NULL
140 THEN limits.autopay_error ELSE excluded.autopay_error END,
141 autopay_failed_at = COALESCE(limits.autopay_failed_at, excluded.autopay_failed_at),
142 warned_level = CASE WHEN excluded.warned_month > COALESCE(limits.warned_month, '') THEN excluded.warned_level
143 WHEN excluded.warned_month = limits.warned_month THEN MAX(limits.warned_level, excluded.warned_level)
144 ELSE limits.warned_level END,
145 warned_month = COALESCE(MAX(limits.warned_month, excluded.warned_month), limits.warned_month, excluded.warned_month),
146 declined_told_at = COALESCE(MAX(limits.declined_told_at, excluded.declined_told_at), limits.declined_told_at, excluded.declined_told_at),
147 updated_at = MAX(limits.updated_at, excluded.updated_at)",
148 "DELETE FROM limits WHERE workspace = ?2",
149 // Plans: one per feature. A live plan under the stale slug replaces a
150 // canceled one under the current slug; otherwise the current one stays.
151 "DELETE FROM subscriptions WHERE workspace = ?1 AND status = 'canceled'
152 AND feature IN (SELECT feature FROM subscriptions WHERE workspace = ?2 AND status <> 'canceled')",
153 "UPDATE OR IGNORE subscriptions SET workspace = ?1 WHERE workspace = ?2",
154 "DELETE FROM subscriptions WHERE workspace = ?2",
155 // Records of one per workspace (per month): the current slug's stays
156 // if it has one.
157 "UPDATE OR IGNORE month_closes SET workspace = ?1 WHERE workspace = ?2",
158 "DELETE FROM month_closes WHERE workspace = ?2",
159 "UPDATE OR IGNORE account_members SET workspace = ?1 WHERE workspace = ?2",
160 "DELETE FROM account_members WHERE workspace = ?2",
161 "UPDATE OR IGNORE sales_records SET workspace = ?1 WHERE workspace = ?2",
162 "DELETE FROM sales_records WHERE workspace = ?2",
163 // An enterprise invoice's line for the workspace: amounts add.
164 "INSERT INTO enterprise_invoice_lines (invoice_id, workspace, amount_micros)
165 SELECT invoice_id, ?1, amount_micros FROM enterprise_invoice_lines WHERE workspace = ?2
166 ON CONFLICT (invoice_id, workspace) DO UPDATE SET
167 amount_micros = enterprise_invoice_lines.amount_micros + excluded.amount_micros",
168 "DELETE FROM enterprise_invoice_lines WHERE workspace = ?2",
169 // The workspace's own billing account, `ws_<slug>`. Terms set by staff
170 // are kept: a standard row under the current slug gives way to the
171 // stale one; two with terms keep the current one.
172 "DELETE FROM billing_accounts WHERE id = ?3 AND terms_kind = 'standard'
173 AND EXISTS (SELECT 1 FROM billing_accounts WHERE id = ?4)",
174 "UPDATE OR IGNORE billing_accounts SET id = ?3, name = CASE WHEN name = ?2 THEN ?1 ELSE name END WHERE id = ?4",
175 "DELETE FROM billing_accounts WHERE id = ?4",
176 "UPDATE admin_actions SET account = ?3 WHERE account = ?4",
Billing: a workspace rename moves its token usage, package storage, month-end snapshots, price notices, cost and count rows, margin alert and budget alerts too; a test keeps the rename and the reset naming the same tables177 "UPDATE OR IGNORE budget_alerts SET account = ?3 WHERE account = ?4",
178 "DELETE FROM budget_alerts WHERE account = ?4",
Agents and memory, checks and conflicts, profiles, slug renames, custom domains179 "UPDATE account_members SET account_id = ?3 WHERE account_id = ?4",
180 "UPDATE enterprise_invoices SET account_id = ?3 WHERE account_id = ?4",
181];
182
183/// The highest `?N` a statement names: how many values it is bound with.
184pub(crate) fn parameters(sql: &str) -> usize {
185 let bytes = sql.as_bytes();
186 let mut highest = 0;
187 for (i, byte) in bytes.iter().enumerate() {
188 if *byte == b'?' {
189 let digits: String = bytes[i + 1..].iter().take_while(|b| b.is_ascii_digit()).map(|b| *b as char).collect();
190 highest = highest.max(digits.parse().unwrap_or(0));
191 }
192 }
193 highest
194}
195
196/// The values `STATEMENTS` are bound with, in parameter order.
197pub(crate) fn values(stale: &str, current: &str) -> [String; 4] {
198 [current.to_owned(), stale.to_owned(), own_account(current), own_account(stale)]
199}
200
201impl Billing {
202 /// Handles one event from the bus; every type but a rename is ignored.
203 pub(crate) async fn on_event(&self, identity: Option<&Fetcher>, event: &Event) -> Result<()> {
204 if event.kind != RENAMED {
205 return Ok(());
206 }
207 let renamed: WorkspaceRenamed = serde_json::from_value(event.data.clone())?;
208 let current = match identity {
209 Some(identity) => {
210 let names: std::collections::HashMap<String, String> = g1t_kit::call(
211 identity,
212 "usernames",
213 &UsernamesArgs { ids: vec![renamed.workspace_id.clone()] },
214 )
215 .await?;
216 names.get(&renamed.workspace_id).cloned().unwrap_or_else(|| renamed.to.clone())
217 }
218 None => renamed.to.clone(),
219 };
220 self.rename_workspace(&renamed, &current.to_lowercase()).await
221 }
222
223 /// Moves every row of the rename's stale slugs to `current`.
224 pub(crate) async fn rename_workspace(&self, renamed: &WorkspaceRenamed, current: &str) -> Result<()> {
225 for stale in renamed.stale_slugs(current) {
226 let stale = stale.to_lowercase();
227 if stale.is_empty() || stale == current {
228 continue;
229 }
230 let values = values(&stale, current);
231 let mut batch = Vec::with_capacity(STATEMENTS.len());
232 for sql in STATEMENTS {
233 let binds: Vec<JsValue> = values[..parameters(sql)].iter().map(|v| JsValue::from(v.as_str())).collect();
234 batch.push(self.db.prepare(*sql).bind(&binds)?);
235 }
236 self.db.batch(batch).await?;
237 self.rename_customer(&stale, current).await;
238 }
239 Ok(())
240 }
241
242 /// The Stripe customer carries the slug as its name and metadata; both
243 /// follow the rename. A name someone changed at Stripe is left alone.
244 /// Best effort: a failure here moves no money.
245 async fn rename_customer(&self, stale: &str, current: &str) {
246 let Some(stripe) = &self.stripe else { return };
247 let Ok(Some(customer)) = self.row(current).await.map(|row| row.and_then(|row| row.customer_id)) else {
248 return;
249 };
250 #[derive(Deserialize)]
251 struct Customer {
252 name: Option<String>,
253 metadata: Option<std::collections::HashMap<String, String>>,
254 }
255 let path = format!("/customers/{customer}");
256 let found: Customer = match stripe.get(&path).await {
257 Ok(found) => found,
258 Err(error) => {
259 worker::console_error!("renaming {stale} at Stripe: could not read {customer}: {error}");
260 return;
261 }
262 };
263 let mut fields = vec![];
264 if found.name.as_deref() == Some(stale) {
265 fields.push(("name", current.to_owned()));
266 }
267 let tagged = found.metadata.as_ref().and_then(|m| m.get("workspace")).map(String::as_str);
268 if tagged != Some(current) {
269 fields.push(("metadata[workspace]", current.to_owned()));
270 }
271 if fields.is_empty() {
272 return;
273 }
274 if let Err(error) = stripe.post::<Value>(&path, &fields).await {
275 worker::console_error!("renaming {stale} at Stripe: could not update {customer}: {error}");
276 }
277 }
278}
279
280#[cfg(test)]
281mod tests {
282 use super::*;
283
284 #[test]
285 fn every_statement_is_bound_with_what_it_names() {
286 for sql in STATEMENTS {
287 let n = parameters(sql);
288 assert!((1..=4).contains(&n), "{sql}");
289 // Numbered only: a bare `?` would take the wrong value.
290 assert!(!sql.contains("? ") && !sql.ends_with('?'), "{sql}");
291 }
292 assert_eq!(parameters("UPDATE t SET a = ?1 WHERE b = ?2"), 2);
293 assert_eq!(parameters("UPDATE t SET a = ?3 WHERE b = ?4"), 4);
294 }
295
296 #[test]
297 fn the_values_name_both_slugs_and_their_accounts() {
298 assert_eq!(values("acme", "acme-co"), ["acme-co".to_owned(), "acme".into(), "ws_acme-co".into(), "ws_acme".into()]);
299 }
300
301 #[test]
302 fn every_table_keyed_by_a_slug_is_moved() {
303 let all = STATEMENTS.join("\n");
304 for table in [
Prices are what g1t pays plus 20%, from the first second305 "ledger", "runs", "checkouts", "workspace_invoices", "sales_notes", "accounts",
Agents and memory, checks and conflicts, profiles, slug renames, custom domains306 "pending_usage", "limits", "subscriptions", "month_closes", "account_members", "sales_records",
307 "enterprise_invoice_lines", "billing_accounts", "admin_actions", "enterprise_invoices",
Team plan, an open-source pool, monthly trials and honest metering; the sidebar for everyone; a workspace that stays put308 "allowance_use", "trial_grants", "storage_days",
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look309 "reservations", "spikes", "limit_requests", "plan_payments", "card_checks", "alerts_sent",
Billing: a workspace rename moves its token usage, package storage, month-end snapshots, price notices, cost and count rows, margin alert and budget alerts too; a test keeps the rename and the reset naming the same tables310 "package_storage_days", "pending_days", "token_usage", "price_notices", "closed_workspaces",
311 "workspace_costs", "own_counts",
Agents and memory, checks and conflicts, profiles, slug renames, custom domains312 ] {
313 assert!(all.contains(&format!("FROM {table} WHERE workspace = ?2"))
314 || all.contains(&format!("UPDATE {table} SET"))
315 || all.contains(&format!("UPDATE OR IGNORE {table} SET")), "{table}");
316 }
317 }
318}