@kernhq/module-billing 0.2.0

package/dist/contract.d.ts

@@ -0,0 +1,965 @@
+import { z } from 'zod';
+export declare const MODULE_ID = "billing";
+/**
+ * The limits a plan may set.
+ *
+ * These keys mirror `Entitlement` in `@kernhq/kernel` exactly, and that is the point: the kernel
+ * declares what can be limited, this module decides the values, and every key has one place in core
+ * that enforces it. A plan can therefore be edited freely by an instance admin without ever being
+ * able to promise something nothing checks.
+ *
+ * `null` means unlimited, everywhere.
+ */
+export declare const PlanLimits: z.ZodObject<{
+    seats: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    storageBytes: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    modules: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    sso: z.ZodDefault<z.ZodBoolean>;
+    auditRetentionDays: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    apiRateLimit: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
+export type PlanLimits = z.infer<typeof PlanLimits>;
+/**
+ * A patch over `PlanLimits`, for comping one limit without touching the rest.
+ *
+ * Written out rather than derived with `.partial()`, because `.partial()` keeps the field defaults:
+ * parsing `{ seats: 50 }` through it returns every other key at its default too, so spreading the
+ * result silently resets limits the admin never mentioned. Absent here means absent.
+ */
+export declare const PlanLimitsPatch: z.ZodObject<{
+    seats: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    storageBytes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    modules: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    sso: z.ZodOptional<z.ZodBoolean>;
+    auditRetentionDays: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    apiRateLimit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
+export type PlanLimitsPatch = z.infer<typeof PlanLimitsPatch>;
+export declare const BillingInterval: z.ZodEnum<{
+    month: "month";
+    year: "year";
+}>;
+export type BillingInterval = z.infer<typeof BillingInterval>;
+export declare const Plan: z.ZodObject<{
+    id: z.ZodUUID;
+    slug: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodDefault<z.ZodString>;
+    priceMinor: z.ZodNumber;
+    currency: z.ZodDefault<z.ZodString>;
+    interval: z.ZodDefault<z.ZodEnum<{
+        month: "month";
+        year: "year";
+    }>>;
+    perSeat: z.ZodDefault<z.ZodBoolean>;
+    trialDays: z.ZodDefault<z.ZodNumber>;
+    limits: z.ZodObject<{
+        seats: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        storageBytes: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        modules: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        sso: z.ZodDefault<z.ZodBoolean>;
+        auditRetentionDays: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        apiRateLimit: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>;
+    stripePriceId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    highlights: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    published: z.ZodDefault<z.ZodBoolean>;
+    order: z.ZodDefault<z.ZodNumber>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type Plan = z.infer<typeof Plan>;
+/**
+ * What a stranger may see. Served unauthenticated so the marketing site can render prices that come
+ * from the same row the instance actually charges against — no internal ids, no Stripe ids, and
+ * published plans only.
+ */
+export declare const PublicPlan: z.ZodObject<{
+    slug: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodDefault<z.ZodString>;
+    priceMinor: z.ZodNumber;
+    currency: z.ZodDefault<z.ZodString>;
+    interval: z.ZodDefault<z.ZodEnum<{
+        month: "month";
+        year: "year";
+    }>>;
+    perSeat: z.ZodDefault<z.ZodBoolean>;
+    trialDays: z.ZodDefault<z.ZodNumber>;
+    highlights: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    order: z.ZodDefault<z.ZodNumber>;
+    limits: z.ZodObject<{
+        seats: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        storageBytes: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        modules: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        sso: z.ZodDefault<z.ZodBoolean>;
+        auditRetentionDays: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        apiRateLimit: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type PublicPlan = z.infer<typeof PublicPlan>;
+export declare const UpsertPlan: z.ZodObject<{
+    limits: z.ZodObject<{
+        seats: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        storageBytes: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        modules: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        sso: z.ZodDefault<z.ZodBoolean>;
+        auditRetentionDays: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        apiRateLimit: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>;
+    slug: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodDefault<z.ZodString>;
+    priceMinor: z.ZodNumber;
+    currency: z.ZodDefault<z.ZodString>;
+    interval: z.ZodDefault<z.ZodEnum<{
+        month: "month";
+        year: "year";
+    }>>;
+    perSeat: z.ZodDefault<z.ZodBoolean>;
+    trialDays: z.ZodDefault<z.ZodNumber>;
+    stripePriceId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    highlights: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    published: z.ZodDefault<z.ZodBoolean>;
+    order: z.ZodDefault<z.ZodNumber>;
+    id: z.ZodOptional<z.ZodUUID>;
+}, z.core.$strip>;
+export type UpsertPlan = z.infer<typeof UpsertPlan>;
+/**
+ * `trialing` and `active` are the two states that entitle a workspace to its plan.
+ * `past_due` still does — there is a grace period — and `suspended` does not.
+ * `canceled` keeps the row so the history and the Stripe ids survive a resubscribe.
+ */
+export declare const SubscriptionStatus: z.ZodEnum<{
+    trialing: "trialing";
+    active: "active";
+    past_due: "past_due";
+    canceled: "canceled";
+    suspended: "suspended";
+}>;
+export type SubscriptionStatus = z.infer<typeof SubscriptionStatus>;
+export declare const Subscription: z.ZodObject<{
+    workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+    planId: z.ZodNullable<z.ZodUUID>;
+    planName: z.ZodNullable<z.ZodString>;
+    planSlug: z.ZodNullable<z.ZodString>;
+    status: z.ZodEnum<{
+        trialing: "trialing";
+        active: "active";
+        past_due: "past_due";
+        canceled: "canceled";
+        suspended: "suspended";
+    }>;
+    seatsPurchased: z.ZodNumber;
+    trialEndsAt: z.ZodNullable<z.ZodString>;
+    currentPeriodEnd: z.ZodNullable<z.ZodString>;
+    cancelAtPeriodEnd: z.ZodBoolean;
+    stripeCustomerId: z.ZodNullable<z.ZodString>;
+    stripeSubscriptionId: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type Subscription = z.infer<typeof Subscription>;
+export declare const Usage: z.ZodObject<{
+    seats: z.ZodNumber;
+    storageBytes: z.ZodNumber;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type Usage = z.infer<typeof Usage>;
+/** Everything the workspace's own billing screen needs, in one round trip. */
+export declare const WorkspaceBilling: z.ZodObject<{
+    subscription: z.ZodNullable<z.ZodObject<{
+        workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+        planId: z.ZodNullable<z.ZodUUID>;
+        planName: z.ZodNullable<z.ZodString>;
+        planSlug: z.ZodNullable<z.ZodString>;
+        status: z.ZodEnum<{
+            trialing: "trialing";
+            active: "active";
+            past_due: "past_due";
+            canceled: "canceled";
+            suspended: "suspended";
+        }>;
+        seatsPurchased: z.ZodNumber;
+        trialEndsAt: z.ZodNullable<z.ZodString>;
+        currentPeriodEnd: z.ZodNullable<z.ZodString>;
+        cancelAtPeriodEnd: z.ZodBoolean;
+        stripeCustomerId: z.ZodNullable<z.ZodString>;
+        stripeSubscriptionId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    usage: z.ZodObject<{
+        seats: z.ZodNumber;
+        storageBytes: z.ZodNumber;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>;
+    limits: z.ZodObject<{
+        seats: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        storageBytes: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        modules: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        sso: z.ZodDefault<z.ZodBoolean>;
+        auditRetentionDays: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        apiRateLimit: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>;
+    active: z.ZodBoolean;
+    paymentsEnabled: z.ZodBoolean;
+}, z.core.$strip>;
+export type WorkspaceBilling = z.infer<typeof WorkspaceBilling>;
+export declare const Invoice: z.ZodObject<{
+    id: z.ZodUUID;
+    workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+    number: z.ZodNullable<z.ZodString>;
+    status: z.ZodString;
+    totalMinor: z.ZodNumber;
+    currency: z.ZodString;
+    periodStart: z.ZodNullable<z.ZodString>;
+    periodEnd: z.ZodNullable<z.ZodString>;
+    hostedUrl: z.ZodNullable<z.ZodString>;
+    pdfUrl: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+export type Invoice = z.infer<typeof Invoice>;
+/** One row of the instance console's list of every workspace on the instance. */
+export declare const AdminWorkspaceRow: z.ZodObject<{
+    workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+    workspaceName: z.ZodString;
+    workspaceSlug: z.ZodString;
+    planName: z.ZodNullable<z.ZodString>;
+    planSlug: z.ZodNullable<z.ZodString>;
+    status: z.ZodNullable<z.ZodEnum<{
+        trialing: "trialing";
+        active: "active";
+        past_due: "past_due";
+        canceled: "canceled";
+        suspended: "suspended";
+    }>>;
+    seatsUsed: z.ZodNumber;
+    seatsPurchased: z.ZodNumber;
+    storageBytes: z.ZodNumber;
+    trialEndsAt: z.ZodNullable<z.ZodString>;
+    currentPeriodEnd: z.ZodNullable<z.ZodString>;
+    monthlyMinor: z.ZodNumber;
+    currency: z.ZodString;
+    overridden: z.ZodBoolean;
+    stripeCustomerId: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type AdminWorkspaceRow = z.infer<typeof AdminWorkspaceRow>;
+export declare const billingContract: {
+    plans: {
+        list: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+            includeUnpublished: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+            id: z.ZodUUID;
+            slug: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodDefault<z.ZodString>;
+            priceMinor: z.ZodNumber;
+            currency: z.ZodDefault<z.ZodString>;
+            interval: z.ZodDefault<z.ZodEnum<{
+                month: "month";
+                year: "year";
+            }>>;
+            perSeat: z.ZodDefault<z.ZodBoolean>;
+            trialDays: z.ZodDefault<z.ZodNumber>;
+            limits: z.ZodObject<{
+                seats: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+                storageBytes: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+                modules: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+                sso: z.ZodDefault<z.ZodBoolean>;
+                auditRetentionDays: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+                apiRateLimit: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+            }, z.core.$strip>;
+            stripePriceId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            highlights: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            published: z.ZodDefault<z.ZodBoolean>;
+            order: z.ZodDefault<z.ZodNumber>;
+            createdAt: z.ZodString;
+            updatedAt: z.ZodString;
+        }, z.core.$strip>>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+            BAD_REQUEST: {
+                data: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            };
+            UNAUTHORIZED: {};
+            FORBIDDEN: {
+                data: z.ZodOptional<z.ZodObject<{
+                    permission: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            NOT_FOUND: {};
+            CONFLICT: {
+                data: z.ZodOptional<z.ZodObject<{
+                    reason: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            RATE_LIMITED: {};
+            MODULE_DISABLED: {
+                data: z.ZodObject<{
+                    module: z.ZodString;
+                }, z.core.$strip>;
+            };
+        }>, Record<never, never>>;
+        /**
+         * Unauthenticated on purpose: this is what kernaio.com and any other instance's marketing page
+         * reads, so that a price is edited in one place and true in both.
+         */
+        public: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{}, z.core.$strip>, z.ZodArray<z.ZodObject<{
+            slug: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodDefault<z.ZodString>;
+            priceMinor: z.ZodNumber;
+            currency: z.ZodDefault<z.ZodString>;
+            interval: z.ZodDefault<z.ZodEnum<{
+                month: "month";
+                year: "year";
+            }>>;
+            perSeat: z.ZodDefault<z.ZodBoolean>;
+            trialDays: z.ZodDefault<z.ZodNumber>;
+            highlights: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            order: z.ZodDefault<z.ZodNumber>;
+            limits: z.ZodObject<{
+                seats: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+                storageBytes: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+                modules: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+                sso: z.ZodDefault<z.ZodBoolean>;
+                auditRetentionDays: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+                apiRateLimit: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+            }, z.core.$strip>;
+        }, z.core.$strip>>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+            BAD_REQUEST: {
+                data: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            };
+            UNAUTHORIZED: {};
+            FORBIDDEN: {
+                data: z.ZodOptional<z.ZodObject<{
+                    permission: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            NOT_FOUND: {};
+            CONFLICT: {
+                data: z.ZodOptional<z.ZodObject<{
+                    reason: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            RATE_LIMITED: {};
+            MODULE_DISABLED: {
+                data: z.ZodObject<{
+                    module: z.ZodString;
+                }, z.core.$strip>;
+            };
+        }>, Record<never, never>>;
+        upsert: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+            limits: z.ZodObject<{
+                seats: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+                storageBytes: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+                modules: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+                sso: z.ZodDefault<z.ZodBoolean>;
+                auditRetentionDays: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+                apiRateLimit: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+            }, z.core.$strip>;
+            slug: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodDefault<z.ZodString>;
+            priceMinor: z.ZodNumber;
+            currency: z.ZodDefault<z.ZodString>;
+            interval: z.ZodDefault<z.ZodEnum<{
+                month: "month";
+                year: "year";
+            }>>;
+            perSeat: z.ZodDefault<z.ZodBoolean>;
+            trialDays: z.ZodDefault<z.ZodNumber>;
+            stripePriceId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            highlights: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            published: z.ZodDefault<z.ZodBoolean>;
+            order: z.ZodDefault<z.ZodNumber>;
+            id: z.ZodOptional<z.ZodUUID>;
+        }, z.core.$strip>, z.ZodObject<{
+            id: z.ZodUUID;
+            slug: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodDefault<z.ZodString>;
+            priceMinor: z.ZodNumber;
+            currency: z.ZodDefault<z.ZodString>;
+            interval: z.ZodDefault<z.ZodEnum<{
+                month: "month";
+                year: "year";
+            }>>;
+            perSeat: z.ZodDefault<z.ZodBoolean>;
+            trialDays: z.ZodDefault<z.ZodNumber>;
+            limits: z.ZodObject<{
+                seats: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+                storageBytes: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+                modules: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+                sso: z.ZodDefault<z.ZodBoolean>;
+                auditRetentionDays: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+                apiRateLimit: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+            }, z.core.$strip>;
+            stripePriceId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            highlights: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            published: z.ZodDefault<z.ZodBoolean>;
+            order: z.ZodDefault<z.ZodNumber>;
+            createdAt: z.ZodString;
+            updatedAt: z.ZodString;
+        }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+            BAD_REQUEST: {
+                data: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            };
+            UNAUTHORIZED: {};
+            FORBIDDEN: {
+                data: z.ZodOptional<z.ZodObject<{
+                    permission: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            NOT_FOUND: {};
+            CONFLICT: {
+                data: z.ZodOptional<z.ZodObject<{
+                    reason: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            RATE_LIMITED: {};
+            MODULE_DISABLED: {
+                data: z.ZodObject<{
+                    module: z.ZodString;
+                }, z.core.$strip>;
+            };
+        }>, Record<never, never>>;
+        setPublished: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+            id: z.ZodUUID;
+            published: z.ZodBoolean;
+        }, z.core.$strip>, z.ZodObject<{
+            id: z.ZodUUID;
+            slug: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodDefault<z.ZodString>;
+            priceMinor: z.ZodNumber;
+            currency: z.ZodDefault<z.ZodString>;
+            interval: z.ZodDefault<z.ZodEnum<{
+                month: "month";
+                year: "year";
+            }>>;
+            perSeat: z.ZodDefault<z.ZodBoolean>;
+            trialDays: z.ZodDefault<z.ZodNumber>;
+            limits: z.ZodObject<{
+                seats: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+                storageBytes: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+                modules: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+                sso: z.ZodDefault<z.ZodBoolean>;
+                auditRetentionDays: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+                apiRateLimit: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+            }, z.core.$strip>;
+            stripePriceId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            highlights: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            published: z.ZodDefault<z.ZodBoolean>;
+            order: z.ZodDefault<z.ZodNumber>;
+            createdAt: z.ZodString;
+            updatedAt: z.ZodString;
+        }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+            BAD_REQUEST: {
+                data: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            };
+            UNAUTHORIZED: {};
+            FORBIDDEN: {
+                data: z.ZodOptional<z.ZodObject<{
+                    permission: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            NOT_FOUND: {};
+            CONFLICT: {
+                data: z.ZodOptional<z.ZodObject<{
+                    reason: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            RATE_LIMITED: {};
+            MODULE_DISABLED: {
+                data: z.ZodObject<{
+                    module: z.ZodString;
+                }, z.core.$strip>;
+            };
+        }>, Record<never, never>>;
+        archive: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+            id: z.ZodUUID;
+        }, z.core.$strip>, z.ZodObject<{
+            ok: z.ZodLiteral<true>;
+        }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+            BAD_REQUEST: {
+                data: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            };
+            UNAUTHORIZED: {};
+            FORBIDDEN: {
+                data: z.ZodOptional<z.ZodObject<{
+                    permission: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            NOT_FOUND: {};
+            CONFLICT: {
+                data: z.ZodOptional<z.ZodObject<{
+                    reason: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            RATE_LIMITED: {};
+            MODULE_DISABLED: {
+                data: z.ZodObject<{
+                    module: z.ZodString;
+                }, z.core.$strip>;
+            };
+        }>, Record<never, never>>;
+    };
+    subscription: {
+        get: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+            workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+        }, z.core.$strip>, z.ZodObject<{
+            subscription: z.ZodNullable<z.ZodObject<{
+                workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+                planId: z.ZodNullable<z.ZodUUID>;
+                planName: z.ZodNullable<z.ZodString>;
+                planSlug: z.ZodNullable<z.ZodString>;
+                status: z.ZodEnum<{
+                    trialing: "trialing";
+                    active: "active";
+                    past_due: "past_due";
+                    canceled: "canceled";
+                    suspended: "suspended";
+                }>;
+                seatsPurchased: z.ZodNumber;
+                trialEndsAt: z.ZodNullable<z.ZodString>;
+                currentPeriodEnd: z.ZodNullable<z.ZodString>;
+                cancelAtPeriodEnd: z.ZodBoolean;
+                stripeCustomerId: z.ZodNullable<z.ZodString>;
+                stripeSubscriptionId: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>>;
+            usage: z.ZodObject<{
+                seats: z.ZodNumber;
+                storageBytes: z.ZodNumber;
+                updatedAt: z.ZodString;
+            }, z.core.$strip>;
+            limits: z.ZodObject<{
+                seats: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+                storageBytes: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+                modules: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+                sso: z.ZodDefault<z.ZodBoolean>;
+                auditRetentionDays: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+                apiRateLimit: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+            }, z.core.$strip>;
+            active: z.ZodBoolean;
+            paymentsEnabled: z.ZodBoolean;
+        }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+            BAD_REQUEST: {
+                data: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            };
+            UNAUTHORIZED: {};
+            FORBIDDEN: {
+                data: z.ZodOptional<z.ZodObject<{
+                    permission: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            NOT_FOUND: {};
+            CONFLICT: {
+                data: z.ZodOptional<z.ZodObject<{
+                    reason: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            RATE_LIMITED: {};
+            MODULE_DISABLED: {
+                data: z.ZodObject<{
+                    module: z.ZodString;
+                }, z.core.$strip>;
+            };
+        }>, Record<never, never>>;
+        invoices: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+            workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+            cursor: z.ZodOptional<z.ZodString>;
+            limit: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            items: z.ZodArray<z.ZodObject<{
+                id: z.ZodUUID;
+                workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+                number: z.ZodNullable<z.ZodString>;
+                status: z.ZodString;
+                totalMinor: z.ZodNumber;
+                currency: z.ZodString;
+                periodStart: z.ZodNullable<z.ZodString>;
+                periodEnd: z.ZodNullable<z.ZodString>;
+                hostedUrl: z.ZodNullable<z.ZodString>;
+                pdfUrl: z.ZodNullable<z.ZodString>;
+                createdAt: z.ZodString;
+            }, z.core.$strip>>;
+            nextCursor: z.ZodNullable<z.ZodString>;
+            total: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+            BAD_REQUEST: {
+                data: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            };
+            UNAUTHORIZED: {};
+            FORBIDDEN: {
+                data: z.ZodOptional<z.ZodObject<{
+                    permission: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            NOT_FOUND: {};
+            CONFLICT: {
+                data: z.ZodOptional<z.ZodObject<{
+                    reason: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            RATE_LIMITED: {};
+            MODULE_DISABLED: {
+                data: z.ZodObject<{
+                    module: z.ZodString;
+                }, z.core.$strip>;
+            };
+        }>, Record<never, never>>;
+        /** Stripe Checkout for a new subscription or a plan change; returns a URL to send the user to. */
+        checkout: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+            workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+            planSlug: z.ZodString;
+            seats: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            url: z.ZodString;
+        }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+            BAD_REQUEST: {
+                data: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            };
+            UNAUTHORIZED: {};
+            FORBIDDEN: {
+                data: z.ZodOptional<z.ZodObject<{
+                    permission: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            NOT_FOUND: {};
+            CONFLICT: {
+                data: z.ZodOptional<z.ZodObject<{
+                    reason: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            RATE_LIMITED: {};
+            MODULE_DISABLED: {
+                data: z.ZodObject<{
+                    module: z.ZodString;
+                }, z.core.$strip>;
+            };
+        }>, Record<never, never>>;
+        /** Stripe's own billing portal: payment method, cancellation, invoice download. */
+        portal: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+            workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+            returnPath: z.ZodDefault<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            url: z.ZodString;
+        }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+            BAD_REQUEST: {
+                data: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            };
+            UNAUTHORIZED: {};
+            FORBIDDEN: {
+                data: z.ZodOptional<z.ZodObject<{
+                    permission: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            NOT_FOUND: {};
+            CONFLICT: {
+                data: z.ZodOptional<z.ZodObject<{
+                    reason: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            RATE_LIMITED: {};
+            MODULE_DISABLED: {
+                data: z.ZodObject<{
+                    module: z.ZodString;
+                }, z.core.$strip>;
+            };
+        }>, Record<never, never>>;
+    };
+    admin: {
+        workspaces: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+            q: z.ZodOptional<z.ZodString>;
+            status: z.ZodOptional<z.ZodEnum<{
+                trialing: "trialing";
+                active: "active";
+                past_due: "past_due";
+                canceled: "canceled";
+                suspended: "suspended";
+            }>>;
+            cursor: z.ZodOptional<z.ZodString>;
+            limit: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            items: z.ZodArray<z.ZodObject<{
+                workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+                workspaceName: z.ZodString;
+                workspaceSlug: z.ZodString;
+                planName: z.ZodNullable<z.ZodString>;
+                planSlug: z.ZodNullable<z.ZodString>;
+                status: z.ZodNullable<z.ZodEnum<{
+                    trialing: "trialing";
+                    active: "active";
+                    past_due: "past_due";
+                    canceled: "canceled";
+                    suspended: "suspended";
+                }>>;
+                seatsUsed: z.ZodNumber;
+                seatsPurchased: z.ZodNumber;
+                storageBytes: z.ZodNumber;
+                trialEndsAt: z.ZodNullable<z.ZodString>;
+                currentPeriodEnd: z.ZodNullable<z.ZodString>;
+                monthlyMinor: z.ZodNumber;
+                currency: z.ZodString;
+                overridden: z.ZodBoolean;
+                stripeCustomerId: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>>;
+            nextCursor: z.ZodNullable<z.ZodString>;
+            total: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+            BAD_REQUEST: {
+                data: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            };
+            UNAUTHORIZED: {};
+            FORBIDDEN: {
+                data: z.ZodOptional<z.ZodObject<{
+                    permission: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            NOT_FOUND: {};
+            CONFLICT: {
+                data: z.ZodOptional<z.ZodObject<{
+                    reason: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            RATE_LIMITED: {};
+            MODULE_DISABLED: {
+                data: z.ZodObject<{
+                    module: z.ZodString;
+                }, z.core.$strip>;
+            };
+        }>, Record<never, never>>;
+        setPlan: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+            workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+            planId: z.ZodNullable<z.ZodUUID>;
+            seatsPurchased: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+            planId: z.ZodNullable<z.ZodUUID>;
+            planName: z.ZodNullable<z.ZodString>;
+            planSlug: z.ZodNullable<z.ZodString>;
+            status: z.ZodEnum<{
+                trialing: "trialing";
+                active: "active";
+                past_due: "past_due";
+                canceled: "canceled";
+                suspended: "suspended";
+            }>;
+            seatsPurchased: z.ZodNumber;
+            trialEndsAt: z.ZodNullable<z.ZodString>;
+            currentPeriodEnd: z.ZodNullable<z.ZodString>;
+            cancelAtPeriodEnd: z.ZodBoolean;
+            stripeCustomerId: z.ZodNullable<z.ZodString>;
+            stripeSubscriptionId: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+            BAD_REQUEST: {
+                data: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            };
+            UNAUTHORIZED: {};
+            FORBIDDEN: {
+                data: z.ZodOptional<z.ZodObject<{
+                    permission: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            NOT_FOUND: {};
+            CONFLICT: {
+                data: z.ZodOptional<z.ZodObject<{
+                    reason: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            RATE_LIMITED: {};
+            MODULE_DISABLED: {
+                data: z.ZodObject<{
+                    module: z.ZodString;
+                }, z.core.$strip>;
+            };
+        }>, Record<never, never>>;
+        /**
+         * Comp an account without inventing a plan for it. `null` clears the override and the plan's own
+         * limit applies again.
+         */
+        override: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+            workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+            limits: z.ZodNullable<z.ZodObject<{
+                seats: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                storageBytes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                modules: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+                sso: z.ZodOptional<z.ZodBoolean>;
+                auditRetentionDays: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                apiRateLimit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+            workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+            planId: z.ZodNullable<z.ZodUUID>;
+            planName: z.ZodNullable<z.ZodString>;
+            planSlug: z.ZodNullable<z.ZodString>;
+            status: z.ZodEnum<{
+                trialing: "trialing";
+                active: "active";
+                past_due: "past_due";
+                canceled: "canceled";
+                suspended: "suspended";
+            }>;
+            seatsPurchased: z.ZodNumber;
+            trialEndsAt: z.ZodNullable<z.ZodString>;
+            currentPeriodEnd: z.ZodNullable<z.ZodString>;
+            cancelAtPeriodEnd: z.ZodBoolean;
+            stripeCustomerId: z.ZodNullable<z.ZodString>;
+            stripeSubscriptionId: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+            BAD_REQUEST: {
+                data: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            };
+            UNAUTHORIZED: {};
+            FORBIDDEN: {
+                data: z.ZodOptional<z.ZodObject<{
+                    permission: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            NOT_FOUND: {};
+            CONFLICT: {
+                data: z.ZodOptional<z.ZodObject<{
+                    reason: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            RATE_LIMITED: {};
+            MODULE_DISABLED: {
+                data: z.ZodObject<{
+                    module: z.ZodString;
+                }, z.core.$strip>;
+            };
+        }>, Record<never, never>>;
+        extendTrial: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+            workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+            days: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+            planId: z.ZodNullable<z.ZodUUID>;
+            planName: z.ZodNullable<z.ZodString>;
+            planSlug: z.ZodNullable<z.ZodString>;
+            status: z.ZodEnum<{
+                trialing: "trialing";
+                active: "active";
+                past_due: "past_due";
+                canceled: "canceled";
+                suspended: "suspended";
+            }>;
+            seatsPurchased: z.ZodNumber;
+            trialEndsAt: z.ZodNullable<z.ZodString>;
+            currentPeriodEnd: z.ZodNullable<z.ZodString>;
+            cancelAtPeriodEnd: z.ZodBoolean;
+            stripeCustomerId: z.ZodNullable<z.ZodString>;
+            stripeSubscriptionId: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+            BAD_REQUEST: {
+                data: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            };
+            UNAUTHORIZED: {};
+            FORBIDDEN: {
+                data: z.ZodOptional<z.ZodObject<{
+                    permission: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            NOT_FOUND: {};
+            CONFLICT: {
+                data: z.ZodOptional<z.ZodObject<{
+                    reason: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            RATE_LIMITED: {};
+            MODULE_DISABLED: {
+                data: z.ZodObject<{
+                    module: z.ZodString;
+                }, z.core.$strip>;
+            };
+        }>, Record<never, never>>;
+        setStatus: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+            workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+            status: z.ZodEnum<{
+                active: "active";
+                suspended: "suspended";
+            }>;
+        }, z.core.$strip>, z.ZodObject<{
+            workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+            planId: z.ZodNullable<z.ZodUUID>;
+            planName: z.ZodNullable<z.ZodString>;
+            planSlug: z.ZodNullable<z.ZodString>;
+            status: z.ZodEnum<{
+                trialing: "trialing";
+                active: "active";
+                past_due: "past_due";
+                canceled: "canceled";
+                suspended: "suspended";
+            }>;
+            seatsPurchased: z.ZodNumber;
+            trialEndsAt: z.ZodNullable<z.ZodString>;
+            currentPeriodEnd: z.ZodNullable<z.ZodString>;
+            cancelAtPeriodEnd: z.ZodBoolean;
+            stripeCustomerId: z.ZodNullable<z.ZodString>;
+            stripeSubscriptionId: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+            BAD_REQUEST: {
+                data: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            };
+            UNAUTHORIZED: {};
+            FORBIDDEN: {
+                data: z.ZodOptional<z.ZodObject<{
+                    permission: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            NOT_FOUND: {};
+            CONFLICT: {
+                data: z.ZodOptional<z.ZodObject<{
+                    reason: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            };
+            RATE_LIMITED: {};
+            MODULE_DISABLED: {
+                data: z.ZodObject<{
+                    module: z.ZodString;
+                }, z.core.$strip>;
+            };
+        }>, Record<never, never>>;
+    };
+};
+export type BillingContract = typeof billingContract;
+export declare const billingEvents: {
+    /**
+     * Emitted whenever anything changes what a workspace is allowed to do. The kernel listens on
+     * `billing.subscription.*` and drops its entitlement cache, so a customer who has just paid does
+     * not wait out a TTL for the seat they bought.
+     */
+    subscriptionChanged: import("@kernhq/contracts").EventDef<"billing.subscription.changed", z.ZodObject<{
+        workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+        status: z.ZodEnum<{
+            trialing: "trialing";
+            active: "active";
+            past_due: "past_due";
+            canceled: "canceled";
+            suspended: "suspended";
+        }>;
+        planSlug: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    subscriptionSuspended: import("@kernhq/contracts").EventDef<"billing.subscription.suspended", z.ZodObject<{
+        workspaceId: z.core.$ZodBranded<z.ZodUUID, "WorkspaceId", "out">;
+        reason: z.ZodString;
+    }, z.core.$strip>>;
+    /** A plan was published or unpublished — what the marketing site shows has changed. */
+    catalogueChanged: import("@kernhq/contracts").EventDef<"billing.catalogue.changed", z.ZodObject<{
+        planSlug: z.ZodString;
+    }, z.core.$strip>>;
+};
+export declare const BILLING_PERMISSIONS: {
+    readonly view: "billing.subscription.view";
+    readonly manage: "billing.subscription.manage";
+};
+export declare const billingPermissions: readonly [{
+    readonly key: "billing.subscription.view";
+    readonly label: "View the plan and what it costs";
+    readonly scope: "workspace";
+    readonly defaultRoles: ["owner", "admin"];
+    readonly dangerous: false;
+}, {
+    readonly key: "billing.subscription.manage";
+    readonly label: "Change the plan and the payment method";
+    readonly scope: "workspace";
+    readonly defaultRoles: ["owner"];
+    readonly dangerous: true;
+}];
+//# sourceMappingURL=contract.d.ts.map