@leaflow/sdk 0.121.0 → 0.122.0

package/dist/membership/v1/generated/validators/transaction.zod.js

@@ -0,0 +1,63 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Membership API
+ * Membership plans and the memberships held by billing accounts.
+ *
+ * A membership is a prepaid subscription sold through Billing. For each paid period it issues the plan's benefits to the billing account. A plan can carry several benefits across services: credit for chosen services, coupons on purchases and metered usage, and usage allowances such as model tokens, and access to features of other services. Benefits are shared by every project paid for by the account.
+ *
+ * ## Authentication
+ *
+ * Plans are public. Memberships require an access token; see the `accessTokenAuth` security scheme. Only the owner of a billing account can read or change its membership; anyone else receives 403 `MEMBERSHIP_ACCOUNT_FORBIDDEN`.
+ *
+ * ## Conventions
+ *
+ * - **One membership per billing account.** A pending or active membership must end before another is bought; change plans with upgrade and downgrade instead.
+ * - **Payment goes through Billing.** Purchases and upgrades return a Billing order. With `checkout.mode` `deferred`, pay the order's invoice through Billing. Benefits are issued once Billing reports the order ready; every order has an invoice, including a zero-total one, which is paid automatically.
+ * - **Cancellation and auto-renewal are managed in Billing** on the membership's `subscription_id`. A cancellation takes effect at the end of the paid period without a refund, and the period's benefits remain until then.
+ * - **An upgrade takes effect immediately** for the full difference between the two plans' period prices, whatever remains of the period. The difference in credit is issued in full and the new plan's discount applies from payment. Renewals are charged at the new plan's price.
+ * - **A downgrade takes effect at the end of the paid period.** The current period keeps its benefits and nothing is refunded.
+ * - **Amounts are decimal strings** in the billing account's currency. There is no currency conversion: a plan without a price or credit in the account's currency cannot be bought with it.
+ * OpenAPI spec version: 1.0.0
+ */
+import * as zod from "zod";
+import { Money } from "./money.zod.js";
+import { ObjectIdentity } from "./objectIdentity.zod.js";
+import { PaymentCancellationReason } from "./paymentCancellationReason.zod.js";
+import { TransactionType } from "./transactionType.zod.js";
+export const Transaction = zod
+    .strictObject({
+    invoice_id: zod.uuid().optional(),
+    transaction_id: zod.uuid().optional(),
+    credit_grant_id: zod
+        .uuid()
+        .optional()
+        .describe("The credit grant that paid, or for a refund, the credit grant restored."),
+    credit_grant: ObjectIdentity.optional(),
+    refund_id: zod.uuid().optional(),
+    refund_destination: zod
+        .enum(["balance", "credit", "gateway"])
+        .optional()
+        .describe("Present on refunds. Where this part of the refund goes.\n\n- `balance`: back to the account balance.\n- `credit`: back to the credit grant that paid, which keeps its original expiry.\n- `gateway`: back to the payment method it was paid with."),
+    status: zod
+        .enum(["pending", "succeeded", "failed", "canceled"])
+        .optional()
+        .describe("`failed` means the operation did not succeed; for a gateway payment, that the gateway declined\nit. `canceled` means a gateway payment was withdrawn without collecting money. After either,\nan invoice the payment was meant to pay remains open for another payment."),
+    cancellation_reason: PaymentCancellationReason.optional(),
+    payment_gateway: zod.string().optional(),
+    method_type: zod.string().optional(),
+    failure_reason: zod
+        .string()
+        .optional()
+        .describe("Why it failed. Present with `failed`. For a declined gateway payment the value is the\ngateway's own code, passed on unchanged: the card issuer's decline code when there is one\n(Stripe's decline_code, such as insufficient_funds or lost_card), otherwise the gateway's\nerror code (Stripe's code, such as card_declined, expired_card or\npayment_intent_authentication_failure). Clients map it to their own wording and treat an\nunknown value as a generic decline."),
+    settled_at: zod.iso.datetime({ offset: true }).optional(),
+    id: zod.uuid(),
+    billing_account_id: zod.int().optional(),
+    type: TransactionType,
+    amount: Money.describe("Signed by type: positive for `topup` and `payment`, negative for `refund`.\nAn `adjustment` is positive when it adds to the balance and negative when it takes from\nit. For the other types the sign does not tell the effect on the balance: a payment from\nthe balance lowers it, while a payment by gateway or by credit leaves it unchanged."),
+    remaining_amount: Money.describe("How much of this transaction is still available in the balance. Only top-ups, positive\nadjustments and gateway payments later returned to the balance can be non-zero."),
+    currency: zod.string(),
+    reason: zod.string().optional(),
+    created_at: zod.iso.datetime({ offset: true }),
+})
+    .describe("A funds operation. Each payment has one source; refunds identify the original successful transaction. Unknown gateway results remain pending. Payments from the balance or a gateway are distinct from credit-grant payments.");

package/dist/membership/v1/generated/validators/transactionList.zod.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Membership API
+ * Membership plans and the memberships held by billing accounts.
+ *
+ * A membership is a prepaid subscription sold through Billing. For each paid period it issues the plan's benefits to the billing account. A plan can carry several benefits across services: credit for chosen services, coupons on purchases and metered usage, and usage allowances such as model tokens, and access to features of other services. Benefits are shared by every project paid for by the account.
+ *
+ * ## Authentication
+ *
+ * Plans are public. Memberships require an access token; see the `accessTokenAuth` security scheme. Only the owner of a billing account can read or change its membership; anyone else receives 403 `MEMBERSHIP_ACCOUNT_FORBIDDEN`.
+ *
+ * ## Conventions
+ *
+ * - **One membership per billing account.** A pending or active membership must end before another is bought; change plans with upgrade and downgrade instead.
+ * - **Payment goes through Billing.** Purchases and upgrades return a Billing order. With `checkout.mode` `deferred`, pay the order's invoice through Billing. Benefits are issued once Billing reports the order ready; every order has an invoice, including a zero-total one, which is paid automatically.
+ * - **Cancellation and auto-renewal are managed in Billing** on the membership's `subscription_id`. A cancellation takes effect at the end of the paid period without a refund, and the period's benefits remain until then.
+ * - **An upgrade takes effect immediately** for the full difference between the two plans' period prices, whatever remains of the period. The difference in credit is issued in full and the new plan's discount applies from payment. Renewals are charged at the new plan's price.
+ * - **A downgrade takes effect at the end of the paid period.** The current period keeps its benefits and nothing is refunded.
+ * - **Amounts are decimal strings** in the billing account's currency. There is no currency conversion: a plan without a price or credit in the account's currency cannot be bought with it.
+ * OpenAPI spec version: 1.0.0
+ */
+import * as zod from "zod";
+export declare const TransactionList: zod.ZodObject<{
+    items: zod.ZodArray<zod.ZodObject<{
+        invoice_id: zod.ZodOptional<zod.ZodUUID>;
+        transaction_id: zod.ZodOptional<zod.ZodUUID>;
+        credit_grant_id: zod.ZodOptional<zod.ZodUUID>;
+        credit_grant: zod.ZodOptional<zod.ZodObject<{
+            lookup_key: zod.ZodOptional<zod.ZodString>;
+            id: zod.ZodUUID;
+            name: zod.ZodString;
+        }, zod.z.core.$strict>>;
+        refund_id: zod.ZodOptional<zod.ZodUUID>;
+        refund_destination: zod.ZodOptional<zod.ZodEnum<{
+            balance: "balance";
+            credit: "credit";
+            gateway: "gateway";
+        }>>;
+        status: zod.ZodOptional<zod.ZodEnum<{
+            pending: "pending";
+            failed: "failed";
+            canceled: "canceled";
+            succeeded: "succeeded";
+        }>>;
+        cancellation_reason: zod.ZodOptional<zod.ZodEnum<{
+            abandoned: "abandoned";
+            requested_by_customer: "requested_by_customer";
+        }>>;
+        payment_gateway: zod.ZodOptional<zod.ZodString>;
+        method_type: zod.ZodOptional<zod.ZodString>;
+        failure_reason: zod.ZodOptional<zod.ZodString>;
+        settled_at: zod.ZodOptional<zod.z.ZodISODateTime>;
+        id: zod.ZodUUID;
+        billing_account_id: zod.ZodOptional<zod.ZodInt>;
+        type: zod.ZodEnum<{
+            topup: "topup";
+            payment: "payment";
+            refund: "refund";
+            adjustment: "adjustment";
+        }>;
+        amount: zod.ZodString;
+        remaining_amount: zod.ZodString;
+        currency: zod.ZodString;
+        reason: zod.ZodOptional<zod.ZodString>;
+        created_at: zod.z.ZodISODateTime;
+    }, zod.z.core.$strict>>;
+    pagination: zod.ZodObject<{
+        page: zod.ZodInt;
+        page_size: zod.ZodInt;
+        total_count: zod.ZodOptional<zod.ZodInt>;
+    }, zod.z.core.$strict>;
+}, zod.z.core.$strict>;
+export type TransactionList = zod.input<typeof TransactionList>;
+export type TransactionListOutput = zod.output<typeof TransactionList>;

package/dist/membership/v1/generated/validators/transactionList.zod.js

@@ -0,0 +1,29 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Membership API
+ * Membership plans and the memberships held by billing accounts.
+ *
+ * A membership is a prepaid subscription sold through Billing. For each paid period it issues the plan's benefits to the billing account. A plan can carry several benefits across services: credit for chosen services, coupons on purchases and metered usage, and usage allowances such as model tokens, and access to features of other services. Benefits are shared by every project paid for by the account.
+ *
+ * ## Authentication
+ *
+ * Plans are public. Memberships require an access token; see the `accessTokenAuth` security scheme. Only the owner of a billing account can read or change its membership; anyone else receives 403 `MEMBERSHIP_ACCOUNT_FORBIDDEN`.
+ *
+ * ## Conventions
+ *
+ * - **One membership per billing account.** A pending or active membership must end before another is bought; change plans with upgrade and downgrade instead.
+ * - **Payment goes through Billing.** Purchases and upgrades return a Billing order. With `checkout.mode` `deferred`, pay the order's invoice through Billing. Benefits are issued once Billing reports the order ready; every order has an invoice, including a zero-total one, which is paid automatically.
+ * - **Cancellation and auto-renewal are managed in Billing** on the membership's `subscription_id`. A cancellation takes effect at the end of the paid period without a refund, and the period's benefits remain until then.
+ * - **An upgrade takes effect immediately** for the full difference between the two plans' period prices, whatever remains of the period. The difference in credit is issued in full and the new plan's discount applies from payment. Renewals are charged at the new plan's price.
+ * - **A downgrade takes effect at the end of the paid period.** The current period keeps its benefits and nothing is refunded.
+ * - **Amounts are decimal strings** in the billing account's currency. There is no currency conversion: a plan without a price or credit in the account's currency cannot be bought with it.
+ * OpenAPI spec version: 1.0.0
+ */
+import * as zod from "zod";
+import { OffsetPagination } from "./offsetPagination.zod.js";
+import { Transaction } from "./transaction.zod.js";
+export const TransactionList = zod.strictObject({
+    items: zod.array(Transaction),
+    pagination: OffsetPagination,
+});

package/dist/membership/v1/generated/validators/transactionType.zod.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Membership API
+ * Membership plans and the memberships held by billing accounts.
+ *
+ * A membership is a prepaid subscription sold through Billing. For each paid period it issues the plan's benefits to the billing account. A plan can carry several benefits across services: credit for chosen services, coupons on purchases and metered usage, and usage allowances such as model tokens, and access to features of other services. Benefits are shared by every project paid for by the account.
+ *
+ * ## Authentication
+ *
+ * Plans are public. Memberships require an access token; see the `accessTokenAuth` security scheme. Only the owner of a billing account can read or change its membership; anyone else receives 403 `MEMBERSHIP_ACCOUNT_FORBIDDEN`.
+ *
+ * ## Conventions
+ *
+ * - **One membership per billing account.** A pending or active membership must end before another is bought; change plans with upgrade and downgrade instead.
+ * - **Payment goes through Billing.** Purchases and upgrades return a Billing order. With `checkout.mode` `deferred`, pay the order's invoice through Billing. Benefits are issued once Billing reports the order ready; every order has an invoice, including a zero-total one, which is paid automatically.
+ * - **Cancellation and auto-renewal are managed in Billing** on the membership's `subscription_id`. A cancellation takes effect at the end of the paid period without a refund, and the period's benefits remain until then.
+ * - **An upgrade takes effect immediately** for the full difference between the two plans' period prices, whatever remains of the period. The difference in credit is issued in full and the new plan's discount applies from payment. Renewals are charged at the new plan's price.
+ * - **A downgrade takes effect at the end of the paid period.** The current period keeps its benefits and nothing is refunded.
+ * - **Amounts are decimal strings** in the billing account's currency. There is no currency conversion: a plan without a price or credit in the account's currency cannot be bought with it.
+ * OpenAPI spec version: 1.0.0
+ */
+import * as zod from "zod";
+export declare const TransactionType: zod.ZodEnum<{
+    topup: "topup";
+    payment: "payment";
+    refund: "refund";
+    adjustment: "adjustment";
+}>;
+export type TransactionType = zod.input<typeof TransactionType>;
+export type TransactionTypeOutput = zod.output<typeof TransactionType>;

package/dist/membership/v1/generated/validators/transactionType.zod.js

@@ -0,0 +1,26 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Membership API
+ * Membership plans and the memberships held by billing accounts.
+ *
+ * A membership is a prepaid subscription sold through Billing. For each paid period it issues the plan's benefits to the billing account. A plan can carry several benefits across services: credit for chosen services, coupons on purchases and metered usage, and usage allowances such as model tokens, and access to features of other services. Benefits are shared by every project paid for by the account.
+ *
+ * ## Authentication
+ *
+ * Plans are public. Memberships require an access token; see the `accessTokenAuth` security scheme. Only the owner of a billing account can read or change its membership; anyone else receives 403 `MEMBERSHIP_ACCOUNT_FORBIDDEN`.
+ *
+ * ## Conventions
+ *
+ * - **One membership per billing account.** A pending or active membership must end before another is bought; change plans with upgrade and downgrade instead.
+ * - **Payment goes through Billing.** Purchases and upgrades return a Billing order. With `checkout.mode` `deferred`, pay the order's invoice through Billing. Benefits are issued once Billing reports the order ready; every order has an invoice, including a zero-total one, which is paid automatically.
+ * - **Cancellation and auto-renewal are managed in Billing** on the membership's `subscription_id`. A cancellation takes effect at the end of the paid period without a refund, and the period's benefits remain until then.
+ * - **An upgrade takes effect immediately** for the full difference between the two plans' period prices, whatever remains of the period. The difference in credit is issued in full and the new plan's discount applies from payment. Renewals are charged at the new plan's price.
+ * - **A downgrade takes effect at the end of the paid period.** The current period keeps its benefits and nothing is refunded.
+ * - **Amounts are decimal strings** in the billing account's currency. There is no currency conversion: a plan without a price or credit in the account's currency cannot be bought with it.
+ * OpenAPI spec version: 1.0.0
+ */
+import * as zod from "zod";
+export const TransactionType = zod
+    .enum(["topup", "payment", "refund", "adjustment"])
+    .describe("topup adds to the balance; payment settles an invoice; refund returns original funds; adjustment changes the balance with an audit reason.");

package/dist/membership/v1/generated/validators/usageCharge.zod.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Membership API
+ * Membership plans and the memberships held by billing accounts.
+ *
+ * A membership is a prepaid subscription sold through Billing. For each paid period it issues the plan's benefits to the billing account. A plan can carry several benefits across services: credit for chosen services, coupons on purchases and metered usage, and usage allowances such as model tokens, and access to features of other services. Benefits are shared by every project paid for by the account.
+ *
+ * ## Authentication
+ *
+ * Plans are public. Memberships require an access token; see the `accessTokenAuth` security scheme. Only the owner of a billing account can read or change its membership; anyone else receives 403 `MEMBERSHIP_ACCOUNT_FORBIDDEN`.
+ *
+ * ## Conventions
+ *
+ * - **One membership per billing account.** A pending or active membership must end before another is bought; change plans with upgrade and downgrade instead.
+ * - **Payment goes through Billing.** Purchases and upgrades return a Billing order. With `checkout.mode` `deferred`, pay the order's invoice through Billing. Benefits are issued once Billing reports the order ready; every order has an invoice, including a zero-total one, which is paid automatically.
+ * - **Cancellation and auto-renewal are managed in Billing** on the membership's `subscription_id`. A cancellation takes effect at the end of the paid period without a refund, and the period's benefits remain until then.
+ * - **An upgrade takes effect immediately** for the full difference between the two plans' period prices, whatever remains of the period. The difference in credit is issued in full and the new plan's discount applies from payment. Renewals are charged at the new plan's price.
+ * - **A downgrade takes effect at the end of the paid period.** The current period keeps its benefits and nothing is refunded.
+ * - **Amounts are decimal strings** in the billing account's currency. There is no currency conversion: a plan without a price or credit in the account's currency cannot be bought with it.
+ * OpenAPI spec version: 1.0.0
+ */
+import * as zod from "zod";
+export declare const UsageCharge: zod.ZodObject<{
+    subscription_id: zod.ZodUUID;
+    id: zod.ZodUUID;
+    project_id: zod.ZodOptional<zod.ZodUUID>;
+    project: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodObject<{
+        id: zod.ZodUUID;
+        name: zod.ZodString;
+    }, zod.z.core.$strict>, zod.ZodNull]>>;
+    product: zod.ZodObject<{
+        id: zod.ZodString;
+        name: zod.ZodString;
+        description: zod.ZodOptional<zod.ZodString>;
+    }, zod.z.core.$strict>;
+    resource_id: zod.ZodOptional<zod.ZodString>;
+    meter: zod.ZodObject<{
+        lookup_key: zod.ZodOptional<zod.ZodString>;
+        id: zod.ZodUUID;
+        name: zod.ZodString;
+    }, zod.z.core.$strict>;
+    unit: zod.ZodOptional<zod.ZodString>;
+    dimensions: zod.ZodOptional<zod.ZodRecord<zod.ZodString, zod.ZodString>>;
+    window_start: zod.z.ZodISODateTime;
+    window_end: zod.z.ZodISODateTime;
+    gross_quantity: zod.ZodOptional<zod.ZodString>;
+    deducted_quantity: zod.ZodOptional<zod.ZodString>;
+    quantity: zod.ZodString;
+    unit_amount: zod.ZodOptional<zod.ZodString>;
+    amount: zod.ZodString;
+    currency: zod.ZodString;
+    invoice_id: zod.ZodOptional<zod.ZodNullable<zod.ZodUUID>>;
+    invoice_item_id: zod.ZodOptional<zod.ZodNullable<zod.ZodUUID>>;
+    statement_id: zod.ZodOptional<zod.ZodUUID>;
+}, zod.z.core.$strict>;
+export type UsageCharge = zod.input<typeof UsageCharge>;
+export type UsageChargeOutput = zod.output<typeof UsageCharge>;

package/dist/membership/v1/generated/validators/usageCharge.zod.js

@@ -0,0 +1,72 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Membership API
+ * Membership plans and the memberships held by billing accounts.
+ *
+ * A membership is a prepaid subscription sold through Billing. For each paid period it issues the plan's benefits to the billing account. A plan can carry several benefits across services: credit for chosen services, coupons on purchases and metered usage, and usage allowances such as model tokens, and access to features of other services. Benefits are shared by every project paid for by the account.
+ *
+ * ## Authentication
+ *
+ * Plans are public. Memberships require an access token; see the `accessTokenAuth` security scheme. Only the owner of a billing account can read or change its membership; anyone else receives 403 `MEMBERSHIP_ACCOUNT_FORBIDDEN`.
+ *
+ * ## Conventions
+ *
+ * - **One membership per billing account.** A pending or active membership must end before another is bought; change plans with upgrade and downgrade instead.
+ * - **Payment goes through Billing.** Purchases and upgrades return a Billing order. With `checkout.mode` `deferred`, pay the order's invoice through Billing. Benefits are issued once Billing reports the order ready; every order has an invoice, including a zero-total one, which is paid automatically.
+ * - **Cancellation and auto-renewal are managed in Billing** on the membership's `subscription_id`. A cancellation takes effect at the end of the paid period without a refund, and the period's benefits remain until then.
+ * - **An upgrade takes effect immediately** for the full difference between the two plans' period prices, whatever remains of the period. The difference in credit is issued in full and the new plan's discount applies from payment. Renewals are charged at the new plan's price.
+ * - **A downgrade takes effect at the end of the paid period.** The current period keeps its benefits and nothing is refunded.
+ * - **Amounts are decimal strings** in the billing account's currency. There is no currency conversion: a plan without a price or credit in the account's currency cannot be bought with it.
+ * OpenAPI spec version: 1.0.0
+ */
+import * as zod from "zod";
+import { Money } from "./money.zod.js";
+import { NamedIdentity } from "./namedIdentity.zod.js";
+import { ObjectIdentity } from "./objectIdentity.zod.js";
+import { Product } from "./product.zod.js";
+export const UsageCharge = zod.strictObject({
+    subscription_id: zod.uuid(),
+    id: zod.uuid(),
+    project_id: zod.uuid().optional(),
+    project: zod
+        .union([NamedIdentity, zod.null()])
+        .optional()
+        .describe("The project and its current name, for display. Absent when the project no longer exists or its\ndetails cannot be read at the moment; `project_id` still identifies it."),
+    product: Product,
+    resource_id: zod
+        .string()
+        .optional()
+        .describe("Which resource this was charged for. Empty for charges not tied to one."),
+    meter: ObjectIdentity,
+    unit: zod.string().optional(),
+    dimensions: zod
+        .record(zod.string(), zod.string())
+        .optional()
+        .describe("The attributes the rate was chosen by, such as region and machine type."),
+    window_start: zod.iso.datetime({ offset: true }),
+    window_end: zod.iso.datetime({ offset: true }).describe("Exclusive."),
+    gross_quantity: zod
+        .string()
+        .optional()
+        .describe("How much was used, before any included allowance."),
+    deducted_quantity: zod
+        .string()
+        .optional()
+        .describe("How much of that was covered by an allowance."),
+    quantity: zod
+        .string()
+        .describe("What was charged for — the gross quantity less the part covered."),
+    unit_amount: Money.optional(),
+    amount: Money,
+    currency: zod.string(),
+    invoice_id: zod
+        .uuid()
+        .nullish()
+        .describe("Present after the statement is closed and its invoice is issued."),
+    invoice_item_id: zod
+        .uuid()
+        .nullish()
+        .describe("Present after the statement is closed and its invoice is issued."),
+    statement_id: zod.uuid().optional().describe("The statement this charge was collected into."),
+});

package/dist/membership/v1/generated/validators/usageChargeList.zod.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Membership API
+ * Membership plans and the memberships held by billing accounts.
+ *
+ * A membership is a prepaid subscription sold through Billing. For each paid period it issues the plan's benefits to the billing account. A plan can carry several benefits across services: credit for chosen services, coupons on purchases and metered usage, and usage allowances such as model tokens, and access to features of other services. Benefits are shared by every project paid for by the account.
+ *
+ * ## Authentication
+ *
+ * Plans are public. Memberships require an access token; see the `accessTokenAuth` security scheme. Only the owner of a billing account can read or change its membership; anyone else receives 403 `MEMBERSHIP_ACCOUNT_FORBIDDEN`.
+ *
+ * ## Conventions
+ *
+ * - **One membership per billing account.** A pending or active membership must end before another is bought; change plans with upgrade and downgrade instead.
+ * - **Payment goes through Billing.** Purchases and upgrades return a Billing order. With `checkout.mode` `deferred`, pay the order's invoice through Billing. Benefits are issued once Billing reports the order ready; every order has an invoice, including a zero-total one, which is paid automatically.
+ * - **Cancellation and auto-renewal are managed in Billing** on the membership's `subscription_id`. A cancellation takes effect at the end of the paid period without a refund, and the period's benefits remain until then.
+ * - **An upgrade takes effect immediately** for the full difference between the two plans' period prices, whatever remains of the period. The difference in credit is issued in full and the new plan's discount applies from payment. Renewals are charged at the new plan's price.
+ * - **A downgrade takes effect at the end of the paid period.** The current period keeps its benefits and nothing is refunded.
+ * - **Amounts are decimal strings** in the billing account's currency. There is no currency conversion: a plan without a price or credit in the account's currency cannot be bought with it.
+ * OpenAPI spec version: 1.0.0
+ */
+import * as zod from "zod";
+export declare const UsageChargeList: zod.ZodObject<{
+    items: zod.ZodArray<zod.ZodObject<{
+        subscription_id: zod.ZodUUID;
+        id: zod.ZodUUID;
+        project_id: zod.ZodOptional<zod.ZodUUID>;
+        project: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodObject<{
+            id: zod.ZodUUID;
+            name: zod.ZodString;
+        }, zod.z.core.$strict>, zod.ZodNull]>>;
+        product: zod.ZodObject<{
+            id: zod.ZodString;
+            name: zod.ZodString;
+            description: zod.ZodOptional<zod.ZodString>;
+        }, zod.z.core.$strict>;
+        resource_id: zod.ZodOptional<zod.ZodString>;
+        meter: zod.ZodObject<{
+            lookup_key: zod.ZodOptional<zod.ZodString>;
+            id: zod.ZodUUID;
+            name: zod.ZodString;
+        }, zod.z.core.$strict>;
+        unit: zod.ZodOptional<zod.ZodString>;
+        dimensions: zod.ZodOptional<zod.ZodRecord<zod.ZodString, zod.ZodString>>;
+        window_start: zod.z.ZodISODateTime;
+        window_end: zod.z.ZodISODateTime;
+        gross_quantity: zod.ZodOptional<zod.ZodString>;
+        deducted_quantity: zod.ZodOptional<zod.ZodString>;
+        quantity: zod.ZodString;
+        unit_amount: zod.ZodOptional<zod.ZodString>;
+        amount: zod.ZodString;
+        currency: zod.ZodString;
+        invoice_id: zod.ZodOptional<zod.ZodNullable<zod.ZodUUID>>;
+        invoice_item_id: zod.ZodOptional<zod.ZodNullable<zod.ZodUUID>>;
+        statement_id: zod.ZodOptional<zod.ZodUUID>;
+    }, zod.z.core.$strict>>;
+    pagination: zod.ZodObject<{
+        page: zod.ZodInt;
+        page_size: zod.ZodInt;
+        total_count: zod.ZodOptional<zod.ZodInt>;
+    }, zod.z.core.$strict>;
+}, zod.z.core.$strict>;
+export type UsageChargeList = zod.input<typeof UsageChargeList>;
+export type UsageChargeListOutput = zod.output<typeof UsageChargeList>;

package/dist/membership/v1/generated/validators/usageChargeList.zod.js

@@ -0,0 +1,29 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Membership API
+ * Membership plans and the memberships held by billing accounts.
+ *
+ * A membership is a prepaid subscription sold through Billing. For each paid period it issues the plan's benefits to the billing account. A plan can carry several benefits across services: credit for chosen services, coupons on purchases and metered usage, and usage allowances such as model tokens, and access to features of other services. Benefits are shared by every project paid for by the account.
+ *
+ * ## Authentication
+ *
+ * Plans are public. Memberships require an access token; see the `accessTokenAuth` security scheme. Only the owner of a billing account can read or change its membership; anyone else receives 403 `MEMBERSHIP_ACCOUNT_FORBIDDEN`.
+ *
+ * ## Conventions
+ *
+ * - **One membership per billing account.** A pending or active membership must end before another is bought; change plans with upgrade and downgrade instead.
+ * - **Payment goes through Billing.** Purchases and upgrades return a Billing order. With `checkout.mode` `deferred`, pay the order's invoice through Billing. Benefits are issued once Billing reports the order ready; every order has an invoice, including a zero-total one, which is paid automatically.
+ * - **Cancellation and auto-renewal are managed in Billing** on the membership's `subscription_id`. A cancellation takes effect at the end of the paid period without a refund, and the period's benefits remain until then.
+ * - **An upgrade takes effect immediately** for the full difference between the two plans' period prices, whatever remains of the period. The difference in credit is issued in full and the new plan's discount applies from payment. Renewals are charged at the new plan's price.
+ * - **A downgrade takes effect at the end of the paid period.** The current period keeps its benefits and nothing is refunded.
+ * - **Amounts are decimal strings** in the billing account's currency. There is no currency conversion: a plan without a price or credit in the account's currency cannot be bought with it.
+ * OpenAPI spec version: 1.0.0
+ */
+import * as zod from "zod";
+import { OffsetPagination } from "./offsetPagination.zod.js";
+import { UsageCharge } from "./usageCharge.zod.js";
+export const UsageChargeList = zod.strictObject({
+    items: zod.array(UsageCharge),
+    pagination: OffsetPagination,
+});

package/dist/routes.d.ts

@@ -926,14 +926,6 @@ export declare const routes: readonly [{
     readonly operationId: "get-order";
     readonly securityScheme: "AccessToken";
     readonly upstreamUrl: "https://billing.leaflow.cloud";
-}, {
-    readonly service: "billing";
-    readonly contract: "billing";
-    readonly method: "POST";
-    readonly path: "/api/v1/orders/{orderId}/checkout";
-    readonly operationId: "checkout-order";
-    readonly securityScheme: "AccessToken";
-    readonly upstreamUrl: "https://billing.leaflow.cloud";
 }, {
     readonly service: "billing";
     readonly contract: "billing";
@@ -958,6 +950,14 @@ export declare const routes: readonly [{
     readonly operationId: "list-entitlements";
     readonly securityScheme: "AccessToken";
     readonly upstreamUrl: "https://billing.leaflow.cloud";
+}, {
+    readonly service: "billing";
+    readonly contract: "billing";
+    readonly method: "GET";
+    readonly path: "/api/v1/feature-grants";
+    readonly operationId: "list-feature-grants";
+    readonly securityScheme: "AccessToken";
+    readonly upstreamUrl: "https://billing.leaflow.cloud";
 }, {
     readonly service: "billing";
     readonly contract: "billing";
@@ -2422,6 +2422,78 @@ export declare const routes: readonly [{
     readonly operationId: "revoke-ssh-key";
     readonly securityScheme: "ScopedToken";
     readonly upstreamUrl: "https://iam.leaflow.cloud";
+}, {
+    readonly service: "membership";
+    readonly contract: "membership";
+    readonly method: "GET";
+    readonly path: "/api/v1/plans";
+    readonly operationId: "list-plans";
+    readonly securityScheme: null;
+    readonly upstreamUrl: "https://membership.leaflow.cloud";
+}, {
+    readonly service: "membership";
+    readonly contract: "membership";
+    readonly method: "GET";
+    readonly path: "/api/v1/plans/{planId}";
+    readonly operationId: "get-plan";
+    readonly securityScheme: null;
+    readonly upstreamUrl: "https://membership.leaflow.cloud";
+}, {
+    readonly service: "membership";
+    readonly contract: "membership";
+    readonly method: "GET";
+    readonly path: "/api/v1/memberships";
+    readonly operationId: "list-memberships";
+    readonly securityScheme: "AccessToken";
+    readonly upstreamUrl: "https://membership.leaflow.cloud";
+}, {
+    readonly service: "membership";
+    readonly contract: "membership";
+    readonly method: "POST";
+    readonly path: "/api/v1/memberships";
+    readonly operationId: "create-membership";
+    readonly securityScheme: "AccessToken";
+    readonly upstreamUrl: "https://membership.leaflow.cloud";
+}, {
+    readonly service: "membership";
+    readonly contract: "membership";
+    readonly method: "GET";
+    readonly path: "/api/v1/memberships/{membershipId}";
+    readonly operationId: "get-membership";
+    readonly securityScheme: "AccessToken";
+    readonly upstreamUrl: "https://membership.leaflow.cloud";
+}, {
+    readonly service: "membership";
+    readonly contract: "membership";
+    readonly method: "GET";
+    readonly path: "/api/v1/memberships/{membershipId}/periods";
+    readonly operationId: "list-membership-periods";
+    readonly securityScheme: "AccessToken";
+    readonly upstreamUrl: "https://membership.leaflow.cloud";
+}, {
+    readonly service: "membership";
+    readonly contract: "membership";
+    readonly method: "POST";
+    readonly path: "/api/v1/memberships/{membershipId}/upgrade";
+    readonly operationId: "upgrade-membership";
+    readonly securityScheme: "AccessToken";
+    readonly upstreamUrl: "https://membership.leaflow.cloud";
+}, {
+    readonly service: "membership";
+    readonly contract: "membership";
+    readonly method: "POST";
+    readonly path: "/api/v1/memberships/{membershipId}/downgrade";
+    readonly operationId: "schedule-membership-downgrade";
+    readonly securityScheme: "AccessToken";
+    readonly upstreamUrl: "https://membership.leaflow.cloud";
+}, {
+    readonly service: "membership";
+    readonly contract: "membership";
+    readonly method: "DELETE";
+    readonly path: "/api/v1/memberships/{membershipId}/downgrade";
+    readonly operationId: "cancel-membership-downgrade";
+    readonly securityScheme: "AccessToken";
+    readonly upstreamUrl: "https://membership.leaflow.cloud";
 }, {
     readonly service: "monitoring";
     readonly contract: "monitoring";