@spacefast/common 0.0.2

package/dist/contracts/billing.d.ts

@@ -0,0 +1,328 @@
+import { z } from "zod";
+export declare const billingProviderValues: readonly ["stripe", "app_store", "google_play", "grant"];
+export declare const billingProviderSchema: z.ZodEnum<{
+    grant: "grant";
+    stripe: "stripe";
+    app_store: "app_store";
+    google_play: "google_play";
+}>;
+export type BillingProvider = z.infer<typeof billingProviderSchema>;
+export declare const billingIntervalValues: readonly ["monthly", "yearly"];
+export declare const billingIntervalSchema: z.ZodEnum<{
+    monthly: "monthly";
+    yearly: "yearly";
+}>;
+export type BillingIntervalValue = z.infer<typeof billingIntervalSchema>;
+export declare const appStoreEnvironmentValues: readonly ["Sandbox", "Production", "Xcode", "LocalTesting"];
+export declare const googlePlaySubscriptionStateValues: readonly ["SUBSCRIPTION_STATE_UNSPECIFIED", "SUBSCRIPTION_STATE_PENDING", "SUBSCRIPTION_STATE_ACTIVE", "SUBSCRIPTION_STATE_PAUSED", "SUBSCRIPTION_STATE_IN_GRACE_PERIOD", "SUBSCRIPTION_STATE_ON_HOLD", "SUBSCRIPTION_STATE_CANCELED", "SUBSCRIPTION_STATE_EXPIRED", "SUBSCRIPTION_STATE_PENDING_PURCHASE_EXPIRED"];
+export type GooglePlaySubscriptionState = (typeof googlePlaySubscriptionStateValues)[number];
+export declare const googlePlayAcknowledgementStateValues: readonly ["ACKNOWLEDGEMENT_STATE_UNSPECIFIED", "ACKNOWLEDGEMENT_STATE_PENDING", "ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED"];
+export type GooglePlayAcknowledgementState = (typeof googlePlayAcknowledgementStateValues)[number];
+export declare const billingTransactionKindValues: readonly ["purchase", "renewal", "refund", "adjustment"];
+export declare const billingTransactionKindSchema: z.ZodEnum<{
+    purchase: "purchase";
+    renewal: "renewal";
+    refund: "refund";
+    adjustment: "adjustment";
+}>;
+export type BillingTransactionKind = z.infer<typeof billingTransactionKindSchema>;
+/** What the money was for. */
+export declare const billingTransactionScopeValues: readonly ["plan", "seats", "domain", "other"];
+export declare const billingTransactionScopeSchema: z.ZodEnum<{
+    domain: "domain";
+    plan: "plan";
+    seats: "seats";
+    other: "other";
+}>;
+export type BillingTransactionScope = z.infer<typeof billingTransactionScopeSchema>;
+export declare const billingAddonSourceValues: readonly ["grant", "stripe"];
+export declare const billingAddonLimitKeyValues: readonly ["teamMembers", "subTeams", "storageBytes", "externalDomainGroups"];
+export declare const billingAddonLimitKeySchema: z.ZodEnum<{
+    storageBytes: "storageBytes";
+    teamMembers: "teamMembers";
+    subTeams: "subTeams";
+    externalDomainGroups: "externalDomainGroups";
+}>;
+export type BillingAddonLimitKey = z.infer<typeof billingAddonLimitKeySchema>;
+export declare const billingPlanSourceSchema: z.ZodObject<{
+    provider: z.ZodEnum<{
+        grant: "grant";
+        stripe: "stripe";
+        app_store: "app_store";
+        google_play: "google_play";
+    }>;
+    planCode: z.ZodEnum<{
+        free: "free";
+        personal: "personal";
+        work: "work";
+        enterprise: "enterprise";
+        internal: "internal";
+    }>;
+    active: z.ZodBoolean;
+    detail: z.ZodString;
+    expiresAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type BillingPlanSource = z.infer<typeof billingPlanSourceSchema>;
+export declare const billingStoreAccountResponseSchema: z.ZodObject<{
+    token: z.ZodString;
+    appStoreProducts: z.ZodArray<z.ZodString>;
+    googlePlayBasePlans: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type BillingStoreAccountResponse = z.infer<typeof billingStoreAccountResponseSchema>;
+export declare const appStoreVerifyRequestSchema: z.ZodObject<{
+    transactionId: z.ZodString;
+}, z.core.$strip>;
+export declare const googlePlayRecoverRequestSchema: z.ZodObject<{
+    purchaseToken: z.ZodString;
+}, z.core.$strip>;
+export declare const storeSubscriptionResultSchema: z.ZodObject<{
+    provider: z.ZodEnum<{
+        grant: "grant";
+        stripe: "stripe";
+        app_store: "app_store";
+        google_play: "google_play";
+    }>;
+    reference: z.ZodString;
+    productId: z.ZodString;
+    planCode: z.ZodNullable<z.ZodString>;
+    isActive: z.ZodBoolean;
+    expiresAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type StoreSubscriptionResult = z.infer<typeof storeSubscriptionResultSchema>;
+export declare const stripeCheckoutRequestSchema: z.ZodObject<{
+    planCode: z.ZodDefault<z.ZodEnum<{
+        free: "free";
+        personal: "personal";
+        work: "work";
+        enterprise: "enterprise";
+        internal: "internal";
+    }>>;
+    billingInterval: z.ZodDefault<z.ZodEnum<{
+        monthly: "monthly";
+        yearly: "yearly";
+    }>>;
+    successUrl: z.ZodString;
+    cancelUrl: z.ZodString;
+}, z.core.$strip>;
+export type StripeCheckoutRequest = z.infer<typeof stripeCheckoutRequestSchema>;
+export declare const stripePortalRequestSchema: z.ZodObject<{
+    returnUrl: z.ZodString;
+}, z.core.$strip>;
+export type StripePortalRequest = z.infer<typeof stripePortalRequestSchema>;
+export declare const billingLinkResponseSchema: z.ZodObject<{
+    url: z.ZodString;
+}, z.core.$strip>;
+export type BillingLinkResponse = z.infer<typeof billingLinkResponseSchema>;
+export declare const stripeCancelSubscriptionRequestSchema: z.ZodDefault<z.ZodObject<{}, z.core.$strip>>;
+export type StripeCancelSubscriptionRequest = z.infer<typeof stripeCancelSubscriptionRequestSchema>;
+export declare const stripeChangePlanRequestSchema: z.ZodObject<{
+    planCode: z.ZodEnum<{
+        free: "free";
+        personal: "personal";
+        work: "work";
+        enterprise: "enterprise";
+        internal: "internal";
+    }> & z.ZodType<"personal" | "work" | "enterprise" | "internal", "free" | "personal" | "work" | "enterprise" | "internal", z.core.$ZodTypeInternals<"personal" | "work" | "enterprise" | "internal", "free" | "personal" | "work" | "enterprise" | "internal">>;
+    billingInterval: z.ZodDefault<z.ZodEnum<{
+        monthly: "monthly";
+        yearly: "yearly";
+    }>>;
+}, z.core.$strip>;
+export type StripeChangePlanRequest = z.infer<typeof stripeChangePlanRequestSchema>;
+export declare const stripeSubscriptionActionResponseSchema: z.ZodObject<{
+    provider: z.ZodLiteral<"stripe">;
+    stripeSubscriptionId: z.ZodString;
+    status: z.ZodString;
+    cancelAtPeriodEnd: z.ZodNullable<z.ZodBoolean>;
+}, z.core.$strip>;
+export type StripeSubscriptionActionResponse = z.infer<typeof stripeSubscriptionActionResponseSchema>;
+export declare const billingAddressSchema: z.ZodObject<{
+    line1: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    line2: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    city: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    state: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    postalCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    country: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export declare const teamBillingSettingsSchema: z.ZodObject<{
+    id: z.ZodString;
+    teamId: z.ZodString;
+    billingEmail: z.ZodNullable<z.ZodString>;
+    legalName: z.ZodNullable<z.ZodString>;
+    phone: z.ZodNullable<z.ZodString>;
+    address: z.ZodNullable<z.ZodObject<{
+        line1: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        line2: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        city: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        state: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        postalCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        country: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>>;
+    taxIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    preferredLocales: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    poReference: z.ZodNullable<z.ZodString>;
+    invoiceFooter: z.ZodNullable<z.ZodString>;
+    customFields: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    stripeCustomerSyncStatus: z.ZodNullable<z.ZodEnum<{
+        pending: "pending";
+        failed: "failed";
+        synced: "synced";
+    }>>;
+    stripeCustomerSyncedAt: z.ZodNullable<z.ZodString>;
+    stripeCustomerSyncError: z.ZodNullable<z.ZodString>;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export declare const teamBillingSettingsResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    teamId: z.ZodString;
+    billingEmail: z.ZodNullable<z.ZodString>;
+    legalName: z.ZodNullable<z.ZodString>;
+    phone: z.ZodNullable<z.ZodString>;
+    address: z.ZodNullable<z.ZodObject<{
+        line1: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        line2: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        city: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        state: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        postalCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        country: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>>;
+    taxIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    preferredLocales: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    poReference: z.ZodNullable<z.ZodString>;
+    invoiceFooter: z.ZodNullable<z.ZodString>;
+    customFields: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    stripeCustomerSyncStatus: z.ZodNullable<z.ZodEnum<{
+        pending: "pending";
+        failed: "failed";
+        synced: "synced";
+    }>>;
+    stripeCustomerSyncedAt: z.ZodNullable<z.ZodString>;
+    stripeCustomerSyncError: z.ZodNullable<z.ZodString>;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export declare const teamBillingSettingsUpdateSchema: z.ZodObject<{
+    billingEmail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    legalName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    phone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    address: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        line1: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        line2: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        city: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        state: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        postalCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        country: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>>>;
+    taxIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    preferredLocales: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    poReference: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    invoiceFooter: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    customFields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strict>;
+export type TeamBillingSettingsResponse = z.infer<typeof teamBillingSettingsResponseSchema>;
+export type TeamBillingSettingsUpdate = z.infer<typeof teamBillingSettingsUpdateSchema>;
+export declare const billingCustomerRefSchema: z.ZodObject<{
+    id: z.ZodString;
+    provider: z.ZodLiteral<"stripe">;
+    accountKey: z.ZodString;
+    stripeCustomerId: z.ZodNullable<z.ZodString>;
+    diagnostics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const billingSubscriptionSummarySchema: z.ZodObject<{
+    id: z.ZodString;
+    provider: z.ZodLiteral<"stripe">;
+    planCode: z.ZodNullable<z.ZodEnum<{
+        free: "free";
+        personal: "personal";
+        work: "work";
+        enterprise: "enterprise";
+        internal: "internal";
+    }>>;
+    status: z.ZodString;
+    providerStatus: z.ZodNullable<z.ZodString>;
+    currentPeriodEnd: z.ZodNullable<z.ZodString>;
+    cancelAtPeriodEnd: z.ZodNullable<z.ZodBoolean>;
+    diagnostics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const billingResourceChargeSummarySchema: z.ZodObject<{
+    id: z.ZodString;
+    subjectType: z.ZodEnum<{
+        space: "space";
+        site: "site";
+        domain: "domain";
+    }>;
+    kind: z.ZodString;
+    status: z.ZodString;
+    graceUntil: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const TeamBillingResponseSchema: z.ZodObject<{
+    teamId: z.ZodString;
+    planCode: z.ZodEnum<{
+        free: "free";
+        personal: "personal";
+        work: "work";
+        enterprise: "enterprise";
+        internal: "internal";
+    }>;
+    billingCustomerRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        provider: z.ZodLiteral<"stripe">;
+        accountKey: z.ZodString;
+        stripeCustomerId: z.ZodNullable<z.ZodString>;
+        diagnostics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>>;
+    subscriptions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        provider: z.ZodLiteral<"stripe">;
+        planCode: z.ZodNullable<z.ZodEnum<{
+            free: "free";
+            personal: "personal";
+            work: "work";
+            enterprise: "enterprise";
+            internal: "internal";
+        }>>;
+        status: z.ZodString;
+        providerStatus: z.ZodNullable<z.ZodString>;
+        currentPeriodEnd: z.ZodNullable<z.ZodString>;
+        cancelAtPeriodEnd: z.ZodNullable<z.ZodBoolean>;
+        diagnostics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>>;
+    resourceCharges: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        subjectType: z.ZodEnum<{
+            space: "space";
+            site: "site";
+            domain: "domain";
+        }>;
+        kind: z.ZodString;
+        status: z.ZodString;
+        graceUntil: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>>;
+    seatBilling: z.ZodObject<{
+        billableSeats: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
+    stripeCustomerId: z.ZodNullable<z.ZodString>;
+    subscription: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        provider: z.ZodLiteral<"stripe">;
+        planCode: z.ZodNullable<z.ZodEnum<{
+            free: "free";
+            personal: "personal";
+            work: "work";
+            enterprise: "enterprise";
+            internal: "internal";
+        }>>;
+        status: z.ZodString;
+        providerStatus: z.ZodNullable<z.ZodString>;
+        currentPeriodEnd: z.ZodNullable<z.ZodString>;
+        cancelAtPeriodEnd: z.ZodNullable<z.ZodBoolean>;
+        diagnostics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    usage: z.ZodObject<{
+        storageBytes: z.ZodNumber;
+        storageQuotaBytes: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
+        storageOverageBytes: z.ZodNumber;
+        buildsDeploysThisMonth: z.ZodNumber;
+        buildsDeploysMonthly: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type TeamBillingResponse = z.infer<typeof TeamBillingResponseSchema>;

package/dist/contracts/billing.js

@@ -0,0 +1,203 @@
+import { z } from "zod";
+import { planCodeSchema, planLimitValueSchema } from "./features.js";
+// Billing providers a team plan can resolve from. `grant` is a
+// superadmin-assigned subscription: no payment, no transactions, just an
+// operator-issued entitlement row (optionally expiring).
+export const billingProviderValues = ["stripe", "app_store", "google_play", "grant"];
+export const billingProviderSchema = z.enum(billingProviderValues).describe("Billing provider.");
+export const billingIntervalValues = ["monthly", "yearly"];
+export const billingIntervalSchema = z.enum(billingIntervalValues);
+export const appStoreEnvironmentValues = [
+    "Sandbox",
+    "Production",
+    "Xcode",
+    "LocalTesting",
+];
+// Google Play subscriptionsv2 states (subset we persist verbatim).
+export const googlePlaySubscriptionStateValues = [
+    "SUBSCRIPTION_STATE_UNSPECIFIED",
+    "SUBSCRIPTION_STATE_PENDING",
+    "SUBSCRIPTION_STATE_ACTIVE",
+    "SUBSCRIPTION_STATE_PAUSED",
+    "SUBSCRIPTION_STATE_IN_GRACE_PERIOD",
+    "SUBSCRIPTION_STATE_ON_HOLD",
+    "SUBSCRIPTION_STATE_CANCELED",
+    "SUBSCRIPTION_STATE_EXPIRED",
+    "SUBSCRIPTION_STATE_PENDING_PURCHASE_EXPIRED",
+];
+export const googlePlayAcknowledgementStateValues = [
+    "ACKNOWLEDGEMENT_STATE_UNSPECIFIED",
+    "ACKNOWLEDGEMENT_STATE_PENDING",
+    "ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED",
+];
+// Transaction ledger vocabulary. Every REAL payment event lands as one row —
+// operator grants never do (no transactions by definition). Amounts are
+// micros of the payment currency (1_000_000 micros = 1 unit) so Apple
+// milliunits, Google units+nanos, and Stripe cents all normalize losslessly.
+export const billingTransactionKindValues = [
+    "purchase",
+    "renewal",
+    "refund",
+    "adjustment",
+];
+export const billingTransactionKindSchema = z.enum(billingTransactionKindValues);
+/** What the money was for. */
+export const billingTransactionScopeValues = ["plan", "seats", "domain", "other"];
+export const billingTransactionScopeSchema = z.enum(billingTransactionScopeValues);
+// Add-on entitlements (extra seats, extra storage): additive limit bumps that
+// ride the EntitlementGrant seam. `grant` source = operator-assigned, no
+// payment; `stripe` source = paid add-on synced from a Stripe subscription item.
+export const billingAddonSourceValues = ["grant", "stripe"];
+export const billingAddonLimitKeyValues = [
+    "teamMembers",
+    "subTeams",
+    "storageBytes",
+    "externalDomainGroups",
+];
+export const billingAddonLimitKeySchema = z.enum(billingAddonLimitKeyValues);
+// One active-plan source as surfaced to operators and the team billing page:
+// where a plan claim comes from and whether it is currently effective.
+export const billingPlanSourceSchema = z.object({
+    provider: billingProviderSchema,
+    planCode: planCodeSchema,
+    active: z.boolean(),
+    detail: z
+        .string()
+        .describe("Provider-specific reference: subscription/grant id, transaction id, or token."),
+    expiresAt: z.string().datetime().nullable(),
+});
+// Mobile-client store flows: the team's store account token is passed as
+// Apple `appAccountToken` / Google `obfuscatedExternalAccountId` at purchase
+// time so receipts bind back to the team server-side.
+export const billingStoreAccountResponseSchema = z.object({
+    token: z.string().uuid(),
+    appStoreProducts: z.array(z.string()).describe("App Store product ids sold by this deployment."),
+    googlePlayBasePlans: z
+        .array(z.string())
+        .describe("Google Play base plan ids sold by this deployment."),
+});
+export const appStoreVerifyRequestSchema = z.object({
+    transactionId: z.string().trim().min(1),
+});
+export const googlePlayRecoverRequestSchema = z.object({
+    purchaseToken: z.string().trim().min(1),
+});
+export const storeSubscriptionResultSchema = z.object({
+    provider: billingProviderSchema,
+    reference: z.string().describe("Provider-side id: transaction id or purchase token."),
+    productId: z.string(),
+    planCode: z.string().nullable(),
+    isActive: z.boolean(),
+    expiresAt: z.string().datetime().nullable(),
+});
+export const stripeCheckoutRequestSchema = z.object({
+    planCode: planCodeSchema.default("work"),
+    billingInterval: billingIntervalSchema.default("monthly"),
+    successUrl: z.string().url(),
+    cancelUrl: z.string().url(),
+});
+export const stripePortalRequestSchema = z.object({
+    returnUrl: z.string().url(),
+});
+export const billingLinkResponseSchema = z.object({ url: z.string().url() });
+export const stripeCancelSubscriptionRequestSchema = z.object({}).default({});
+export const stripeChangePlanRequestSchema = z.object({
+    planCode: planCodeSchema.refine((value) => value !== "free", {
+        message: "Choose a paid plan.",
+    }),
+    billingInterval: billingIntervalSchema.default("monthly"),
+});
+export const stripeSubscriptionActionResponseSchema = z.object({
+    provider: z.literal("stripe"),
+    stripeSubscriptionId: z.string(),
+    status: z.string(),
+    cancelAtPeriodEnd: z.boolean().nullable(),
+});
+export const billingAddressSchema = z
+    .object({
+    line1: z.string().trim().max(255).nullable().optional(),
+    line2: z.string().trim().max(255).nullable().optional(),
+    city: z.string().trim().max(120).nullable().optional(),
+    state: z.string().trim().max(120).nullable().optional(),
+    postalCode: z.string().trim().max(32).nullable().optional(),
+    country: z.string().trim().length(2).nullable().optional(),
+})
+    .strict();
+export const teamBillingSettingsSchema = z.object({
+    id: z.string(),
+    teamId: z.string(),
+    billingEmail: z.string().email().nullable(),
+    legalName: z.string().nullable(),
+    phone: z.string().nullable(),
+    address: billingAddressSchema.nullable(),
+    taxIds: z.array(z.string()).default([]),
+    preferredLocales: z.array(z.string()).default([]),
+    poReference: z.string().nullable(),
+    invoiceFooter: z.string().nullable(),
+    customFields: z.record(z.string(), z.string()).default({}),
+    stripeCustomerSyncStatus: z.enum(["pending", "synced", "failed"]).nullable(),
+    stripeCustomerSyncedAt: z.string().datetime().nullable(),
+    stripeCustomerSyncError: z.string().nullable(),
+    updatedAt: z.string().datetime(),
+});
+export const teamBillingSettingsResponseSchema = teamBillingSettingsSchema;
+export const teamBillingSettingsUpdateSchema = z
+    .object({
+    billingEmail: z.string().email().nullable().optional(),
+    legalName: z.string().trim().min(1).max(255).nullable().optional(),
+    phone: z.string().trim().max(64).nullable().optional(),
+    address: billingAddressSchema.nullable().optional(),
+    taxIds: z.array(z.string().trim().min(1).max(128)).max(20).optional(),
+    preferredLocales: z.array(z.string().trim().min(2).max(16)).max(10).optional(),
+    poReference: z.string().trim().max(255).nullable().optional(),
+    invoiceFooter: z.string().trim().max(500).nullable().optional(),
+    customFields: z.record(z.string().max(40), z.string().max(140)).optional(),
+})
+    .strict();
+export const billingCustomerRefSchema = z.object({
+    id: z.string(),
+    provider: z.literal("stripe"),
+    accountKey: z.string(),
+    stripeCustomerId: z.string().nullable(),
+    diagnostics: z.record(z.string(), z.unknown()).optional(),
+});
+export const billingSubscriptionSummarySchema = z.object({
+    id: z.string(),
+    provider: z.literal("stripe"),
+    planCode: planCodeSchema.nullable(),
+    status: z.string(),
+    providerStatus: z.string().nullable(),
+    currentPeriodEnd: z.string().datetime().nullable(),
+    cancelAtPeriodEnd: z.boolean().nullable(),
+    diagnostics: z.record(z.string(), z.unknown()).optional(),
+});
+export const billingResourceChargeSummarySchema = z.object({
+    id: z.string(),
+    subjectType: z.enum(["site", "space", "domain"]),
+    kind: z.string(),
+    status: z.string(),
+    graceUntil: z.string().datetime().nullable(),
+});
+export const TeamBillingResponseSchema = z.object({
+    teamId: z.string(),
+    planCode: planCodeSchema,
+    billingCustomerRefs: z.array(billingCustomerRefSchema).default([]),
+    subscriptions: z.array(billingSubscriptionSummarySchema).default([]),
+    resourceCharges: z.array(billingResourceChargeSummarySchema).default([]),
+    seatBilling: z.object({ billableSeats: z.number().int().nonnegative().nullable() }),
+    stripeCustomerId: z.string().nullable().describe("Deprecated compatibility field."),
+    subscription: billingSubscriptionSummarySchema
+        .nullable()
+        .describe("Deprecated compatibility field."),
+    usage: z.object({
+        storageBytes: z.number().int().nonnegative(),
+        storageQuotaBytes: planLimitValueSchema,
+        storageOverageBytes: z.number().int().nonnegative(),
+        buildsDeploysThisMonth: z
+            .number()
+            .int()
+            .nonnegative()
+            .describe("Publishes and builds pooled into one monthly meter."),
+        buildsDeploysMonthly: planLimitValueSchema.describe("Pooled monthly plan limit for publishes and builds."),
+    }),
+});