@workwae/sdk 0.0.0-stage → 0.1.0-alpha.1

package/contract/threads/routes.d.ts

@@ -0,0 +1,336 @@
+import * as z from "zod";
+export declare const threads: {
+    list: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        accountId: z.ZodUUID;
+        mailboxId: z.ZodOptional<z.ZodUUID>;
+        limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+        cursor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        items: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            subject: z.ZodNullable<z.ZodString>;
+            snippet: z.ZodNullable<z.ZodString>;
+            participants: z.ZodArray<z.ZodObject<{
+                name: z.ZodNullable<z.ZodString>;
+                address: z.ZodString;
+            }, z.core.$strip>>;
+            messageCount: z.ZodNumber;
+            unreadCount: z.ZodNumber;
+            isFlagged: z.ZodBoolean;
+            hasAttachments: z.ZodBoolean;
+            hasDrafts: z.ZodBoolean;
+            mailboxIds: z.ZodArray<z.ZodUUID>;
+            latestMessageId: z.ZodUUID;
+            lastMessageAt: z.ZodNullable<z.ZodPreprocess<z.ZodDate, Date>>;
+        }, z.core.$strip>>;
+        nextCursor: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<import("@orpc/contract").MergedErrorMap<Record<never, never>, import("../errors.js").DeclaredErrors<{
+        readonly invalid_input: "The request does not match the operation's input schema (a malformed body included); data.issues names each problem.";
+        readonly unauthenticated: "No usable credential: none was sent, or it is malformed, unknown, revoked or an expired account token.";
+        readonly api_key_expired: "The API key is past its expiry (or the grace of the rotation that replaced it).";
+        readonly missing_scope: "The API key lacks the scope the operation needs.";
+        readonly role_forbidden: "The member's role does not allow the operation.";
+        readonly account_token_forbidden: "An account token called an operation account tokens cannot call.";
+        readonly rate_limited: "The tenant used up its plan's request rate; Retry-After says when the window ends.";
+        readonly too_many_requests: "The credential has too many requests in flight at once; retry after Retry-After.";
+        readonly overloaded: "The API is shedding load; retry after Retry-After.";
+        readonly payload_too_large: "The request body is larger than the API accepts.";
+        readonly internal_error: "An unexpected failure on our side.";
+        readonly invalid_idempotency_key: "POST only: the Idempotency-Key header is not 1 to 255 printable ASCII characters.";
+        readonly idempotency_key_reused: "POST only: the Idempotency-Key was used in the last 24 hours with another method, path or body.";
+        readonly idempotency_key_in_progress: "POST only: the request first sent with this Idempotency-Key has not been answered yet.";
+    }>>, {
+        unknown_mailbox: import("../errors.js").DeclaredError<"unknown_mailbox">;
+        invalid_cursor: {
+            status: 400;
+            message: string;
+        };
+        account_not_found: {
+            status: 404;
+            message: string;
+        };
+    }>, Record<never, never>>;
+    get: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        accountId: z.ZodUUID;
+        threadId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        subject: z.ZodNullable<z.ZodString>;
+        snippet: z.ZodNullable<z.ZodString>;
+        participants: z.ZodArray<z.ZodObject<{
+            name: z.ZodNullable<z.ZodString>;
+            address: z.ZodString;
+        }, z.core.$strip>>;
+        messageCount: z.ZodNumber;
+        unreadCount: z.ZodNumber;
+        isFlagged: z.ZodBoolean;
+        hasAttachments: z.ZodBoolean;
+        hasDrafts: z.ZodBoolean;
+        mailboxIds: z.ZodArray<z.ZodUUID>;
+        latestMessageId: z.ZodUUID;
+        lastMessageAt: z.ZodNullable<z.ZodPreprocess<z.ZodDate, Date>>;
+        messages: z.ZodArray<z.ZodObject<{
+            id: z.ZodUUID;
+            threadId: z.ZodNullable<z.ZodString>;
+            internetMessageId: z.ZodNullable<z.ZodString>;
+            mailboxIds: z.ZodArray<z.ZodUUID>;
+            subject: z.ZodNullable<z.ZodString>;
+            from: z.ZodNullable<z.ZodObject<{
+                name: z.ZodNullable<z.ZodString>;
+                address: z.ZodString;
+            }, z.core.$strip>>;
+            to: z.ZodArray<z.ZodObject<{
+                name: z.ZodNullable<z.ZodString>;
+                address: z.ZodString;
+            }, z.core.$strip>>;
+            cc: z.ZodArray<z.ZodObject<{
+                name: z.ZodNullable<z.ZodString>;
+                address: z.ZodString;
+            }, z.core.$strip>>;
+            snippet: z.ZodNullable<z.ZodString>;
+            receivedAt: z.ZodNullable<z.ZodPreprocess<z.ZodDate, Date>>;
+            sentAt: z.ZodNullable<z.ZodPreprocess<z.ZodDate, Date>>;
+            isRead: z.ZodBoolean;
+            isFlagged: z.ZodBoolean;
+            isDraft: z.ZodBoolean;
+            hasAttachments: z.ZodBoolean;
+            categories: z.ZodArray<z.ZodString>;
+            direction: z.ZodEnum<{
+                inbound: "inbound";
+                outbound: "outbound";
+            }>;
+            outboxId: z.ZodNullable<z.ZodUUID>;
+            reference: z.ZodNullable<z.ZodString>;
+            importance: z.ZodNullable<z.ZodEnum<{
+                normal: "normal";
+                high: "high";
+                low: "low";
+            }>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<import("@orpc/contract").MergedErrorMap<Record<never, never>, import("../errors.js").DeclaredErrors<{
+        readonly invalid_input: "The request does not match the operation's input schema (a malformed body included); data.issues names each problem.";
+        readonly unauthenticated: "No usable credential: none was sent, or it is malformed, unknown, revoked or an expired account token.";
+        readonly api_key_expired: "The API key is past its expiry (or the grace of the rotation that replaced it).";
+        readonly missing_scope: "The API key lacks the scope the operation needs.";
+        readonly role_forbidden: "The member's role does not allow the operation.";
+        readonly account_token_forbidden: "An account token called an operation account tokens cannot call.";
+        readonly rate_limited: "The tenant used up its plan's request rate; Retry-After says when the window ends.";
+        readonly too_many_requests: "The credential has too many requests in flight at once; retry after Retry-After.";
+        readonly overloaded: "The API is shedding load; retry after Retry-After.";
+        readonly payload_too_large: "The request body is larger than the API accepts.";
+        readonly internal_error: "An unexpected failure on our side.";
+        readonly invalid_idempotency_key: "POST only: the Idempotency-Key header is not 1 to 255 printable ASCII characters.";
+        readonly idempotency_key_reused: "POST only: the Idempotency-Key was used in the last 24 hours with another method, path or body.";
+        readonly idempotency_key_in_progress: "POST only: the request first sent with this Idempotency-Key has not been answered yet.";
+    }>>, {
+        thread_not_found: {
+            status: 404;
+            message: string;
+        };
+        account_not_found: {
+            status: 404;
+            message: string;
+        };
+    }>, Record<never, never>>;
+    update: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        accountId: z.ZodUUID;
+        threadId: z.ZodString;
+        isRead: z.ZodOptional<z.ZodBoolean>;
+        mailboxId: z.ZodOptional<z.ZodUUID>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        subject: z.ZodNullable<z.ZodString>;
+        snippet: z.ZodNullable<z.ZodString>;
+        participants: z.ZodArray<z.ZodObject<{
+            name: z.ZodNullable<z.ZodString>;
+            address: z.ZodString;
+        }, z.core.$strip>>;
+        messageCount: z.ZodNumber;
+        unreadCount: z.ZodNumber;
+        isFlagged: z.ZodBoolean;
+        hasAttachments: z.ZodBoolean;
+        hasDrafts: z.ZodBoolean;
+        mailboxIds: z.ZodArray<z.ZodUUID>;
+        latestMessageId: z.ZodUUID;
+        lastMessageAt: z.ZodNullable<z.ZodPreprocess<z.ZodDate, Date>>;
+        messages: z.ZodArray<z.ZodObject<{
+            id: z.ZodUUID;
+            threadId: z.ZodNullable<z.ZodString>;
+            internetMessageId: z.ZodNullable<z.ZodString>;
+            mailboxIds: z.ZodArray<z.ZodUUID>;
+            subject: z.ZodNullable<z.ZodString>;
+            from: z.ZodNullable<z.ZodObject<{
+                name: z.ZodNullable<z.ZodString>;
+                address: z.ZodString;
+            }, z.core.$strip>>;
+            to: z.ZodArray<z.ZodObject<{
+                name: z.ZodNullable<z.ZodString>;
+                address: z.ZodString;
+            }, z.core.$strip>>;
+            cc: z.ZodArray<z.ZodObject<{
+                name: z.ZodNullable<z.ZodString>;
+                address: z.ZodString;
+            }, z.core.$strip>>;
+            snippet: z.ZodNullable<z.ZodString>;
+            receivedAt: z.ZodNullable<z.ZodPreprocess<z.ZodDate, Date>>;
+            sentAt: z.ZodNullable<z.ZodPreprocess<z.ZodDate, Date>>;
+            isRead: z.ZodBoolean;
+            isFlagged: z.ZodBoolean;
+            isDraft: z.ZodBoolean;
+            hasAttachments: z.ZodBoolean;
+            categories: z.ZodArray<z.ZodString>;
+            direction: z.ZodEnum<{
+                inbound: "inbound";
+                outbound: "outbound";
+            }>;
+            outboxId: z.ZodNullable<z.ZodUUID>;
+            reference: z.ZodNullable<z.ZodString>;
+            importance: z.ZodNullable<z.ZodEnum<{
+                normal: "normal";
+                high: "high";
+                low: "low";
+            }>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<import("@orpc/contract").MergedErrorMap<Record<never, never>, import("../errors.js").DeclaredErrors<{
+        readonly invalid_input: "The request does not match the operation's input schema (a malformed body included); data.issues names each problem.";
+        readonly unauthenticated: "No usable credential: none was sent, or it is malformed, unknown, revoked or an expired account token.";
+        readonly api_key_expired: "The API key is past its expiry (or the grace of the rotation that replaced it).";
+        readonly missing_scope: "The API key lacks the scope the operation needs.";
+        readonly role_forbidden: "The member's role does not allow the operation.";
+        readonly account_token_forbidden: "An account token called an operation account tokens cannot call.";
+        readonly rate_limited: "The tenant used up its plan's request rate; Retry-After says when the window ends.";
+        readonly too_many_requests: "The credential has too many requests in flight at once; retry after Retry-After.";
+        readonly overloaded: "The API is shedding load; retry after Retry-After.";
+        readonly payload_too_large: "The request body is larger than the API accepts.";
+        readonly internal_error: "An unexpected failure on our side.";
+        readonly invalid_idempotency_key: "POST only: the Idempotency-Key header is not 1 to 255 printable ASCII characters.";
+        readonly idempotency_key_reused: "POST only: the Idempotency-Key was used in the last 24 hours with another method, path or body.";
+        readonly idempotency_key_in_progress: "POST only: the request first sent with this Idempotency-Key has not been answered yet.";
+    }>>, {
+        unknown_mailbox: import("../errors.js").DeclaredError<"unknown_mailbox">;
+        provider_not_found: {
+            status: 404;
+            message: string;
+        };
+        provider_forbidden: {
+            status: 403;
+            message: string;
+        };
+        provider_conflict: {
+            status: 409;
+            message: string;
+        };
+        provider_unsupported: {
+            status: 400;
+            message: string;
+        };
+        provider_rejected: {
+            status: 400;
+            message: string;
+        };
+        provider_unavailable: {
+            status: 502;
+            message: string;
+        };
+        provider_throttled: {
+            status: 429;
+            message: string;
+        };
+        account_paused: {
+            status: 409;
+            message: string;
+        };
+        account_disabled: {
+            status: 409;
+            message: string;
+        };
+        account_reauth_required: {
+            status: 409;
+            message: string;
+        };
+        account_misconfigured: {
+            status: 409;
+            message: string;
+        };
+        thread_not_found: {
+            status: 404;
+            message: string;
+        };
+        account_not_found: {
+            status: 404;
+            message: string;
+        };
+    }>, Record<never, never>>;
+    delete: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        accountId: z.ZodUUID;
+        threadId: z.ZodString;
+    }, z.core.$strip>, z.ZodVoid, import("@orpc/contract").MergedErrorMap<import("@orpc/contract").MergedErrorMap<Record<never, never>, import("../errors.js").DeclaredErrors<{
+        readonly invalid_input: "The request does not match the operation's input schema (a malformed body included); data.issues names each problem.";
+        readonly unauthenticated: "No usable credential: none was sent, or it is malformed, unknown, revoked or an expired account token.";
+        readonly api_key_expired: "The API key is past its expiry (or the grace of the rotation that replaced it).";
+        readonly missing_scope: "The API key lacks the scope the operation needs.";
+        readonly role_forbidden: "The member's role does not allow the operation.";
+        readonly account_token_forbidden: "An account token called an operation account tokens cannot call.";
+        readonly rate_limited: "The tenant used up its plan's request rate; Retry-After says when the window ends.";
+        readonly too_many_requests: "The credential has too many requests in flight at once; retry after Retry-After.";
+        readonly overloaded: "The API is shedding load; retry after Retry-After.";
+        readonly payload_too_large: "The request body is larger than the API accepts.";
+        readonly internal_error: "An unexpected failure on our side.";
+        readonly invalid_idempotency_key: "POST only: the Idempotency-Key header is not 1 to 255 printable ASCII characters.";
+        readonly idempotency_key_reused: "POST only: the Idempotency-Key was used in the last 24 hours with another method, path or body.";
+        readonly idempotency_key_in_progress: "POST only: the request first sent with this Idempotency-Key has not been answered yet.";
+    }>>, {
+        provider_not_found: {
+            status: 404;
+            message: string;
+        };
+        provider_forbidden: {
+            status: 403;
+            message: string;
+        };
+        provider_conflict: {
+            status: 409;
+            message: string;
+        };
+        provider_unsupported: {
+            status: 400;
+            message: string;
+        };
+        provider_rejected: {
+            status: 400;
+            message: string;
+        };
+        provider_unavailable: {
+            status: 502;
+            message: string;
+        };
+        provider_throttled: {
+            status: 429;
+            message: string;
+        };
+        account_paused: {
+            status: 409;
+            message: string;
+        };
+        account_disabled: {
+            status: 409;
+            message: string;
+        };
+        account_reauth_required: {
+            status: 409;
+            message: string;
+        };
+        account_misconfigured: {
+            status: 409;
+            message: string;
+        };
+        thread_not_found: {
+            status: 404;
+            message: string;
+        };
+        account_not_found: {
+            status: 404;
+            message: string;
+        };
+    }>, Record<never, never>>;
+};

package/contract/usage/models.d.ts

@@ -0,0 +1,213 @@
+import * as z from "zod";
+/** The optional capabilities a plan includes. Mail is always included. */
+export declare const PlanModules: z.ZodObject<{
+    calendar: z.ZodBoolean;
+    contacts: z.ZodBoolean;
+    tracking: z.ZodBoolean;
+    ai: z.ZodBoolean;
+    meetings: z.ZodBoolean;
+    sharedMailboxes: z.ZodBoolean;
+}, z.core.$strip>;
+export type PlanModules = z.infer<typeof PlanModules>;
+export type PlanModule = keyof PlanModules;
+/** What the base fee covers; null = all of it (no overage billed). */
+export declare const PlanIncluded: z.ZodObject<{
+    accounts: z.ZodNullable<z.ZodNumber>;
+    sendsPerMonth: z.ZodNullable<z.ZodNumber>;
+    aiCallsPerMonth: z.ZodNullable<z.ZodNumber>;
+    storageBytes: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export type PlanIncluded = z.infer<typeof PlanIncluded>;
+export declare const PlanStripePrices: z.ZodObject<{
+    basePrice: z.ZodNullable<z.ZodString>;
+    accountPrice: z.ZodNullable<z.ZodString>;
+    sendsPrice: z.ZodNullable<z.ZodString>;
+    aiCallsPrice: z.ZodNullable<z.ZodString>;
+    storagePrice: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type PlanStripePrices = z.infer<typeof PlanStripePrices>;
+export declare const PlanPricing: z.ZodObject<{
+    currency: z.ZodString;
+    baseMonthly: z.ZodNumber;
+    perAccountMonthly: z.ZodNumber;
+    sendsPer1k: z.ZodNumber;
+    aiCallsPer1k: z.ZodNumber;
+    storagePerGbMonth: z.ZodNumber;
+    stripe: z.ZodObject<{
+        basePrice: z.ZodNullable<z.ZodString>;
+        accountPrice: z.ZodNullable<z.ZodString>;
+        sendsPrice: z.ZodNullable<z.ZodString>;
+        aiCallsPrice: z.ZodNullable<z.ZodString>;
+        storagePrice: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type PlanPricing = z.infer<typeof PlanPricing>;
+/** Count limits: null = unlimited. They are abuse ceilings; usage between included and a limit
+ * is billed as overage. */
+export declare const PlanLimits: z.ZodObject<{
+    maxAccounts: z.ZodNullable<z.ZodNumber>;
+    sendsPerDay: z.ZodNullable<z.ZodNumber>;
+    apiCallsPerMinute: z.ZodNullable<z.ZodNumber>;
+    apiCallsPerMinutePerKey: z.ZodNullable<z.ZodNumber>;
+    webhookEndpoints: z.ZodNullable<z.ZodNumber>;
+    bodyStorageAllowed: z.ZodBoolean;
+    storageBytes: z.ZodNullable<z.ZodNumber>;
+    modules: z.ZodObject<{
+        calendar: z.ZodBoolean;
+        contacts: z.ZodBoolean;
+        tracking: z.ZodBoolean;
+        ai: z.ZodBoolean;
+        meetings: z.ZodBoolean;
+        sharedMailboxes: z.ZodBoolean;
+    }, z.core.$strip>;
+    included: z.ZodObject<{
+        accounts: z.ZodNullable<z.ZodNumber>;
+        sendsPerMonth: z.ZodNullable<z.ZodNumber>;
+        aiCallsPerMonth: z.ZodNullable<z.ZodNumber>;
+        storageBytes: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
+    pricing: z.ZodNullable<z.ZodObject<{
+        currency: z.ZodString;
+        baseMonthly: z.ZodNumber;
+        perAccountMonthly: z.ZodNumber;
+        sendsPer1k: z.ZodNumber;
+        aiCallsPer1k: z.ZodNumber;
+        storagePerGbMonth: z.ZodNumber;
+        stripe: z.ZodObject<{
+            basePrice: z.ZodNullable<z.ZodString>;
+            accountPrice: z.ZodNullable<z.ZodString>;
+            sendsPrice: z.ZodNullable<z.ZodString>;
+            aiCallsPrice: z.ZodNullable<z.ZodString>;
+            storagePrice: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PlanLimits = z.infer<typeof PlanLimits>;
+/** The plan a tenant runs under; id null = no plan assigned, the platform defaults apply. */
+export declare const EffectivePlan: z.ZodObject<{
+    id: z.ZodNullable<z.ZodUUID>;
+    name: z.ZodString;
+    limits: z.ZodObject<{
+        maxAccounts: z.ZodNullable<z.ZodNumber>;
+        sendsPerDay: z.ZodNullable<z.ZodNumber>;
+        apiCallsPerMinute: z.ZodNullable<z.ZodNumber>;
+        apiCallsPerMinutePerKey: z.ZodNullable<z.ZodNumber>;
+        webhookEndpoints: z.ZodNullable<z.ZodNumber>;
+        bodyStorageAllowed: z.ZodBoolean;
+        storageBytes: z.ZodNullable<z.ZodNumber>;
+        modules: z.ZodObject<{
+            calendar: z.ZodBoolean;
+            contacts: z.ZodBoolean;
+            tracking: z.ZodBoolean;
+            ai: z.ZodBoolean;
+            meetings: z.ZodBoolean;
+            sharedMailboxes: z.ZodBoolean;
+        }, z.core.$strip>;
+        included: z.ZodObject<{
+            accounts: z.ZodNullable<z.ZodNumber>;
+            sendsPerMonth: z.ZodNullable<z.ZodNumber>;
+            aiCallsPerMonth: z.ZodNullable<z.ZodNumber>;
+            storageBytes: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>;
+        pricing: z.ZodNullable<z.ZodObject<{
+            currency: z.ZodString;
+            baseMonthly: z.ZodNumber;
+            perAccountMonthly: z.ZodNumber;
+            sendsPer1k: z.ZodNumber;
+            aiCallsPer1k: z.ZodNumber;
+            storagePerGbMonth: z.ZodNumber;
+            stripe: z.ZodObject<{
+                basePrice: z.ZodNullable<z.ZodString>;
+                accountPrice: z.ZodNullable<z.ZodString>;
+                sendsPrice: z.ZodNullable<z.ZodString>;
+                aiCallsPrice: z.ZodNullable<z.ZodString>;
+                storagePrice: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type EffectivePlan = z.infer<typeof EffectivePlan>;
+export declare const UsageDay: z.ZodObject<{
+    day: z.ZodISODate;
+    liveAccounts: z.ZodNumber;
+    apiCalls: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    sends: z.ZodNumber;
+    webhookDeliveries: z.ZodNumber;
+    aiCalls: z.ZodNumber;
+    storedBytes: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export type UsageDay = z.infer<typeof UsageDay>;
+/** Where the tenant stands against its plan right now. */
+export declare const CurrentUsage: z.ZodObject<{
+    accounts: z.ZodNumber;
+    webhookEndpoints: z.ZodNumber;
+    sendsToday: z.ZodNumber;
+    storedBytes: z.ZodNumber;
+}, z.core.$strip>;
+export type CurrentUsage = z.infer<typeof CurrentUsage>;
+export declare const Usage: z.ZodObject<{
+    plan: z.ZodObject<{
+        id: z.ZodNullable<z.ZodUUID>;
+        name: z.ZodString;
+        limits: z.ZodObject<{
+            maxAccounts: z.ZodNullable<z.ZodNumber>;
+            sendsPerDay: z.ZodNullable<z.ZodNumber>;
+            apiCallsPerMinute: z.ZodNullable<z.ZodNumber>;
+            apiCallsPerMinutePerKey: z.ZodNullable<z.ZodNumber>;
+            webhookEndpoints: z.ZodNullable<z.ZodNumber>;
+            bodyStorageAllowed: z.ZodBoolean;
+            storageBytes: z.ZodNullable<z.ZodNumber>;
+            modules: z.ZodObject<{
+                calendar: z.ZodBoolean;
+                contacts: z.ZodBoolean;
+                tracking: z.ZodBoolean;
+                ai: z.ZodBoolean;
+                meetings: z.ZodBoolean;
+                sharedMailboxes: z.ZodBoolean;
+            }, z.core.$strip>;
+            included: z.ZodObject<{
+                accounts: z.ZodNullable<z.ZodNumber>;
+                sendsPerMonth: z.ZodNullable<z.ZodNumber>;
+                aiCallsPerMonth: z.ZodNullable<z.ZodNumber>;
+                storageBytes: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strip>;
+            pricing: z.ZodNullable<z.ZodObject<{
+                currency: z.ZodString;
+                baseMonthly: z.ZodNumber;
+                perAccountMonthly: z.ZodNumber;
+                sendsPer1k: z.ZodNumber;
+                aiCallsPer1k: z.ZodNumber;
+                storagePerGbMonth: z.ZodNumber;
+                stripe: z.ZodObject<{
+                    basePrice: z.ZodNullable<z.ZodString>;
+                    accountPrice: z.ZodNullable<z.ZodString>;
+                    sendsPrice: z.ZodNullable<z.ZodString>;
+                    aiCallsPrice: z.ZodNullable<z.ZodString>;
+                    storagePrice: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    current: z.ZodObject<{
+        accounts: z.ZodNumber;
+        webhookEndpoints: z.ZodNumber;
+        sendsToday: z.ZodNumber;
+        storedBytes: z.ZodNumber;
+    }, z.core.$strip>;
+    days: z.ZodArray<z.ZodObject<{
+        day: z.ZodISODate;
+        liveAccounts: z.ZodNumber;
+        apiCalls: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        sends: z.ZodNumber;
+        webhookDeliveries: z.ZodNumber;
+        aiCalls: z.ZodNumber;
+        storedBytes: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Usage = z.infer<typeof Usage>;
+/** UTC days, both ends included: from defaults to 30 days before to, to to today. */
+export declare const UsageQuery: z.ZodObject<{
+    from: z.ZodOptional<z.ZodISODate>;
+    to: z.ZodOptional<z.ZodISODate>;
+}, z.core.$strip>;
+export type UsageQuery = z.infer<typeof UsageQuery>;

package/contract/usage/routes.d.ts

@@ -0,0 +1,81 @@
+export declare const usage: {
+    get: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
+        from: import("zod").ZodOptional<import("zod").ZodISODate>;
+        to: import("zod").ZodOptional<import("zod").ZodISODate>;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+        plan: import("zod").ZodObject<{
+            id: import("zod").ZodNullable<import("zod").ZodUUID>;
+            name: import("zod").ZodString;
+            limits: import("zod").ZodObject<{
+                maxAccounts: import("zod").ZodNullable<import("zod").ZodNumber>;
+                sendsPerDay: import("zod").ZodNullable<import("zod").ZodNumber>;
+                apiCallsPerMinute: import("zod").ZodNullable<import("zod").ZodNumber>;
+                apiCallsPerMinutePerKey: import("zod").ZodNullable<import("zod").ZodNumber>;
+                webhookEndpoints: import("zod").ZodNullable<import("zod").ZodNumber>;
+                bodyStorageAllowed: import("zod").ZodBoolean;
+                storageBytes: import("zod").ZodNullable<import("zod").ZodNumber>;
+                modules: import("zod").ZodObject<{
+                    calendar: import("zod").ZodBoolean;
+                    contacts: import("zod").ZodBoolean;
+                    tracking: import("zod").ZodBoolean;
+                    ai: import("zod").ZodBoolean;
+                    meetings: import("zod").ZodBoolean;
+                    sharedMailboxes: import("zod").ZodBoolean;
+                }, import("zod/v4/core").$strip>;
+                included: import("zod").ZodObject<{
+                    accounts: import("zod").ZodNullable<import("zod").ZodNumber>;
+                    sendsPerMonth: import("zod").ZodNullable<import("zod").ZodNumber>;
+                    aiCallsPerMonth: import("zod").ZodNullable<import("zod").ZodNumber>;
+                    storageBytes: import("zod").ZodNullable<import("zod").ZodNumber>;
+                }, import("zod/v4/core").$strip>;
+                pricing: import("zod").ZodNullable<import("zod").ZodObject<{
+                    currency: import("zod").ZodString;
+                    baseMonthly: import("zod").ZodNumber;
+                    perAccountMonthly: import("zod").ZodNumber;
+                    sendsPer1k: import("zod").ZodNumber;
+                    aiCallsPer1k: import("zod").ZodNumber;
+                    storagePerGbMonth: import("zod").ZodNumber;
+                    stripe: import("zod").ZodObject<{
+                        basePrice: import("zod").ZodNullable<import("zod").ZodString>;
+                        accountPrice: import("zod").ZodNullable<import("zod").ZodString>;
+                        sendsPrice: import("zod").ZodNullable<import("zod").ZodString>;
+                        aiCallsPrice: import("zod").ZodNullable<import("zod").ZodString>;
+                        storagePrice: import("zod").ZodNullable<import("zod").ZodString>;
+                    }, import("zod/v4/core").$strip>;
+                }, import("zod/v4/core").$strip>>;
+            }, import("zod/v4/core").$strip>;
+        }, import("zod/v4/core").$strip>;
+        current: import("zod").ZodObject<{
+            accounts: import("zod").ZodNumber;
+            webhookEndpoints: import("zod").ZodNumber;
+            sendsToday: import("zod").ZodNumber;
+            storedBytes: import("zod").ZodNumber;
+        }, import("zod/v4/core").$strip>;
+        days: import("zod").ZodArray<import("zod").ZodObject<{
+            day: import("zod").ZodISODate;
+            liveAccounts: import("zod").ZodNumber;
+            apiCalls: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>;
+            sends: import("zod").ZodNumber;
+            webhookDeliveries: import("zod").ZodNumber;
+            aiCalls: import("zod").ZodNumber;
+            storedBytes: import("zod").ZodNullable<import("zod").ZodNumber>;
+        }, import("zod/v4/core").$strip>>;
+    }, import("zod/v4/core").$strip>, import("@orpc/contract").MergedErrorMap<import("@orpc/contract").MergedErrorMap<Record<never, never>, import("../errors.js").DeclaredErrors<{
+        readonly invalid_input: "The request does not match the operation's input schema (a malformed body included); data.issues names each problem.";
+        readonly unauthenticated: "No usable credential: none was sent, or it is malformed, unknown, revoked or an expired account token.";
+        readonly api_key_expired: "The API key is past its expiry (or the grace of the rotation that replaced it).";
+        readonly missing_scope: "The API key lacks the scope the operation needs.";
+        readonly role_forbidden: "The member's role does not allow the operation.";
+        readonly account_token_forbidden: "An account token called an operation account tokens cannot call.";
+        readonly rate_limited: "The tenant used up its plan's request rate; Retry-After says when the window ends.";
+        readonly too_many_requests: "The credential has too many requests in flight at once; retry after Retry-After.";
+        readonly overloaded: "The API is shedding load; retry after Retry-After.";
+        readonly payload_too_large: "The request body is larger than the API accepts.";
+        readonly internal_error: "An unexpected failure on our side.";
+        readonly invalid_idempotency_key: "POST only: the Idempotency-Key header is not 1 to 255 printable ASCII characters.";
+        readonly idempotency_key_reused: "POST only: the Idempotency-Key was used in the last 24 hours with another method, path or body.";
+        readonly idempotency_key_in_progress: "POST only: the request first sent with this Idempotency-Key has not been answered yet.";
+    }>>, import("../errors.js").DeclaredErrors<{
+        readonly invalid_range: "from is after to (or after today, with to left out), or the range spans more than 366 days.";
+    }>>, Record<never, never>>;
+};