@leaflow/sdk 0.144.0 → 0.146.0

package/dist/compute/v1/generated/validators/setSnapshotQuotaResponseBody.zod.d.ts

@@ -26,10 +26,10 @@ export declare const SetSnapshotQuotaResponseBody: zod.ZodObject<{
     snapshot_quota: zod.ZodObject<{
         region_id: zod.ZodUUID;
         status: zod.ZodEnum<{
+            failed: "failed";
             pending: "pending";
             active: "active";
             suspended: "suspended";
-            failed: "failed";
             provisioning: "provisioning";
             inactive: "inactive";
         }>;

package/dist/compute/v1/generated/validators/snapshotListResponseBody.zod.d.ts

@@ -32,12 +32,12 @@ export declare const SnapshotListResponseBody: zod.ZodObject<{
         region_id: zod.ZodUUID;
         size_gb: zod.ZodInt;
         status: zod.ZodEnum<{
+            available: "available";
             error: "error";
-            pending: "pending";
             failed: "failed";
+            pending: "pending";
             deleted: "deleted";
             provisioning: "provisioning";
-            available: "available";
             missing: "missing";
         }>;
         operation: zod.ZodUnion<readonly [zod.ZodObject<{

package/dist/compute/v1/generated/validators/snapshotQuota.zod.d.ts

@@ -28,10 +28,10 @@ export declare const snapshotQuotaAvailableMin = 0;
 export declare const SnapshotQuota: zod.ZodObject<{
     region_id: zod.ZodUUID;
     status: zod.ZodEnum<{
+        failed: "failed";
         pending: "pending";
         active: "active";
         suspended: "suspended";
-        failed: "failed";
         provisioning: "provisioning";
         inactive: "inactive";
     }>;

package/dist/compute/v1/generated/validators/snapshotResource.zod.d.ts

@@ -31,12 +31,12 @@ export declare const SnapshotResource: zod.ZodObject<{
     region_id: zod.ZodUUID;
     size_gb: zod.ZodInt;
     status: zod.ZodEnum<{
+        available: "available";
         error: "error";
-        pending: "pending";
         failed: "failed";
+        pending: "pending";
         deleted: "deleted";
         provisioning: "provisioning";
-        available: "available";
         missing: "missing";
     }>;
     operation: zod.ZodUnion<readonly [zod.ZodObject<{

package/dist/iam/v1/generated/functions.d.ts

@@ -12,7 +12,7 @@
  * project. It does not state whether a given operation is allowed; each service declares which permission its own operations require.
  * OpenAPI spec version: 1.0.0
  */
-import type { AttachPolicyRequestBody, BatchGetMembersRequestBody, BatchGetMembersResponseBody, CatalogListResponseBody, CreateRoleRequestBody, CreateSSHKeyRequestBody, Error, IssueInvitationRequestBody, IssuedInvitationResponseBody, LengthAwarePageInvitationResource, LengthAwarePageMemberResource, LengthAwarePageSSHKeyResource, ListMembersParams, ListPoliciesParams, ListProjectInvitationsParams, ListSshKeysParams, MemberResource, MembershipResource, OwnershipTransferResponseBody, PolicyListResponseBody, PolicyResource, ProjectAccessResource, QuotaListResponseBody, RenameSSHKeyRequestBody, RoleListResponseBody, RoleResource, SSHKeyResource, SetMemberPermissionsRequestBody, SetMemberRolesRequestBody, TransferOwnershipRequestBody, UpdatePolicyRequestBody, UpdateProjectRequestBody, UpdateRoleRequestBody } from "./models.js";
+import type { AttachPolicyRequestBody, BatchGetMembersRequestBody, BatchGetMembersResponseBody, CatalogListResponseBody, CreateRoleRequestBody, CreateSSHKeyRequestBody, Error, IssueInvitationRequestBody, IssuedInvitationResponseBody, LengthAwarePageInvitationResource, LengthAwarePageMemberResource, LengthAwarePageSSHKeyResource, ListMembersParams, ListPoliciesParams, ListProjectInvitationsParams, ListSshKeysParams, MemberResource, MembershipResource, OwnershipTransferResponseBody, PolicyListResponseBody, PolicyResource, ProjectAccessResource, QuotaListResponseBody, RenameSSHKeyRequestBody, RoleListResponseBody, RoleResource, SSHKeyResource, SetMemberPermissionsRequestBody, SetMemberRolesRequestBody, SetProjectSlugRequestBody, TransferOwnershipRequestBody, UpdatePolicyRequestBody, UpdateProjectRequestBody, UpdateRoleRequestBody } from "./models.js";
 export type HTTPStatusCode1xx = 100 | 101 | 102 | 103;
 export type HTTPStatusCode2xx = 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207;
 export type HTTPStatusCode3xx = 300 | 301 | 302 | 303 | 304 | 305 | 307 | 308;
@@ -78,6 +78,7 @@ export type updateProjectResponseError = updateProjectResponseDefault & {
 export type updateProjectResponse = updateProjectResponseSuccess | updateProjectResponseError;
 export declare const getUpdateProjectUrl: () => string;
 /**
+ * The slug is not affected; it is set through `PUT /api/v1/project/slug`.
  * @summary Update the name and description of a project
  */
 export declare const updateProject: (updateProjectRequestBody: UpdateProjectRequestBody, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<updateProjectResponse>;
@@ -102,6 +103,36 @@ export declare const getDeleteProjectUrl: () => string;
  * @summary Delete a project
  */
 export declare const deleteProject: (options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<deleteProjectResponse>;
+export type setProjectSlugResponse200 = {
+    data: ProjectAccessResource;
+    status: 200;
+};
+export type setProjectSlugResponseDefault = {
+    data: Error;
+    status: Exclude<HTTPStatusCodes, 200>;
+};
+export type setProjectSlugResponseSuccess = setProjectSlugResponse200 & {
+    headers: Headers;
+};
+export type setProjectSlugResponseError = setProjectSlugResponseDefault & {
+    headers: Headers;
+};
+export type setProjectSlugResponse = setProjectSlugResponseSuccess | setProjectSlugResponseError;
+export declare const getSetProjectSlugUrl: () => string;
+/**
+ * Replaces the default slug, which is the project's `id`, with a custom one. Only the owner can do this, and only once: a custom slug cannot be changed or removed afterwards. The address under the `id` keeps working.
+ *
+ * Setting the slug the project already holds succeeds without change. Fails with:
+ *
+ * - 400 `PROJECT_SLUG_INVALID` when the slug does not follow the format described on `slug`;
+ * - 422 `PROJECT_SLUG_RESERVED` when the name is reserved;
+ * - 409 `PROJECT_SLUG_TAKEN` when another project, including a deleted one, holds it;
+ * - 412 `PROJECT_SLUG_ALREADY_SET` when the project already holds a different custom slug;
+ * - 403 `PROJECT_PERMISSION_DENIED` when the caller is not the owner;
+ * - 429 `PROJECT_SLUG_CLAIM_RATE_LIMITED` when the caller has attempted to set custom slugs too often. Attempts count whether or not they succeed, and `meta.retry_after_seconds` on the error states how many seconds to wait before retrying.
+ * @summary Set the custom slug of a project
+ */
+export declare const setProjectSlug: (setProjectSlugRequestBody: SetProjectSlugRequestBody, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<setProjectSlugResponse>;
 export type getProjectMembershipResponse200 = {
     data: MembershipResource;
     status: 200;

package/dist/iam/v1/generated/functions.js

@@ -34,6 +34,7 @@ export const getUpdateProjectUrl = () => {
     return `https://iam.leaflow.cloud/api/v1/project`;
 };
 /**
+ * The slug is not affected; it is set through `PUT /api/v1/project/slug`.
  * @summary Update the name and description of a project
  */
 export const updateProject = async (updateProjectRequestBody, options, fetchFn) => {
@@ -78,6 +79,48 @@ export const deleteProject = async (options, fetchFn) => {
     const data = body ? JSON.parse(body) : {};
     return { data, status: res.status, headers: res.headers };
 };
+export const getSetProjectSlugUrl = () => {
+    return `https://iam.leaflow.cloud/api/v1/project/slug`;
+};
+/**
+ * Replaces the default slug, which is the project's `id`, with a custom one. Only the owner can do this, and only once: a custom slug cannot be changed or removed afterwards. The address under the `id` keeps working.
+ *
+ * Setting the slug the project already holds succeeds without change. Fails with:
+ *
+ * - 400 `PROJECT_SLUG_INVALID` when the slug does not follow the format described on `slug`;
+ * - 422 `PROJECT_SLUG_RESERVED` when the name is reserved;
+ * - 409 `PROJECT_SLUG_TAKEN` when another project, including a deleted one, holds it;
+ * - 412 `PROJECT_SLUG_ALREADY_SET` when the project already holds a different custom slug;
+ * - 403 `PROJECT_PERMISSION_DENIED` when the caller is not the owner;
+ * - 429 `PROJECT_SLUG_CLAIM_RATE_LIMITED` when the caller has attempted to set custom slugs too often. Attempts count whether or not they succeed, and `meta.retry_after_seconds` on the error states how many seconds to wait before retrying.
+ * @summary Set the custom slug of a project
+ */
+export const setProjectSlug = async (setProjectSlugRequestBody, options, fetchFn) => {
+    const getHeaders = (h) => {
+        if (!h)
+            return {};
+        if (h instanceof Headers)
+            return Object.fromEntries(h.entries());
+        if (Symbol.iterator in h) {
+            return Object.fromEntries(Array.from(h, (entry) => Array.from(entry)));
+        }
+        const headers = {};
+        for (const [name, value] of Object.entries(h)) {
+            if (value !== undefined)
+                headers[name] = value;
+        }
+        return headers;
+    };
+    const res = await (fetchFn ?? fetch)(getSetProjectSlugUrl(), {
+        ...options,
+        method: "PUT",
+        headers: { "Content-Type": "application/json", ...getHeaders(options?.headers) },
+        body: JSON.stringify(setProjectSlugRequestBody),
+    });
+    const body = [204, 205, 304].includes(res.status) ? null : await res.text();
+    const data = body ? JSON.parse(body) : {};
+    return { data, status: res.status, headers: res.headers };
+};
 export const getGetProjectMembershipUrl = () => {
     return `https://iam.leaflow.cloud/api/v1/membership`;
 };

package/dist/iam/v1/generated/models.d.ts

@@ -117,6 +117,12 @@ export interface ProjectResource {
     deleted_at: string | null;
     description: string;
     id: string;
+    /**
+     * The label naming the project in its address. It equals `id` until a custom slug is chosen. A custom slug does not change once set, and stays with the project after deletion
+     * @minLength 1
+     * @maxLength 36
+     */
+    slug: string;
     name: string;
     updated_at: string;
 }
@@ -130,6 +136,14 @@ export interface UpdateProjectRequestBody {
     /** @maxLength 128 */
     name?: string;
 }
+export interface SetProjectSlugRequestBody {
+    /**
+     * 6 to 32 characters made of lower-case letters, digits and single hyphens, beginning with a letter and ending with a letter or digit
+     * @minLength 6
+     * @maxLength 32
+     */
+    slug: string;
+}
 export interface QuotaResource {
     /** The service enforcing the quota. */
     service: string;

package/dist/iam/v1/generated/schemas.zod.d.ts

@@ -14,12 +14,29 @@
  */
 import * as zod from "zod";
 /**
+ * The slug is not affected; it is set through `PUT /api/v1/project/slug`.
  * @summary Update the name and description of a project
  */
 export declare const UpdateProjectBody: zod.ZodObject<{
     description: zod.ZodOptional<zod.ZodString>;
     name: zod.ZodOptional<zod.ZodString>;
 }, zod.z.core.$strict>;
+/**
+ * Replaces the default slug, which is the project's `id`, with a custom one. Only the owner can do this, and only once: a custom slug cannot be changed or removed afterwards. The address under the `id` keeps working.
+ *
+ * Setting the slug the project already holds succeeds without change. Fails with:
+ *
+ * - 400 `PROJECT_SLUG_INVALID` when the slug does not follow the format described on `slug`;
+ * - 422 `PROJECT_SLUG_RESERVED` when the name is reserved;
+ * - 409 `PROJECT_SLUG_TAKEN` when another project, including a deleted one, holds it;
+ * - 412 `PROJECT_SLUG_ALREADY_SET` when the project already holds a different custom slug;
+ * - 403 `PROJECT_PERMISSION_DENIED` when the caller is not the owner;
+ * - 429 `PROJECT_SLUG_CLAIM_RATE_LIMITED` when the caller has attempted to set custom slugs too often. Attempts count whether or not they succeed, and `meta.retry_after_seconds` on the error states how many seconds to wait before retrying.
+ * @summary Set the custom slug of a project
+ */
+export declare const SetProjectSlugBody: zod.ZodObject<{
+    slug: zod.ZodString;
+}, zod.z.core.$strict>;
 /**
  * Visible to any member, on the same rule as the member list. Who has been invited is part of who is in the project.
  * @summary List the invitations this project is still waiting on

package/dist/iam/v1/generated/schemas.zod.js

@@ -21,14 +21,30 @@ import { IssueInvitationRequestBody } from "./validators/issueInvitationRequestB
 import { RenameSSHKeyRequestBody } from "./validators/renameSSHKeyRequestBody.zod.js";
 import { SetMemberPermissionsRequestBody } from "./validators/setMemberPermissionsRequestBody.zod.js";
 import { SetMemberRolesRequestBody } from "./validators/setMemberRolesRequestBody.zod.js";
+import { SetProjectSlugRequestBody } from "./validators/setProjectSlugRequestBody.zod.js";
 import { TransferOwnershipRequestBody } from "./validators/transferOwnershipRequestBody.zod.js";
 import { UpdatePolicyRequestBody } from "./validators/updatePolicyRequestBody.zod.js";
 import { UpdateProjectRequestBody } from "./validators/updateProjectRequestBody.zod.js";
 import { UpdateRoleRequestBody } from "./validators/updateRoleRequestBody.zod.js";
 /**
+ * The slug is not affected; it is set through `PUT /api/v1/project/slug`.
  * @summary Update the name and description of a project
  */
 export const UpdateProjectBody = UpdateProjectRequestBody;
+/**
+ * Replaces the default slug, which is the project's `id`, with a custom one. Only the owner can do this, and only once: a custom slug cannot be changed or removed afterwards. The address under the `id` keeps working.
+ *
+ * Setting the slug the project already holds succeeds without change. Fails with:
+ *
+ * - 400 `PROJECT_SLUG_INVALID` when the slug does not follow the format described on `slug`;
+ * - 422 `PROJECT_SLUG_RESERVED` when the name is reserved;
+ * - 409 `PROJECT_SLUG_TAKEN` when another project, including a deleted one, holds it;
+ * - 412 `PROJECT_SLUG_ALREADY_SET` when the project already holds a different custom slug;
+ * - 403 `PROJECT_PERMISSION_DENIED` when the caller is not the owner;
+ * - 429 `PROJECT_SLUG_CLAIM_RATE_LIMITED` when the caller has attempted to set custom slugs too often. Attempts count whether or not they succeed, and `meta.retry_after_seconds` on the error states how many seconds to wait before retrying.
+ * @summary Set the custom slug of a project
+ */
+export const SetProjectSlugBody = SetProjectSlugRequestBody;
 /**
  * Visible to any member, on the same rule as the member list. Who has been invited is part of who is in the project.
  * @summary List the invitations this project is still waiting on

package/dist/iam/v1/generated/validators/projectAccessResource.zod.d.ts

@@ -46,6 +46,7 @@ export declare const ProjectAccessResource: zod.ZodObject<{
         deleted_at: zod.ZodNullable<zod.z.ZodISODateTime>;
         description: zod.ZodString;
         id: zod.ZodUUID;
+        slug: zod.ZodString;
         name: zod.ZodString;
         updated_at: zod.z.ZodISODateTime;
     }, zod.z.core.$strict>;

package/dist/iam/v1/generated/validators/projectResource.zod.d.ts

@@ -13,6 +13,7 @@
  * OpenAPI spec version: 1.0.0
  */
 import * as zod from "zod";
+export declare const projectResourceSlugMax = 36;
 export declare const ProjectResource: zod.ZodObject<{
     traits: zod.ZodArray<zod.ZodObject<{
         key: zod.ZodString;
@@ -29,6 +30,7 @@ export declare const ProjectResource: zod.ZodObject<{
     deleted_at: zod.ZodNullable<zod.z.ZodISODateTime>;
     description: zod.ZodString;
     id: zod.ZodUUID;
+    slug: zod.ZodString;
     name: zod.ZodString;
     updated_at: zod.z.ZodISODateTime;
 }, zod.z.core.$strict>;

package/dist/iam/v1/generated/validators/projectResource.zod.js

@@ -14,6 +14,7 @@
  */
 import * as zod from "zod";
 import { ProjectTraitResource } from "./projectTraitResource.zod.js";
+export const projectResourceSlugMax = 36;
 export const ProjectResource = zod.strictObject({
     traits: zod.array(ProjectTraitResource),
     deletion_requested_at: zod.iso.datetime({ offset: true }).nullable(),
@@ -25,6 +26,11 @@ export const ProjectResource = zod.strictObject({
         .describe("When the project was deleted"),
     description: zod.string(),
     id: zod.uuid(),
+    slug: zod
+        .string()
+        .min(1)
+        .max(projectResourceSlugMax)
+        .describe("The label naming the project in its address. It equals `id` until a custom slug is chosen. A custom slug does not change once set, and stays with the project after deletion"),
     name: zod.string(),
     updated_at: zod.iso.datetime({ offset: true }),
 });

package/dist/iam/v1/generated/validators/setProjectSlugRequestBody.zod.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow IAM API
+ * What happens inside a project: members, roles, invitations and SSH keys.
+ *
+ * Every request carries a scoped token; see the `bearerAuth` security scheme. No path carries a
+ * `projectId`, and the current project is the one the token states. Tokens are obtained from the
+ * account API.
+ *
+ * `GET /api/v1/membership` returns the roles and permissions the caller holds in the current
+ * project. It does not state whether a given operation is allowed; each service declares which permission its own operations require.
+ * OpenAPI spec version: 1.0.0
+ */
+import * as zod from "zod";
+export declare const setProjectSlugRequestBodySlugMin = 6;
+export declare const setProjectSlugRequestBodySlugMax = 32;
+export declare const SetProjectSlugRequestBody: zod.ZodObject<{
+    slug: zod.ZodString;
+}, zod.z.core.$strict>;
+export type SetProjectSlugRequestBody = zod.input<typeof SetProjectSlugRequestBody>;
+export type SetProjectSlugRequestBodyOutput = zod.output<typeof SetProjectSlugRequestBody>;

package/dist/iam/v1/generated/validators/setProjectSlugRequestBody.zod.js

@@ -0,0 +1,24 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow IAM API
+ * What happens inside a project: members, roles, invitations and SSH keys.
+ *
+ * Every request carries a scoped token; see the `bearerAuth` security scheme. No path carries a
+ * `projectId`, and the current project is the one the token states. Tokens are obtained from the
+ * account API.
+ *
+ * `GET /api/v1/membership` returns the roles and permissions the caller holds in the current
+ * project. It does not state whether a given operation is allowed; each service declares which permission its own operations require.
+ * OpenAPI spec version: 1.0.0
+ */
+import * as zod from "zod";
+export const setProjectSlugRequestBodySlugMin = 6;
+export const setProjectSlugRequestBodySlugMax = 32;
+export const SetProjectSlugRequestBody = zod.strictObject({
+    slug: zod
+        .string()
+        .min(setProjectSlugRequestBodySlugMin)
+        .max(setProjectSlugRequestBodySlugMax)
+        .describe("6 to 32 characters made of lower-case letters, digits and single hyphens, beginning with a letter and ending with a letter or digit"),
+});

package/dist/membership/v1/generated/models.d.ts

@@ -575,20 +575,34 @@ export interface WithdrawalItemList {
     pagination: OffsetPagination;
 }
 /**
- * Whether a delivered purchase may end immediately or only at the end of its paid term; refunds follow the refund policy. When absent, no termination terms were agreed.
+ * Whether a cancellation of a delivered purchase may take effect immediately or only at the end of its paid term; refunds follow the refund policy. When absent, no cancellation terms were agreed.
  */
-export type TerminationPolicy = (typeof TerminationPolicy)[keyof typeof TerminationPolicy];
-export declare const TerminationPolicy: {
+export type CancellationPolicy = (typeof CancellationPolicy)[keyof typeof CancellationPolicy];
+export declare const CancellationPolicy: {
     readonly immediate: "immediate";
     readonly period_end: "period_end";
 };
 /**
- * `none` refunds nothing. `prorated` refunds the amount paid for the current period minus the value of the time used, never below zero or above what remains unrefunded. Time used runs from the period start to the effective cancellation and is valued at prices frozen on the order item: each full calendar month at `refund_monthly_amount`, the rest at `refund_hourly_amount` or, without it, at the monthly price by the second. When the plan has no licensed period shorter than the one bought, time used is valued pro rata at the price paid. Discounts and setup fees are not refunded. Refunds return to the original payment sources, with tax refunded in proportion.
+ * `none` refunds nothing.
+ *
+ * `prorated` refunds the amount paid for the current period minus the value of the time used, never below zero
+ * or above what remains unrefunded. Time used runs from the period start to the effective cancellation, by the
+ * second. Each whole month from the period start is valued at the order item's `monthly_list_amount`, and the
+ * remainder at that amount in proportion to the length of the month it falls in; without `monthly_list_amount`,
+ * time used is valued at the amount paid in proportion to the length of the period. A renewal starts a new
+ * period, and an immediate change starts one at the change. Discounts and setup fees are not refunded. Refunds
+ * return to the original payment sources, with tax refunded in proportion.
+ *
+ * `short_rate` refunds as `prorated`, except that when the cancellation takes effect less than
+ * `short_rate_threshold_seconds` after the period start, the value of the time used is multiplied by
+ * `short_rate_multiplier`, up to `monthly_list_amount` for each month begun or, without `monthly_list_amount`,
+ * up to the amount paid.
  */
 export type RefundPolicy = (typeof RefundPolicy)[keyof typeof RefundPolicy];
 export declare const RefundPolicy: {
     readonly none: "none";
     readonly prorated: "prorated";
+    readonly short_rate: "short_rate";
 };
 export interface OrderCancel {
     /**
@@ -608,8 +622,8 @@ export declare const QuoteRenewalInterval: {
  * Price renewing a licensed subscription. Give `price_id`, or `interval` with
  * `interval_count`, to renew for another term at the price currently sold for it. Naming
  * the current term, or giving neither, renews at the agreed amount. A term sold at several
- * prices that differ in termination policy is refused with 409
- * `BILLING_RENEWAL_OPTION_AMBIGUOUS` unless `termination_policy` or `price_id` is given.
+ * prices that differ in cancellation policy is refused with 409
+ * `BILLING_RENEWAL_OPTION_AMBIGUOUS` unless `cancellation_policy` or `price_id` is given.
  */
 export interface QuoteRenewal {
     subscription_id: string;
@@ -617,8 +631,8 @@ export interface QuoteRenewal {
     interval?: QuoteRenewalInterval;
     /** @minimum 1 */
     interval_count?: number;
-    /** With `interval` and `interval_count`, chooses among prices of that term that differ in termination policy. */
-    termination_policy?: TerminationPolicy;
+    /** With `interval` and `interval_count`, chooses among prices of that term that differ in cancellation policy. */
+    cancellation_policy?: CancellationPolicy;
     /**
      * How many consecutive periods to renew for.
      * @minimum 1
@@ -754,6 +768,7 @@ export interface CancellationRefundPreviewItem {
     /** Whether automatic renewal is on now. Creating the cancellation turns it off; withdrawing it turns it back on for a metered subscription but not for a licensed one. */
     auto_renew: boolean;
     unused_amount: Money;
+    short_rate_surcharge_amount: Money;
     refundable_amount: Money;
     refund_amount: Money;
     credit_amount: Money;
@@ -764,8 +779,9 @@ export interface CancellationRefundPreviewItem {
  * What the cancellation would return, per subscription and in total, as of now. Give `proration_date` and
  * `refundable_amount` when creating the cancellation.
  *
- * - `unused_amount`: before tax, the amount paid for the current periods minus the value of the time used,
- *   valued as refund policy `prorated` describes, whatever the refund terms say.
+ * - `unused_amount`: before tax, the amount paid for the current periods in proportion to the time remaining.
+ * - `short_rate_surcharge_amount`: before tax, the part of `forfeited_amount` due to the short rate of the
+ *   refund policy.
  * - `refundable_amount`: what is returned the way it was paid, tax included; `refund_amount` plus
  *   `credit_amount`.
  * - `refund_amount`: the part returned to the balance or the payment method.
@@ -776,13 +792,14 @@ export interface CancellationRefundPreviewItem {
  * Metered and one-time subscriptions show zero; their usage until release is charged as usual.
  */
 export interface CancellationRefundPreview {
-    mode: TerminationPolicy;
+    mode: CancellationPolicy;
     /** For `period_end`, when release begins, the end of the paid terms. */
     scheduled_at?: string;
     /** For `immediate`, the second the refund is computed as of. Give it when creating the cancellation. */
     proration_date?: string;
     currency: string;
     unused_amount: Money;
+    short_rate_surcharge_amount: Money;
     refundable_amount: Money;
     refund_amount: Money;
     credit_amount: Money;
@@ -791,7 +808,7 @@ export interface CancellationRefundPreview {
     items: CancellationRefundPreviewItem[];
 }
 /**
- * An estimated refund to the original payment sources. Before acceptance, cancellation returns the collected amount. For delivered service, only value paid by this order is included; renewals are evaluated with their own orders under the agreed termination terms. Nothing is refunded by the quote; the amount is fixed when cancellation or termination is confirmed.
+ * An estimated refund to the original payment sources. Before acceptance, cancellation returns the collected amount. For delivered service, only value paid by this order is included; renewals are evaluated with their own orders under the agreed cancellation terms. Nothing is refunded by the quote; the amount is fixed when cancellation or termination is confirmed.
  */
 export interface OrderRefundQuote {
     order_id: string;
@@ -830,7 +847,7 @@ export interface QuoteCancellation {
      * @maxItems 50
      */
     subscription_ids: string[];
-    mode: TerminationPolicy;
+    mode: CancellationPolicy;
 }
 export interface CancellationCreate {
     /**
@@ -839,7 +856,7 @@ export interface CancellationCreate {
      * @maxItems 50
      */
     subscription_ids: string[];
-    mode: TerminationPolicy;
+    mode: CancellationPolicy;
     /** For `immediate`, the quote's `proration_date`: a whole second, not in the future and at most ten minutes old; the refund is computed as of it. Now when omitted. */
     proration_date?: string;
     /** The quote's `refundable_amount`; the cancellation is refused when the refund differs. */
@@ -919,7 +936,7 @@ export interface CancellationItem {
 export interface Cancellation {
     id: string;
     status: CancellationStatus;
-    mode: TerminationPolicy;
+    mode: CancellationPolicy;
     scheduled_at?: string;
     /** For `immediate`, the second the refund is computed as of. */
     proration_date?: string;
@@ -1837,9 +1854,11 @@ export declare const RefundStatus: {
  * - `change_expired`: a scheduled change could not take effect in time.
  * - `subscription_canceled`: the unused value of a canceled subscription, under its refund terms.
  * - `future_period_canceled`: a renewal that had not started was withdrawn.
- * - `downgrade_difference`: after a downgrade, the remaining paid value, valued as refund policy `prorated`
- *   describes, minus the new configuration's cost for the remaining time at the change item's
- *   `refund_monthly_amount` and `refund_hourly_amount`.
+ * - `downgrade_difference`: after a downgrade, the remaining paid value, valued under each paid period's refund
+ *   policy and as `prorated` where that policy is `none`, minus the new configuration's value for the remaining
+ *   time: each whole month at the change item's `monthly_list_amount` and the remainder in proportion to the
+ *   length of the month it falls in, or without `monthly_list_amount`, the new period price in proportion to the
+ *   remaining time.
  * - `usage_true_up`: usage priced over the whole month cost less than was charged.
  * - `payment_not_applied`: a payment arrived after its invoice could no longer be paid.
  * - `operator`: made by the platform operator.
@@ -2060,8 +2079,14 @@ export interface Subscription {
     interval_count?: number;
     /** The whole licensed subscription's renewal amount, after continuing discounts and before tax. A pending subscription shows base terms until paying the order fixes any new discount. Absent for metered and one-time subscriptions. */
     recurring_amount?: string;
-    termination_policy?: TerminationPolicy;
+    cancellation_policy?: CancellationPolicy;
     refund_policy?: RefundPolicy;
+    /** Refund policy `short_rate` only, as on the price bought. */
+    short_rate_multiplier?: string;
+    /** Refund policy `short_rate` only, as on the price bought. */
+    short_rate_threshold_seconds?: number;
+    /** Licensed recurring only, the `monthly_list_amount` that a renewal at the agreed amount keeps; see the order item. */
+    monthly_list_amount?: string;
     order_item_id?: string;
     coupon_id?: string;
     coupon?: ObjectIdentity;
@@ -2134,8 +2159,12 @@ export declare const RenewalPriceInterval: {
     readonly year: "year";
 };
 export interface RenewalPrice {
-    termination_policy?: TerminationPolicy;
+    cancellation_policy?: CancellationPolicy;
     refund_policy?: RefundPolicy;
+    /** Refund policy `short_rate` only. */
+    short_rate_multiplier?: string;
+    /** Refund policy `short_rate` only. */
+    short_rate_threshold_seconds?: number;
     price_id: string;
     /** How many periods one renewal covers. */
     interval_count: number;
@@ -2174,8 +2203,8 @@ export interface RenewRequest {
      * Leaving both out renews at the price this item already bills at, which a later price
      * change does not affect. Naming a term that differs from the current one is a fresh
      * choice, so it is bought at today's price. Naming the current term changes nothing. A
-     * term sold at several prices that differ in termination policy is refused with 409
-     * `BILLING_RENEWAL_OPTION_AMBIGUOUS` unless `termination_policy` is given.
+     * term sold at several prices that differ in cancellation policy is refused with 409
+     * `BILLING_RENEWAL_OPTION_AMBIGUOUS` unless `cancellation_policy` is given.
      *
      * List the terms on offer with the renewal prices operation.
      * @minimum 1
@@ -2183,8 +2212,8 @@ export interface RenewRequest {
     interval_count?: number;
     /** The unit interval_count counts in. */
     interval?: RenewRequestInterval;
-    /** With `interval` and `interval_count`, chooses among prices of that term that differ in termination policy. */
-    termination_policy?: TerminationPolicy;
+    /** With `interval` and `interval_count`, chooses among prices of that term that differ in cancellation policy. */
+    cancellation_policy?: CancellationPolicy;
     payment_method_id?: string;
     /** Whether to pay from the balance, with or without `payment_method_id`. */
     use_balance?: boolean;
@@ -2220,7 +2249,7 @@ export interface RenewalOrderRequest {
     /** As in renewing. */
     interval?: RenewalOrderRequestInterval;
     /** As in renewing. */
-    termination_policy?: TerminationPolicy;
+    cancellation_policy?: CancellationPolicy;
 }
 export interface AutoRenewSet {
     auto_renew: boolean;
@@ -2301,18 +2330,23 @@ export interface OrderItem {
     interval: OrderItemInterval;
     /** @minimum 1 */
     interval_count?: number;
-    termination_policy?: TerminationPolicy;
+    cancellation_policy?: CancellationPolicy;
     refund_policy?: RefundPolicy;
     /**
-     * Recurring licensed items only: the plan's one-month licensed price for this item's quantity, before tax and frozen at purchase, used to value time under a prorated refund or a downgrade. Null when the plan has no licensed period shorter than the one bought.
+     * Recurring licensed items only: a month at list price for this item's quantity, before tax and discounts, which values time under a refund or a downgrade. It is the monthly amount of the shortest period the plan sells, not longer than the one bought, at the item's dimensions, fixed at purchase; a renewal at the agreed amount keeps the previous value. Null when time used is valued at the amount paid, as for a daily period.
+     * @nullable
+     */
+    monthly_list_amount?: string | null;
+    /**
+     * Refund policy `short_rate` only, as on the price when bought.
      * @nullable
      */
-    refund_monthly_amount?: string | null;
+    short_rate_multiplier?: string | null;
     /**
-     * Recurring licensed items only, the plan's metered hourly price for this item's quantity before tax, frozen at purchase, used for time used short of a full month. Null when the licensed price has no meter.
+     * Refund policy `short_rate` only, as on the price when bought.
      * @nullable
      */
-    refund_hourly_amount?: string | null;
+    short_rate_threshold_seconds?: number | null;
     recurring_amount?: string;
     setup_amount?: string;
     type: PriceType;
@@ -2644,8 +2678,12 @@ export interface Price {
     unit_quantity: string;
     /** False once archived. An archived price cannot be bought until it is active again. */
     active: boolean;
-    termination_policy?: TerminationPolicy;
+    cancellation_policy?: CancellationPolicy;
     refund_policy?: RefundPolicy;
+    /** Refund policy `short_rate` only, the factor applied to the value of the time used when a cancellation takes effect less than `short_rate_threshold_seconds` after the period start. */
+    short_rate_multiplier?: string;
+    /** Refund policy `short_rate` only, how long after the period start `short_rate_multiplier` applies. */
+    short_rate_threshold_seconds?: number;
     product_id?: ProductID;
     id: string;
     plan_id: string;
@@ -2770,7 +2808,7 @@ export interface QuoteItemInput {
     /** @minimum 1 */
     interval_count?: number;
     /** Selects among licensed prices with otherwise identical billing terms. Ambiguous terms are refused instead of choosing a price arbitrarily. */
-    termination_policy?: TerminationPolicy;
+    cancellation_policy?: CancellationPolicy;
     /** @pattern ^(?:(?:[1-9][0-9]{0,27}|0(?:[1-9][0-9]{0,26}|0(?:[1-9][0-9]{0,25}|0(?:[1-9][0-9]{0,24}|0(?:[1-9][0-9]{0,23}|0(?:[1-9][0-9]{0,22}|0(?:[1-9][0-9]{0,21}|0(?:[1-9][0-9]{0,20}|0(?:[1-9][0-9]{0,19}|0(?:[1-9][0-9]{0,18}|0(?:[1-9][0-9]{0,17}|0(?:[1-9][0-9]{0,16}|0(?:[1-9][0-9]{0,15}|0(?:[1-9][0-9]{0,14}|0(?:[1-9][0-9]{0,13}|0(?:[1-9][0-9]{0,12}|0(?:[1-9][0-9]{0,11}|0(?:[1-9][0-9]{0,10}|0(?:[1-9][0-9]{0,9}|0(?:[1-9][0-9]{0,8}|0(?:[1-9][0-9]{0,7}|0(?:[1-9][0-9]{0,6}|0(?:[1-9][0-9]{0,5}|0(?:[1-9][0-9]{0,4}|0(?:[1-9][0-9]{0,3}|0(?:[1-9][0-9]{0,2}|0(?:[1-9][0-9]{0,1}|0[1-9])))))))))))))))))))))))))))([.][0-9]{1,10})?|0{1,28}[.](?:[1-9][0-9]{0,9}|0(?:[1-9][0-9]{0,8}|0(?:[1-9][0-9]{0,7}|0(?:[1-9][0-9]{0,6}|0(?:[1-9][0-9]{0,5}|0(?:[1-9][0-9]{0,4}|0(?:[1-9][0-9]{0,3}|0(?:[1-9][0-9]{0,2}|0(?:[1-9][0-9]{0,1}|0[1-9]))))))))))$ */
     quantity: string;
     meter_id?: string;
@@ -2995,7 +3033,7 @@ export interface ContactList {
     pagination: OffsetPagination;
 }
 export interface CancelSubscriptionRequest {
-    mode: TerminationPolicy;
+    mode: CancellationPolicy;
     /** For immediate cancellation, the quoted whole-second refund basis. Now when omitted. */
     proration_date?: string;
     /** The cancellation quote's refundable amount, including an explicit zero. */

package/dist/membership/v1/generated/models.js

@@ -59,13 +59,14 @@ export const WithdrawalStatus = {
     failed: "failed",
     reversed: "reversed",
 };
-export const TerminationPolicy = {
+export const CancellationPolicy = {
     immediate: "immediate",
     period_end: "period_end",
 };
 export const RefundPolicy = {
     none: "none",
     prorated: "prorated",
+    short_rate: "short_rate",
 };
 export const QuoteRenewalInterval = {
     day: "day",