@haakco/hostingctl 1.0.706 → 1.0.721

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/main.js CHANGED
@@ -34999,22 +34999,6 @@ function hostingSeedStorePlacement(options) {
34999
34999
  }));
35000
35000
  }
35001
35001
  /**
35002
- * {@link /platform/hosting/seeds/:seedUuid/versions/:versionUuid/placements/adoptions}
35003
- */
35004
- function hostingSeedPlacementStoreAdoption(options) {
35005
- const { client: request = client, ...config } = options;
35006
- return withUnwrap(request({
35007
- method: "POST",
35008
- url: "/platform/hosting/seeds/{seedUuid}/versions/{versionUuid}/placements/adoptions",
35009
- security: [{
35010
- type: "http",
35011
- scheme: "bearer"
35012
- }],
35013
- ...config,
35014
- throwOnError: config.throwOnError ?? true
35015
- }));
35016
- }
35017
- /**
35018
35002
  * {@link /platform/hosting/seeds/:seedUuid/versions/:versionUuid/placements/:placementUuid/builds}
35019
35003
  */
35020
35004
  function hostingSeedPlacementStoreBuild(options) {
@@ -37340,6 +37324,54 @@ function platformBillingPaymentStateCompanyUnpaid(options) {
37340
37324
  }));
37341
37325
  }
37342
37326
  /**
37327
+ * {@link /platform/billing/price-changes/preview}
37328
+ */
37329
+ function platformBillingPriceChangePreview(options) {
37330
+ const { client: request = client, ...config } = options;
37331
+ return withUnwrap(request({
37332
+ method: "POST",
37333
+ url: "/platform/billing/price-changes/preview",
37334
+ security: [{
37335
+ type: "http",
37336
+ scheme: "bearer"
37337
+ }],
37338
+ ...config,
37339
+ throwOnError: config.throwOnError ?? true
37340
+ }));
37341
+ }
37342
+ /**
37343
+ * {@link /platform/billing/price-changes}
37344
+ */
37345
+ function platformBillingPriceChangeStore(options) {
37346
+ const { client: request = client, ...config } = options;
37347
+ return withUnwrap(request({
37348
+ method: "POST",
37349
+ url: "/platform/billing/price-changes",
37350
+ security: [{
37351
+ type: "http",
37352
+ scheme: "bearer"
37353
+ }],
37354
+ ...config,
37355
+ throwOnError: config.throwOnError ?? true
37356
+ }));
37357
+ }
37358
+ /**
37359
+ * {@link /platform/billing/price-changes/:rateUuid}
37360
+ */
37361
+ function platformBillingPriceChangeDestroy(options) {
37362
+ const { client: request = client, ...config } = options;
37363
+ return withUnwrap(request({
37364
+ method: "DELETE",
37365
+ url: "/platform/billing/price-changes/{rateUuid}",
37366
+ security: [{
37367
+ type: "http",
37368
+ scheme: "bearer"
37369
+ }],
37370
+ ...config,
37371
+ throwOnError: config.throwOnError ?? true
37372
+ }));
37373
+ }
37374
+ /**
37343
37375
  * @description The whole book is returned rather than a page of it. It is bounded by how often we change a price, and
37344
37376
  * a reviewer needs the windows in order to see the gaps.
37345
37377
  * @summary Every recorded window: the default prices and each company's overrides
@@ -44878,8 +44910,11 @@ var BILLING_USAGE = `hostingctl billing <subcommand> [flags]
44878
44910
  issuer Who issues our documents, and whether issuance is on
44879
44911
  issuer activate --month <YYYY-MM> Record the first month Hosting issues its own documents
44880
44912
  rates [--company <slug>] Every recorded price window
44881
- rate start --product <MHU|MHS> --amount <rand> --from <date> [--package <key>] [--company <slug>]
44913
+ rate start --product <MHU|MHS|STO|TRF> --amount <rand> --from <date> [--package <key>] [--company <slug>]
44882
44914
  rate end <rate-uuid> --until <date> End a price window
44915
+ rate change --product <code> --package <key> --amount <rand> --on <YYYY-MM-DD> [--applies-to-all]
44916
+ Schedule a list-price change from a day
44917
+ rate cancel <rate-uuid> Cancel a scheduled change before its day
44883
44918
  tax-rates Every recorded VAT window
44884
44919
  tax-rate start --label <text> --percent <n> --from <date>
44885
44920
  run --company <slug> --period <YYYY-MM> What that company's month came to
@@ -45045,6 +45080,10 @@ var billingProductEnum = {
45045
45080
  STO: "STO",
45046
45081
  TRF: "TRF"
45047
45082
  };
45083
+ var billingRateExistingCustomerRuleEnum = {
45084
+ grandfathered: "grandfathered",
45085
+ applies_to_all: "applies_to_all"
45086
+ };
45048
45087
  var hostingCancellationDeletionTimingEnum = {
45049
45088
  "at-service-end": "at-service-end",
45050
45089
  now: "now"
@@ -46149,7 +46188,7 @@ var BILLING_METADATA = {
46149
46188
  {
46150
46189
  name: "--product",
46151
46190
  takesValue: true,
46152
- description: "The product a rate prices: MHU or MHS."
46191
+ description: "A rate's product: MHU, MHS, STO or TRF."
46153
46192
  },
46154
46193
  {
46155
46194
  name: "--package",
@@ -46171,6 +46210,16 @@ var BILLING_METADATA = {
46171
46210
  takesValue: true,
46172
46211
  description: "The ISO-8601 date a window ends."
46173
46212
  },
46213
+ {
46214
+ name: "--on",
46215
+ takesValue: true,
46216
+ description: "The day a price change starts, YYYY-MM-DD."
46217
+ },
46218
+ {
46219
+ name: "--applies-to-all",
46220
+ takesValue: false,
46221
+ description: "Move existing customers too."
46222
+ },
46174
46223
  {
46175
46224
  name: "--label",
46176
46225
  takesValue: true,
@@ -46353,6 +46402,8 @@ var BILLING_METADATA = {
46353
46402
  "rates",
46354
46403
  "rate start",
46355
46404
  "rate end",
46405
+ "rate change",
46406
+ "rate cancel",
46356
46407
  "tax-rates",
46357
46408
  "tax-rate start",
46358
46409
  "run",
@@ -46416,7 +46467,7 @@ var BILLING_TOPICS = [
46416
46467
  },
46417
46468
  {
46418
46469
  path: ["rate"],
46419
- usage: "hostingctl billing rate <start|end> [flags]\n\nA rate is never edited: end it and start another, because an issued document points at the rate that priced it."
46470
+ usage: "hostingctl billing rate <start|end|change|cancel> [flags]\n\nA rate is never edited. A list price changes on a day with `rate change`, which the API previews before --confirm sends it; existing customers keep their price unless --applies-to-all is given for an increase with notice. `rate cancel` takes a scheduled change back before its day. `rate start` records a key's first price or a company's own price."
46420
46471
  },
46421
46472
  {
46422
46473
  path: ["run"],
@@ -46452,6 +46503,40 @@ var BILLING_TOPICS = [
46452
46503
  }
46453
46504
  ];
46454
46505
  //#endregion
46506
+ //#region src/commands/billing-price-changes.ts
46507
+ /**
46508
+ * A list-price change, given as a day: `rate change` and `rate cancel`.
46509
+ *
46510
+ * The change is previewed by the API first — a read that writes nothing — so `--dry-run` reports what the API says
46511
+ * the change would do (the current price, whether it rises and who it reaches), and `--confirm` sends exactly that.
46512
+ */
46513
+ /** The sentence an operator confirms, built from the API's own preview. */
46514
+ function changeDescription(preview) {
46515
+ const reach = preview.existingCustomers === billingRateExistingCustomerRuleEnum.applies_to_all ? "Existing customers move to it, each no earlier than their notice period after their notice is sent." : preview.isIncrease ? "Existing customers keep their current price; new customers pay the new one." : "Every customer pays the lower price from that day.";
46516
+ return `Change the ${preview.product} list price for ${preview.packageKey} from ${randAmount(preview.currentAmountCents)} to ${randAmount(preview.newAmountCents)} from ${preview.effectiveOn} (${preview.effectiveFrom}). ${reach} ${preview.existingCustomerCount} existing customers, ${preview.keepingPriceCount} keeping their price.`;
46517
+ }
46518
+ async function changeRate(context) {
46519
+ const on = requiredFlag$2(context, "--on");
46520
+ if (!/^\d{4}-\d{2}-\d{2}$/.test(on)) throw new UsageError(`--on must be a day, written YYYY-MM-DD (got ${on}).\n\n${BILLING_USAGE}`);
46521
+ const body = {
46522
+ product: product$1(context),
46523
+ packageKey: requiredFlag$2(context, "--package"),
46524
+ amountCents: randToCents$1(context, "--amount"),
46525
+ effectiveOn: on,
46526
+ existingCustomers: context.flags.has("--applies-to-all") ? billingRateExistingCustomerRuleEnum.applies_to_all : billingRateExistingCustomerRuleEnum.grandfathered
46527
+ };
46528
+ return {
46529
+ kind: "write",
46530
+ outcome: await confirmableWrite(context, changeDescription(await platformBillingPriceChangePreview({ body }).unwrap()), async () => platformBillingPriceChangeStore({ body }).unwrap())
46531
+ };
46532
+ }
46533
+ async function cancelRateChange(context, rateUuid) {
46534
+ return {
46535
+ kind: "write",
46536
+ outcome: await confirmableWrite(context, `Cancel the scheduled price change ${rateUuid}. The earlier price is reopened, so no day is left unpriced.`, async () => platformBillingPriceChangeDestroy({ path: { rateUuid } }).unwrap())
46537
+ };
46538
+ }
46539
+ //#endregion
46455
46540
  //#region src/commands/billing-refunds.ts
46456
46541
  /**
46457
46542
  * Money going back: the platform's list, a client's request, and the four transitions an operator records.
@@ -46705,10 +46790,11 @@ async function rates() {
46705
46790
  }
46706
46791
  async function rate(context, rest) {
46707
46792
  if (rest[0] === "start") return startRate(context);
46708
- if (rest[0] === "end") {
46793
+ if (rest[0] === "change") return changeRate(context);
46794
+ if (rest[0] === "end" || rest[0] === "cancel") {
46709
46795
  const rateUuid = rest[1] ?? "";
46710
- if (rateUuid === "") throw new UsageError(`rate end needs the rate's uuid.\n\n${BILLING_USAGE}`);
46711
- return endRate(context, rateUuid);
46796
+ if (rateUuid === "") throw new UsageError(`rate ${rest[0]} needs the rate's uuid.\n\n${BILLING_USAGE}`);
46797
+ return rest[0] === "end" ? endRate(context, rateUuid) : cancelRateChange(context, rateUuid);
46712
46798
  }
46713
46799
  throw new UsageError(BILLING_USAGE);
46714
46800
  }
@@ -60573,13 +60659,6 @@ object({
60573
60659
  items: array(activityDataSchema),
60574
60660
  meta: pageMetaDataSchema
60575
60661
  });
60576
- var adoptHostingSeedPlacementRequestSchema = object({
60577
- clusterUuid: uuid(),
60578
- storageClassName: string().max(253).regex(/~^[a-z0-9](?:[-a-z0-9]*[a-z0-9])?(?:\.[a-z0-9](?:[-a-z0-9]*[a-z0-9])?)*$~/),
60579
- backingImageName: string().max(253).regex(/~^[a-z0-9](?:[-a-z0-9]*[a-z0-9])?(?:\.[a-z0-9](?:[-a-z0-9]*[a-z0-9])?)*$~/),
60580
- expectedChecksum: string().regex(/^[0-9a-f]{128}$/),
60581
- minimumSizeMib: int().min(1)
60582
- }).describe("Record one seed version's already-existing cluster objects on one cluster.\n\nA caller supplies the cluster, the two object names an outside owner already built, the immutable\nSHA-512 checksum that BackingImage must keep reporting, and the smallest claim the class can provision.\n\nNo readiness, size, status or origin can be submitted: those are recorded by a real observation or by\nthe service. The names are validated as Kubernetes object identities — a DNS-1123 subdomain — because\na name that is not already addressable in the cluster is not an existing object at all. The checksum is\nLonghorn's SHA-512 form, deliberately not the version's SHA-256 source archive checksum.");
60583
60662
  var announceHostingRuntimeVersionNoticeRequestSchema = object({
60584
60663
  until: datetime(),
60585
60664
  note: string().max(500)
@@ -60797,6 +60876,31 @@ object({
60797
60876
  method: union([billingPaymentMethodDataSchema, _null()]),
60798
60877
  invoices: array(billingInvoiceCollectionPositionDataSchema)
60799
60878
  });
60879
+ var billingProductEnumSchema = _enum([
60880
+ "MHU",
60881
+ "MHS",
60882
+ "STO",
60883
+ "TRF"
60884
+ ]).describe("The tariff lines our documents define. `MHU` is the recurring managed hosting unit; `MHS` is the one-off managed hosting setup. `STO` is one recurring 10 GB storage block and `TRF` is one recurring chargeable 10 GB transfer block; the product variant (object storage, disk) is the rate's `package_key`, which is the price book's existing scope. They are our product codes, not package keys: a package says what an environment holds, a product says what it is billed as.\n");
60885
+ var billingPriceSourceEnumSchema = _enum([
60886
+ "company_rate",
60887
+ "default_rate",
60888
+ "protected_rate",
60889
+ "free_allowance"
60890
+ ]).describe("Which price a rated line segment resolved to. The source is frozen onto the line so a later price book change cannot rewrite why a past segment was worth what it was. A free-allowance segment has no rate at all.\n| |\n|---|\n| `company_rate` <br/> A company-specific rate window applied. |\n| `default_rate` <br/> The default (company-null) rate window applied. |\n| `protected_rate` <br/> An existing customer's protected price: the lowest earlier list price, kept when the list price rose. |\n| `free_allowance` <br/> A period held under the free allowance: a stated zero line, never an omission. |");
60891
+ var billingCompanyPriceDataSchema = object({
60892
+ product: billingProductEnumSchema.describe("The tariff lines our documents define. `MHU` is the recurring managed hosting unit; `MHS` is the one-off managed hosting setup. `STO` is one recurring 10 GB storage block and `TRF` is one recurring chargeable 10 GB transfer block; the product variant (object storage, disk) is the rate's `package_key`, which is the price book's existing scope. They are our product codes, not package keys: a package says what an environment holds, a product says what it is billed as.\n"),
60893
+ packageKey: string(),
60894
+ name: string().describe("The key's name a customer reads, such as \"Standard unit\"."),
60895
+ yourPrice: billingAmountsDataSchema,
60896
+ listPrice: billingAmountsDataSchema,
60897
+ priceSource: billingPriceSourceEnumSchema.describe("Which price a rated line segment resolved to. The source is frozen onto the line so a later price book change cannot rewrite why a past segment was worth what it was. A free-allowance segment has no rate at all.\n| |\n|---|\n| `company_rate` <br/> A company-specific rate window applied. |\n| `default_rate` <br/> The default (company-null) rate window applied. |\n| `protected_rate` <br/> An existing customer's protected price: the lowest earlier list price, kept when the list price rose. |\n| `free_allowance` <br/> A period held under the free allowance: a stated zero line, never an omission. |")
60898
+ });
60899
+ object({
60900
+ currency: string(),
60901
+ quotedAt: string(),
60902
+ items: array(billingCompanyPriceDataSchema)
60903
+ });
60800
60904
  var billingCreditEntryTypeEnumSchema = _enum([
60801
60905
  "over_recovery",
60802
60906
  "unapplied_receipt",
@@ -60942,12 +61046,6 @@ var billingDeliveryStateEnumSchema = _enum([
60942
61046
  "failed"
60943
61047
  ]).describe("What we know about sending the document. The mail transport can prove submission, not mailbox delivery, so `sent` means \"the transport * accepted it for the billing contact\". A failed or missing contact never un-issues the document.\n");
60944
61048
  var billingDiscountKindEnumSchema = _enum(["amount", "percent"]).describe("What a discount code states: a price, or a share off the list price. A code's promise is an **amount**, because an amount is what a client is charged and what a price window records. A percentage is therefore a way of *deriving* that amount once, at the month the window opens, against the list price effective then — not a second pricing rule that would reprice a settled month when a list price moves. The kind is stored rather than inferred from which column is filled, so a half-written code cannot mean two things and an existing row keeps its original meaning as `amount`.\n");
60945
- var billingProductEnumSchema = _enum([
60946
- "MHU",
60947
- "MHS",
60948
- "STO",
60949
- "TRF"
60950
- ]).describe("The tariff lines our documents define. `MHU` is the recurring managed hosting unit; `MHS` is the one-off managed hosting setup. `STO` is one recurring 10 GB storage block and `TRF` is one recurring chargeable 10 GB transfer block; the product variant (object storage, disk) is the rate's `package_key`, which is the price book's existing scope. They are our product codes, not package keys: a package says what an environment holds, a product says what it is billed as.\n");
60951
61049
  var billingDiscountCodeRedemptionDataSchema = object({
60952
61050
  state: _enum(["pending", "applied"]).describe("Whether a redeemed code has priced the account yet. A code can be redeemed before the account holds anything to price: a client types it while creating their account, and a brand-new company has no environment, so no purchase period, so nothing a price window could name. `pending` is that state — the promise exists and is spent, and the first environment the client creates prices it. `applied` is a redemption that already wrote the company's price window. The distinction is a fact about the record, not a workflow step a caller advances by hand: only the environment creation path moves a redemption from `pending` to `applied`, in the transaction that opens the period.\n| |\n|---|\n| `pending` <br/> Redeemed, and waiting for the account to hold a package that can be priced. |\n| `applied` <br/> Redeemed, and the company's own price window carries the code's amount. |").describe("Whether a redeemed code has priced the account yet. A code can be redeemed before the account holds anything to price: a client types it while creating their account, and a brand-new company has no environment, so no purchase period, so nothing a price window could name. `pending` is that state — the promise exists and is spent, and the first environment the client creates prices it. `applied` is a redemption that already wrote the company's price window. The distinction is a fact about the record, not a workflow step a caller advances by hand: only the environment creation path moves a redemption from `pending` to `applied`, in the transaction that opens the period.\n| |\n|---|\n| `pending` <br/> Redeemed, and waiting for the account to hold a package that can be priced. |\n| `applied` <br/> Redeemed, and the company's own price window carries the code's amount. |"),
60953
61051
  code: string(),
@@ -61223,11 +61321,21 @@ object({
61223
61321
  paidGrossCents: int(),
61224
61322
  unpaidGrossCents: int()
61225
61323
  });
61226
- var billingPriceSourceEnumSchema = _enum([
61227
- "company_rate",
61228
- "default_rate",
61229
- "free_allowance"
61230
- ]).describe("Which price a rated line segment resolved to. The source is frozen onto the line so a later price book change cannot rewrite why a past segment was worth what it was. A free-allowance segment has no rate at all.\n| |\n|---|\n| `company_rate` <br/> A company-specific rate window applied. |\n| `default_rate` <br/> The default (company-null) rate window applied. |\n| `free_allowance` <br/> A period held under the free allowance: a stated zero line, never an omission. |");
61324
+ var billingRateExistingCustomerRuleEnumSchema = _enum(["grandfathered", "applies_to_all"]);
61325
+ object({
61326
+ product: billingProductEnumSchema.describe("The tariff lines our documents define. `MHU` is the recurring managed hosting unit; `MHS` is the one-off managed hosting setup. `STO` is one recurring 10 GB storage block and `TRF` is one recurring chargeable 10 GB transfer block; the product variant (object storage, disk) is the rate's `package_key`, which is the price book's existing scope. They are our product codes, not package keys: a package says what an environment holds, a product says what it is billed as.\n"),
61327
+ packageKey: string(),
61328
+ amountBasis: billingAmountBasisEnumSchema.describe("What one rate amount is for, and whether the amount already includes VAT. A recurring packaging price is charged per month and prorated by time held; a setup price is charged once for an approved event and is never prorated. A **VAT-inclusive** recurring price is the third case, and it exists because some prices are agreed as a consumer figure: R3.00 per 10 GB including VAT cannot be expressed as a whole number of net cents that reproduces R30.00 for ten blocks, so the agreed gross figure is what the price book stores and the VAT is separated out of it. That keeps a quote and an invoice equal to the number the client was given, instead of two cents away from it. Keeping all three in one effective-dated price table means there is one place a price lives, not three.\n"),
61329
+ currentAmountCents: int(),
61330
+ newAmountCents: int(),
61331
+ isIncrease: boolean(),
61332
+ effectiveOn: string(),
61333
+ effectiveFrom: string(),
61334
+ existingCustomers: billingRateExistingCustomerRuleEnumSchema,
61335
+ existingCustomerCount: int().describe("Companies already customers of this product and key."),
61336
+ keepingPriceCount: int().describe("Of those, how many keep their current price: every one on a grandfathered increase, none otherwise."),
61337
+ rateUuid: string().nullable()
61338
+ });
61231
61339
  object({
61232
61340
  uuid: string(),
61233
61341
  provider: string(),
@@ -61273,7 +61381,8 @@ object({ items: array(object({
61273
61381
  amountCents: int(),
61274
61382
  currency: string(),
61275
61383
  effectiveFrom: string(),
61276
- effectiveUntil: string().nullable()
61384
+ effectiveUntil: string().nullable(),
61385
+ existingCustomers: union([billingRateExistingCustomerRuleEnumSchema, _null()])
61277
61386
  })) });
61278
61387
  var billingReceivablesSuspensionDataSchema = object({
61279
61388
  reason: string(),
@@ -61324,7 +61433,7 @@ var billingRunLineDataSchema = object({
61324
61433
  serviceTo: datetime(),
61325
61434
  heldSeconds: int(),
61326
61435
  monthSeconds: int(),
61327
- priceSource: billingPriceSourceEnumSchema.describe("Which price a rated line segment resolved to. The source is frozen onto the line so a later price book change cannot rewrite why a past segment was worth what it was. A free-allowance segment has no rate at all.\n| |\n|---|\n| `company_rate` <br/> A company-specific rate window applied. |\n| `default_rate` <br/> The default (company-null) rate window applied. |\n| `free_allowance` <br/> A period held under the free allowance: a stated zero line, never an omission. |"),
61436
+ priceSource: billingPriceSourceEnumSchema.describe("Which price a rated line segment resolved to. The source is frozen onto the line so a later price book change cannot rewrite why a past segment was worth what it was. A free-allowance segment has no rate at all.\n| |\n|---|\n| `company_rate` <br/> A company-specific rate window applied. |\n| `default_rate` <br/> The default (company-null) rate window applied. |\n| `protected_rate` <br/> An existing customer's protected price: the lowest earlier list price, kept when the list price rose. |\n| `free_allowance` <br/> A period held under the free allowance: a stated zero line, never an omission. |"),
61328
61437
  rateUuid: string().nullable(),
61329
61438
  monthlyAmountCents: int().nullable(),
61330
61439
  amountBasis: union([billingAmountBasisEnumSchema, _null()]),
@@ -62535,7 +62644,9 @@ var emailKindEnumSchema = _enum([
62535
62644
  "mailbox-fallback-verification",
62536
62645
  "password-recovery",
62537
62646
  "verify-email",
62538
- "platform-alert"
62647
+ "platform-alert",
62648
+ "billing-price-increase-notice",
62649
+ "billing-price-increase-cancelled"
62539
62650
  ]);
62540
62651
  var emailMailboxQuotaEnumSchema = _enum([
62541
62652
  "gb-5",
@@ -63975,7 +64086,8 @@ object({
63975
64086
  var hostingPoolLinePriceDataSchema = object({
63976
64087
  priceKey: string().describe("The price book's key this part is priced from: a unit's package key, or a storage product's key."),
63977
64088
  quantity: int().describe("How many of that key the part covers: the units the pool holds, or the 10 GB blocks the client bought."),
63978
- monthly: billingAmountsDataSchema.describe("That quantity at that key's monthly amount, for the month this quote is stated for.")
64089
+ monthly: billingAmountsDataSchema.describe("That quantity at that key's monthly amount, for the month this quote is stated for."),
64090
+ priceSource: billingPriceSourceEnumSchema.describe("Which price applies to this company: the list price, its negotiated price, or its earlier protected price.\n| |\n|---|\n| `company_rate` <br/> A company-specific rate window applied. |\n| `default_rate` <br/> The default (company-null) rate window applied. |\n| `protected_rate` <br/> An existing customer's protected price: the lowest earlier list price, kept when the list price rose. |\n| `free_allowance` <br/> A period held under the free allowance: a stated zero line, never an omission. |")
63979
64091
  });
63980
64092
  var hostingPoolPriceDataSchema = object({
63981
64093
  period: string().describe("The local billing month these figures are stated for, as `YYYY-MM`."),
@@ -65002,7 +65114,8 @@ var hostingNvmeBlockQuoteDataSchema = object({
65002
65114
  capacityBytes: int().describe("Those blocks in exact decimal bytes, from the configured block size."),
65003
65115
  monthlyPeriod: string().describe("The local billing month these figures are stated for, as `YYYY-MM`."),
65004
65116
  currency: string(),
65005
- monthly: billingAmountsDataSchema.describe("The stated blocks for one month, net, VAT and gross.")
65117
+ monthly: billingAmountsDataSchema.describe("The stated blocks for one month, net, VAT and gross."),
65118
+ priceSource: billingPriceSourceEnumSchema.describe("Which price applies to this company: the list price, its negotiated price, or its earlier protected price.\n| |\n|---|\n| `company_rate` <br/> A company-specific rate window applied. |\n| `default_rate` <br/> The default (company-null) rate window applied. |\n| `protected_rate` <br/> An existing customer's protected price: the lowest earlier list price, kept when the list price rose. |\n| `free_allowance` <br/> A period held under the free allowance: a stated zero line, never an omission. |")
65006
65119
  });
65007
65120
  object({
65008
65121
  holding: hostingCompanyNvmeBlocksDataSchema.describe("The blocks this company holds now, or `recorded: false` when it holds none."),
@@ -66512,6 +66625,13 @@ object({
66512
66625
  });
66513
66626
  var promoteHostingSeedVersionRequestSchema = object({ versionUuid: uuid() }).describe("Promote one immutable version to the version this definition selects for future claims.\n\nThe version is named by UUID; whether it belongs to the addressed definition is checked in the\nservice against the definition that owns the route, so the field rule is a shape check only.");
66514
66627
  var provisionHostingPoolRequestSchema = object({ unitQuantity: int().min(1) }).describe("Platform client-management middleware owns authority; the service refuses priced accounts.");
66628
+ var publicPriceChangeDataSchema = object({
66629
+ effectiveOn: string().describe("The local `YYYY-MM-DD` day the price applies from."),
66630
+ effectiveFrom: string(),
66631
+ netCents: int(),
66632
+ vatCents: int(),
66633
+ grossCents: int()
66634
+ });
66515
66635
  var publicPriceDataSchema = object({
66516
66636
  product: string(),
66517
66637
  priceKey: string(),
@@ -66519,12 +66639,14 @@ var publicPriceDataSchema = object({
66519
66639
  netCents: int(),
66520
66640
  vatCents: int(),
66521
66641
  grossCents: int(),
66522
- effectiveFrom: string()
66642
+ effectiveFrom: string(),
66643
+ next: union([publicPriceChangeDataSchema, _null()])
66523
66644
  });
66524
66645
  object({
66525
66646
  currency: string(),
66526
66647
  quotedAt: string(),
66527
- items: array(publicPriceDataSchema)
66648
+ items: array(publicPriceDataSchema),
66649
+ vatBasisPoints: int().nullable().describe("The VAT rate in force at `quotedAt`, in basis points (1500 is 15%); null when none is recorded.")
66528
66650
  });
66529
66651
  var purchaseHostingNvmeBlocksRequestSchema = object({ blocks: int().min(1).max(1e4) }).describe("The number of 10 GB NVMe blocks a client holds after this request.\n\nThe count is the total, not an increment, because that is what the ledger records and what the invoice charges: a\nclient that holds three blocks and asks for four is buying one, and a retry of the same request buys nothing. The\nceiling is a mistyped-number guard, not a limit anyone is expected to meet — the price book's own ceiling is a\nmillion rand a month, which is far more blocks than one company has ever held.");
66530
66652
  var purchaseHostingPoolRequestSchema = object({ unitQuantity: int().min(1) }).describe("Company capability middleware owns authority; the purchase owner also enforces self-service origin.");
@@ -66923,13 +67045,24 @@ var saveHostingDomainRedirectRequestSchema = object({
66923
67045
  hostingDomainUuid: uuid().nullish(),
66924
67046
  destinationUrl: string().max(2048).nullish()
66925
67047
  }).describe("One whole-domain redirect to save.\n\nThe source name comes from the route, the environment from the route, and the target is one of two\nnamed shapes: an application alias (`hostingDomainUuid`) or an explicitly saved HTTPS address\n(`destinationUrl`). The service refuses the combination each shape cannot use, so a body cannot\ndescribe a state the database would refuse.");
67048
+ var scheduleBillingPriceChangeRequestSchema = object({
67049
+ product: billingProductEnumSchema.describe("The tariff lines our documents define. `MHU` is the recurring managed hosting unit; `MHS` is the one-off managed hosting setup. `STO` is one recurring 10 GB storage block and `TRF` is one recurring chargeable 10 GB transfer block; the product variant (object storage, disk) is the rate's `package_key`, which is the price book's existing scope. They are our product codes, not package keys: a package says what an environment holds, a product says what it is billed as.\n"),
67050
+ packageKey: string().max(64),
67051
+ amountCents: int().min(0).max(1e8),
67052
+ effectiveOn: date(),
67053
+ existingCustomers: billingRateExistingCustomerRuleEnumSchema
67054
+ }).describe("A list-price change, previewed or scheduled: one key's new price from one local day.\n\nShape is checked here; whether the day, the notice and the current window allow it is the service's.");
66926
67055
  var selectGitHubRepositoryRequestSchema = object({
66927
67056
  repositoryId: int().min(1),
66928
67057
  branch: string().min(1).max(255).nullish(),
66929
67058
  configPath: string().min(1).max(255).nullish()
66930
67059
  }).describe("One repository selected from a bound installation, by GitHub's numeric id.\n\nThe name is deliberately not accepted: a rename would otherwise silently stop matching,\nand the id is what the provider's own repository list is keyed on.");
66931
67060
  var sendMailboxSetupInstructionsRequestSchema = object({ recipient: email().max(254).nullish() }).describe("Sending one mailbox's mail-client setup instructions.\n\n`recipient` is optional: when it is absent the mailbox's stored fallback address is used. A mailbox\nmay not be usable yet, so the mailbox's own address is never required as the destination and the\nmessage carries no password.");
66932
- var sentEmailContextEnumSchema = _enum(["billing-document", "alert-message"]);
67061
+ var sentEmailContextEnumSchema = _enum([
67062
+ "billing-document",
67063
+ "alert-message",
67064
+ "billing-price-change-notice"
67065
+ ]);
66933
67066
  var sentEmailTagEnumSchema = _enum([
66934
67067
  "alert",
66935
67068
  "incident",
@@ -68028,6 +68161,11 @@ union([
68028
68161
  object({ message: string().describe("Error overview.") }),
68029
68162
  object({ message: string().describe("Error overview.") })
68030
68163
  ]);
68164
+ union([
68165
+ object({ message: string().describe("Error overview.") }),
68166
+ object({ message: string().describe("Error overview.") }),
68167
+ object({ message: string().describe("Error overview.") })
68168
+ ]);
68031
68169
  union([object({ message: string().describe("Error overview.") }), object({ message: string().describe("Error overview.") })]);
68032
68170
  union([
68033
68171
  object({ message: string().describe("Error overview.") }),
@@ -69965,15 +70103,6 @@ union([
69965
70103
  object({ message: string().describe("Error overview.").meta({ examples: [""] }) }),
69966
70104
  object({ message: string().describe("Error overview.").meta({ examples: [""] }) })
69967
70105
  ]);
69968
- union([
69969
- object({ message: string().describe("Error overview.") }),
69970
- object({ message: string().describe("Error overview.") }),
69971
- object({
69972
- message: string().describe("Errors overview."),
69973
- errors: record$1(string(), array(string())).describe("A detailed description of each field that failed validation.")
69974
- })
69975
- ]);
69976
- adoptHostingSeedPlacementRequestSchema.describe("Record one seed version's already-existing cluster objects on one cluster.\n\nA caller supplies the cluster, the two object names an outside owner already built, the immutable\nSHA-512 checksum that BackingImage must keep reporting, and the smallest claim the class can provision.\n\nNo readiness, size, status or origin can be submitted: those are recorded by a real observation or by\nthe service. The names are validated as Kubernetes object identities — a DNS-1123 subdomain — because\na name that is not already addressable in the cluster is not an existing object at all. The checksum is\nLonghorn's SHA-512 form, deliberately not the version's SHA-256 source archive checksum.");
69977
70106
  union([
69978
70107
  object({ message: string().describe("Error overview.") }),
69979
70108
  object({ message: string().describe("Error overview.") }),
@@ -70966,6 +71095,24 @@ union([
70966
71095
  messageDataSchema
70967
71096
  ]);
70968
71097
  updateBillingPaymentStateRequestSchema.describe("Recording a manual payment state: one invoice, or an explicit list of a company's invoices.\n\nTwo bodies, one route file apart: a single invoice names a `state` and an optional `note`, while a\ncompany action names `invoices`, an explicit array of UUIDs. The shape is what separates them — a\ncompany action that could also be read as a single-invoice write would be a way to mark an unnamed\nset unpaid, which is exactly what this surface refuses to do.");
71098
+ union([
71099
+ object({ message: string().describe("Error overview.") }),
71100
+ object({ message: string().describe("Error overview.") }),
71101
+ messageDataSchema
71102
+ ]);
71103
+ scheduleBillingPriceChangeRequestSchema.describe("A list-price change, previewed or scheduled: one key's new price from one local day.\n\nShape is checked here; whether the day, the notice and the current window allow it is the service's.");
71104
+ union([
71105
+ object({ message: string().describe("Error overview.") }),
71106
+ object({ message: string().describe("Error overview.") }),
71107
+ messageDataSchema
71108
+ ]);
71109
+ scheduleBillingPriceChangeRequestSchema.describe("A list-price change, previewed or scheduled: one key's new price from one local day.\n\nShape is checked here; whether the day, the notice and the current window allow it is the service's.");
71110
+ union([
71111
+ object({ message: string().describe("Error overview.") }),
71112
+ object({ message: string().describe("Error overview.") }),
71113
+ messageDataSchema,
71114
+ messageDataSchema
71115
+ ]);
70969
71116
  union([
70970
71117
  object({ message: string().describe("Error overview.") }),
70971
71118
  object({ message: string().describe("Error overview.") }),
@@ -73643,26 +73790,11 @@ var PLATFORM_SEED_FLAGS = [
73643
73790
  takesValue: true,
73644
73791
  description: "The cluster the placement is made on."
73645
73792
  },
73646
- {
73647
- name: "--storage-class",
73648
- takesValue: true,
73649
- description: "The storage class the placement is adopted with."
73650
- },
73651
73793
  {
73652
73794
  name: "--source-storage-class",
73653
73795
  takesValue: true,
73654
73796
  description: "Source class UUID for placement-add or placement-build; omitted uses the platform's selection."
73655
73797
  },
73656
- {
73657
- name: "--backing-image",
73658
- takesValue: true,
73659
- description: "The backing image the placement runs from."
73660
- },
73661
- {
73662
- name: "--expected-checksum",
73663
- takesValue: true,
73664
- description: "The checksum the adopted placement is verified against."
73665
- },
73666
73798
  {
73667
73799
  name: "--minimum-size",
73668
73800
  takesValue: true,
@@ -73770,16 +73902,12 @@ function requiredSize(context, usage) {
73770
73902
  var USAGE$6 = [
73771
73903
  "Usage: hostingctl platform seed placement-add <seed-uuid> <version-uuid> --cluster <uuid>",
73772
73904
  " --preparation-mode <mode> --minimum-size <MiB> [--source-storage-class <uuid>]",
73773
- " hostingctl platform seed placement-adopt <seed-uuid> <version-uuid> <placement-uuid>",
73774
- " --cluster <uuid> --storage-class <name> --backing-image <name> --expected-checksum <sha>",
73775
- " --minimum-size <MiB>",
73776
73905
  " hostingctl platform seed placement-build <seed-uuid> <version-uuid> <placement-uuid>",
73777
73906
  " [--source-storage-class <uuid>]",
73778
73907
  " hostingctl platform seed placement-retire <seed-uuid> <version-uuid> <placement-uuid>",
73779
73908
  " hostingctl platform seed placement-diagnostics <seed-uuid> <version-uuid> <placement-uuid>",
73780
73909
  "",
73781
73910
  " placement-add Ask for the version to be prepared on a cluster.",
73782
- " placement-adopt Record an image that already exists there, with the checksum it must match.",
73783
73911
  " placement-build Build the prepared image now.",
73784
73912
  " placement-retire Withdraw the prepared image from the cluster.",
73785
73913
  " placement-diagnostics What the platform observed: generations, checksums, claims and refusals."
@@ -73803,7 +73931,6 @@ async function platformSeedPlacements(context, action, seedUuid, rest) {
73803
73931
  diagnostics: (await hostingSeedPlacementDiagnostics({ path })).data
73804
73932
  };
73805
73933
  if (action === "placement-build" || action === "placement-retire") return await change(context, action === "placement-retire", third, path);
73806
- if (action === "placement-adopt") return await adopt$1(context, path);
73807
73934
  throw new UsageError(USAGE$6);
73808
73935
  }
73809
73936
  /** `placement-add`: ask for the version to be prepared on one cluster. */
@@ -73825,23 +73952,6 @@ async function add$3(context, seedUuid, versionUuid) {
73825
73952
  })).data)
73826
73953
  };
73827
73954
  }
73828
- /** `placement-adopt`: record an image that already exists on the cluster. */
73829
- async function adopt$1(context, path) {
73830
- const body = {
73831
- clusterUuid: requiredFlag$3(context, "--cluster", USAGE$6),
73832
- storageClassName: requiredFlag$3(context, "--storage-class", USAGE$6),
73833
- backingImageName: requiredFlag$3(context, "--backing-image", USAGE$6),
73834
- expectedChecksum: requiredFlag$3(context, "--expected-checksum", USAGE$6),
73835
- minimumSizeMib: requiredSize(context, USAGE$6)
73836
- };
73837
- return {
73838
- kind: "seed-write",
73839
- outcome: await confirmableWrite(context, `Adopt backing image ${body.backingImageName} (${body.storageClassName}) as placement ${path.placementUuid}, expecting checksum ${body.expectedChecksum}.`, async () => (await hostingSeedPlacementStoreAdoption({
73840
- path,
73841
- body
73842
- })).data)
73843
- };
73844
- }
73845
73955
  /** `placement-build|placement-retire`. */
73846
73956
  async function change(context, retiring, placementUuid, path) {
73847
73957
  return {
@@ -73960,8 +74070,6 @@ var USAGE$4 = [
73960
74070
  " --content-contract <path> [--release <release-uuid>]",
73961
74071
  " hostingctl platform seed placement-add <seed-uuid> <version-uuid> --cluster <uuid>",
73962
74072
  " --preparation-mode <mode> --minimum-size <MiB>",
73963
- " hostingctl platform seed placement-adopt <seed-uuid> <version-uuid> --cluster <uuid>",
73964
- " --storage-class <name> --backing-image <name> --expected-checksum <sha> --minimum-size <MiB>",
73965
74073
  " hostingctl platform seed placement-build <seed-uuid> <version-uuid> <placement-uuid>",
73966
74074
  " hostingctl platform seed placement-retire <seed-uuid> <version-uuid> <placement-uuid>",
73967
74075
  " hostingctl platform seed placement-diagnostics <seed-uuid> <version-uuid> <placement-uuid>",
@@ -73971,7 +74079,7 @@ var USAGE$4 = [
73971
74079
  " add|set|consumption Create a definition, change its preparation mode, or stop offering it.",
73972
74080
  " promote Make one version the definition's selected version.",
73973
74081
  " version-add Record a built version's source, recipe and runtime digests.",
73974
- " placement-* Prepare a version on a cluster, adopt an existing image, build or retire it.",
74082
+ " placement-* Prepare a version on a cluster, build or retire it.",
73975
74083
  "",
73976
74084
  "A content contract is supplied as JSON in the API's own shape: it is a recorded contract, not a value this CLI",
73977
74085
  "invents, so an omitted file records none. Every write needs --confirm; --dry-run describes the change."
@@ -80172,7 +80280,7 @@ function writeUpdateState(state, env = process.env) {
80172
80280
  }
80173
80281
  //#endregion
80174
80282
  //#region src/version.ts
80175
- var VERSION = "1.0.706";
80283
+ var VERSION = "1.0.721";
80176
80284
  //#endregion
80177
80285
  //#region src/commands/update.ts
80178
80286
  /**
@@ -80247,7 +80355,7 @@ var update = {
80247
80355
  }, process.env);
80248
80356
  return {
80249
80357
  ...known,
80250
- current: after ?? "1.0.706",
80358
+ current: after ?? "1.0.721",
80251
80359
  latest: after ?? latest,
80252
80360
  upToDate: after !== null && (latest === null || !isNewerVersion(latest, after)),
80253
80361
  action: "run",
@@ -80529,7 +80637,7 @@ async function printUpdateNotice(options) {
80529
80637
  }, env, { waitMs: NOTICE_LOCK_WAIT_MS });
80530
80638
  } catch {}
80531
80639
  if (latest === null) return;
80532
- if (!isNewerVersion(latest, "1.0.706")) return;
80640
+ if (!isNewerVersion(latest, "1.0.721")) return;
80533
80641
  process.stderr.write(`A newer hostingctl is published: ${latest} (this copy is ${VERSION}). Run \`hostingctl update\` to update.\n`);
80534
80642
  }
80535
80643
  /** Whether an environment variable is set to something, which is how CI and the opt-out are read. */