@read-frog/api-contract 0.21.0 → 0.22.0

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { ContractRouterClient, ErrorMap, Route } from "@orpc/contract";
-import { CardState, ReviewRating, SRS_REVIEW_DURATION_MS_MAX, ScheduleStatus, SchedulingParams, cardStateSchema, reviewRatingSchema, scheduleStatusSchema, schedulingParamsSchema } from "@read-frog/definitions";
 import { z } from "zod";
+import { CardState, ReviewRating, SRS_REVIEW_DURATION_MS_MAX, ScheduleStatus, SchedulingParams, cardStateSchema, reviewRatingSchema, scheduleStatusSchema, schedulingParamsSchema } from "@read-frog/definitions";
 //#region src/contracts/shared.d.ts
 /**
  * A documented business route shared by OpenAPI and agent-facing adapters.
@@ -147,18 +147,10 @@ export declare const PUBLIC_APP_ERROR_DEFS: {
     readonly message: "Built-in AI credit exhausted";
     readonly status: 429;
   };
-  readonly NOTEBASE_BETA_RESTRICTED: {
-    readonly message: "Notebase is currently in beta for selected accounts";
-    readonly status: 403;
-  };
   readonly NOTEBASE_NOT_FOUND: {
     readonly message: "Notebase not found";
     readonly status: 404;
   };
-  readonly VIDEO_TRANSCRIPTION_BETA_RESTRICTED: {
-    readonly message: "Video transcription is currently in beta for selected accounts";
-    readonly status: 403;
-  };
   readonly VIDEO_TRANSCRIPTION_SUBSCRIPTION_REQUIRED: {
     readonly message: "AI subtitles require a Pro or Ultra subscription";
     readonly status: 403;
@@ -348,6 +340,10 @@ export declare const PUBLIC_APP_ERROR_DEFS: {
     readonly message: "Ebook upload has not been completed";
     readonly status: 409;
   };
+  readonly EMAIL_LINK_INVALID: {
+    readonly message: "This email link is not valid";
+    readonly status: 400;
+  };
 };
 export type PublicAppErrorCode = keyof typeof PUBLIC_APP_ERROR_DEFS;
 export type PublicAppErrorData<TCode extends PublicAppErrorCode> = (typeof PUBLIC_APP_ERROR_DEFS)[TCode] extends {
@@ -395,18 +391,10 @@ export declare function getPublicErrorDefinition<TCode extends PublicAppErrorCod
     readonly message: "Built-in AI credit exhausted";
     readonly status: 429;
   };
-  readonly NOTEBASE_BETA_RESTRICTED: {
-    readonly message: "Notebase is currently in beta for selected accounts";
-    readonly status: 403;
-  };
   readonly NOTEBASE_NOT_FOUND: {
     readonly message: "Notebase not found";
     readonly status: 404;
   };
-  readonly VIDEO_TRANSCRIPTION_BETA_RESTRICTED: {
-    readonly message: "Video transcription is currently in beta for selected accounts";
-    readonly status: 403;
-  };
   readonly VIDEO_TRANSCRIPTION_SUBSCRIPTION_REQUIRED: {
     readonly message: "AI subtitles require a Pro or Ultra subscription";
     readonly status: 403;
@@ -596,33 +584,31 @@ export declare function getPublicErrorDefinition<TCode extends PublicAppErrorCod
     readonly message: "Ebook upload has not been completed";
     readonly status: 409;
   };
+  readonly EMAIL_LINK_INVALID: {
+    readonly message: "This email link is not valid";
+    readonly status: 400;
+  };
 }[TCode];
 export declare function pickPublicErrorMap<const TCodes extends readonly PublicAppErrorCode[]>(...codes: TCodes): Pick<ErrorMap, TCodes[number]>;
 //#endregion
-//#region src/schemas/beta-access.d.ts
-export declare const BetaFeatureKeySchema: z.ZodEnum<{
-  ebook: "ebook";
-  notebase: "notebase";
-  videoTranscription: "videoTranscription";
+//#region src/schemas/app-locale.d.ts
+/**
+ * The languages the website is in (`project.inlang/settings.json`; a test in
+ * apps/www keeps the two in step). Used wherever the server writes for a
+ * person: Stripe pages, emails, and the account's `locale`.
+ */
+export declare const appLocaleSchema: z.ZodEnum<{
+  en: "en";
+  es: "es";
+  ja: "ja";
+  ko: "ko";
+  ru: "ru";
+  tr: "tr";
+  vi: "vi";
+  zh: "zh";
+  "zh-TW": "zh-TW";
 }>;
-export type BetaFeatureKey = z.infer<typeof BetaFeatureKeySchema>;
-export declare const BetaAccessStatusInputSchema: z.ZodObject<{
-  featureKey: z.ZodEnum<{
-    ebook: "ebook";
-    notebase: "notebase";
-    videoTranscription: "videoTranscription";
-  }>;
-}, z.core.$strict>;
-export type BetaAccessStatusInput = z.infer<typeof BetaAccessStatusInputSchema>;
-export declare const BetaAccessStatusOutputSchema: z.ZodObject<{
-  featureKey: z.ZodEnum<{
-    ebook: "ebook";
-    notebase: "notebase";
-    videoTranscription: "videoTranscription";
-  }>;
-  allowed: z.ZodBoolean;
-}, z.core.$strip>;
-export type BetaAccessStatusOutput = z.infer<typeof BetaAccessStatusOutputSchema>;
+export type AppLocale = z.infer<typeof appLocaleSchema>;
 //#endregion
 //#region src/schemas/billing.d.ts
 export declare const billingIntervalSchema: z.ZodEnum<{
@@ -648,27 +634,20 @@ export declare const billingPlanSchema: z.ZodEnum<{
 }>;
 export type BillingPlan = z.infer<typeof billingPlanSchema>;
 /**
- * Whether a plan may use a feature, given the plans that feature allows.
+ * How many MCP tool calls each plan may make in a day (24 hours from the first
+ * one); `null` is no limit. Each `tools/call` counts once, whatever the tool.
  *
- * An explicit set rather than a minimum tier: there is no rank table to keep in
- * step with the plan enum, and any combination is expressible by writing it
- * down. The cost is that nothing derives from it automatically -- a feature's
- * pricing-card placement is a companion edit, noted at each `*_ALLOWED_PLANS`.
- */
-export declare function isPlanAllowed(plan: BillingPlan, allowed: readonly BillingPlan[]): boolean;
-/**
- * Plans that may use the remote MCP server.
+ * Read by the MCP server's gate AND by the website's copy, so the pages cannot
+ * promise calls the server refuses.
  *
- * Read by the server-side gate AND by the website's copy, so the page cannot
- * promise access the API refuses. `satisfies` keeps the literal tuple type so
- * the UI can render the plan names from this constant instead of hardcoding
- * them.
- *
- * Companion edit when this changes: the feature bullet in
- * `apps/www/src/routes/pricing.tsx` lives on the lowest allowed plan's card
- * (higher cards inherit it through their "everything in <lower plan>" line).
+ * Companion edit when this changes: the MCP docs under
+ * `apps/www/content/docs/mcp/` and `account-and-plans`, which state the numbers.
  */
-export declare const MCP_ALLOWED_PLANS: readonly ["ultra"];
+export declare const MCP_DAILY_CALL_LIMITS: {
+  readonly free: 10;
+  readonly pro: 50;
+  readonly ultra: null;
+};
 export declare const billingCheckoutPlanSchema: z.ZodEnum<{
   pro: "pro";
   ultra: "ultra";
@@ -691,7 +670,7 @@ export declare const billingLocaleSchema: z.ZodEnum<{
   zh: "zh";
   "zh-TW": "zh-TW";
 }>;
-export type BillingLocale = z.infer<typeof billingLocaleSchema>;
+export type BillingLocale = AppLocale;
 export declare const billingAccessSourceSchema: z.ZodEnum<{
   pass: "pass";
   subscription: "subscription";
@@ -709,6 +688,26 @@ export declare const billingScheduledChangeSchema: z.ZodObject<{
   effectiveAt: z.ZodCoercedDate<unknown>;
 }, z.core.$strict>;
 export type BillingScheduledChange = z.infer<typeof billingScheduledChangeSchema>;
+/**
+ * The zone a payment deadline is shown in, as a date with no time. UTC−12 is
+ * the last zone to finish a day, and `dueBy` is the end of a day there, so the
+ * date it shows stays open in every customer's zone until their own midnight.
+ */
+export declare const BILLING_PAYMENT_DUE_TIME_ZONE = "Etc/GMT+12";
+/**
+ * A renewal whose payment failed. The plan stays until `dueBy`; paying the
+ * invoice before then (or later, until the subscription is canceled) restores
+ * the subscription as if the payment had gone through.
+ */
+export declare const billingPaymentDueSchema: z.ZodObject<{
+  dueBy: z.ZodCoercedDate<unknown>;
+  plan: z.ZodEnum<{
+    pro: "pro";
+    ultra: "ultra";
+  }>;
+  url: z.ZodNullable<z.ZodURL>;
+}, z.core.$strict>;
+export type BillingPaymentDue = z.infer<typeof billingPaymentDueSchema>;
 export declare const billingStatusSchema: z.ZodObject<{
   plan: z.ZodEnum<{
     free: "free";
@@ -746,6 +745,14 @@ export declare const billingStatusSchema: z.ZodObject<{
     }>;
     effectiveAt: z.ZodCoercedDate<unknown>;
   }, z.core.$strict>>;
+  paymentDue: z.ZodNullable<z.ZodObject<{
+    dueBy: z.ZodCoercedDate<unknown>;
+    plan: z.ZodEnum<{
+      pro: "pro";
+      ultra: "ultra";
+    }>;
+    url: z.ZodNullable<z.ZodURL>;
+  }, z.core.$strict>>;
   unlimitedNotebaseNotes: z.ZodBoolean;
   notebaseNoteLimit: z.ZodNumber;
   notebaseNoteCount: z.ZodNumber;
@@ -1362,31 +1369,35 @@ export declare const ebookRequestUploadInputSchema: z.ZodObject<{
   title: z.ZodString;
   author: z.ZodOptional<z.ZodString>;
   language: z.ZodOptional<z.ZodString>;
-  coverContentType: z.ZodOptional<z.ZodEnum<{
-    "image/jpeg": "image/jpeg";
-    "image/png": "image/png";
-    "image/webp": "image/webp";
-  }>>;
+  fileByteSize: z.ZodNumber;
+  cover: z.ZodOptional<z.ZodObject<{
+    contentType: z.ZodEnum<{
+      "image/jpeg": "image/jpeg";
+      "image/png": "image/png";
+      "image/webp": "image/webp";
+    }>;
+    byteSize: z.ZodNumber;
+  }, z.core.$strict>>;
 }, z.core.$strict>;
 export type EbookRequestUploadInput = z.infer<typeof ebookRequestUploadInputSchema>;
 /**
- * S3 POST form policy. `fields` must be appended to the form in iteration order
- * with the file last; S3 ignores anything sent after the `file` part.
+ * A signed PUT: send the file to `url` with exactly `headers`. The signature
+ * covers the file's type and exact size, so storage refuses any other file.
  */
-export declare const ebookPresignedPostSchema: z.ZodObject<{
+export declare const ebookPresignedUploadSchema: z.ZodObject<{
   url: z.ZodURL;
-  fields: z.ZodRecord<z.ZodString, z.ZodString>;
+  headers: z.ZodRecord<z.ZodString, z.ZodString>;
 }, z.core.$strict>;
-export type EbookPresignedPost = z.infer<typeof ebookPresignedPostSchema>;
+export type EbookPresignedUpload = z.infer<typeof ebookPresignedUploadSchema>;
 export declare const ebookRequestUploadOutputSchema: z.ZodObject<{
   ebookId: z.ZodUUID;
   upload: z.ZodObject<{
     url: z.ZodURL;
-    fields: z.ZodRecord<z.ZodString, z.ZodString>;
+    headers: z.ZodRecord<z.ZodString, z.ZodString>;
   }, z.core.$strict>;
   coverUpload: z.ZodNullable<z.ZodObject<{
     url: z.ZodURL;
-    fields: z.ZodRecord<z.ZodString, z.ZodString>;
+    headers: z.ZodRecord<z.ZodString, z.ZodString>;
   }, z.core.$strict>>;
   expiresAt: z.ZodCoercedDate<unknown>;
 }, z.core.$strict>;
@@ -1477,6 +1488,133 @@ export declare const ebookDeleteOutputSchema: z.ZodObject<{
 }, z.core.$strict>;
 export type EbookDeleteOutput = z.infer<typeof ebookDeleteOutputSchema>;
 //#endregion
+//#region src/schemas/email-preferences.d.ts
+/** A category's key, such as `promotions`. */
+export declare const emailCategoryKeySchema: z.ZodString;
+export type EmailCategoryKey = z.infer<typeof emailCategoryKeySchema>;
+/** The token in an email's unsubscribe link. */
+export declare const emailLinkTokenSchema: z.ZodString;
+export declare const emailCategoryStateSchema: z.ZodObject<{
+  key: z.ZodString;
+  name: z.ZodString;
+  description: z.ZodNullable<z.ZodString>;
+  commercial: z.ZodBoolean;
+  required: z.ZodBoolean;
+  subscribed: z.ZodBoolean;
+}, z.core.$strict>;
+export type EmailCategoryState = z.infer<typeof emailCategoryStateSchema>;
+export declare const emailPreferencesStateSchema: z.ZodObject<{
+  categories: z.ZodArray<z.ZodObject<{
+    key: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    commercial: z.ZodBoolean;
+    required: z.ZodBoolean;
+    subscribed: z.ZodBoolean;
+  }, z.core.$strict>>;
+  unsubscribedAll: z.ZodBoolean;
+}, z.core.$strict>;
+export type EmailPreferencesState = z.infer<typeof emailPreferencesStateSchema>;
+/**
+ * What the page a link opens shows on top of the state: whose preferences they
+ * are, without the full address, and the category the link was for, if any.
+ */
+export declare const emailPreferencesByTokenStateSchema: z.ZodObject<{
+  categories: z.ZodArray<z.ZodObject<{
+    key: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    commercial: z.ZodBoolean;
+    required: z.ZodBoolean;
+    subscribed: z.ZodBoolean;
+  }, z.core.$strict>>;
+  unsubscribedAll: z.ZodBoolean;
+  maskedEmail: z.ZodString;
+  highlightCategory: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export type EmailPreferencesByTokenState = z.infer<typeof emailPreferencesByTokenStateSchema>;
+export declare const emailPreferencesGetInputSchema: z.ZodObject<{
+  locale: z.ZodEnum<{
+    en: "en";
+    es: "es";
+    ja: "ja";
+    ko: "ko";
+    ru: "ru";
+    tr: "tr";
+    vi: "vi";
+    zh: "zh";
+    "zh-TW": "zh-TW";
+  }>;
+}, z.core.$strict>;
+export type EmailPreferencesGetInput = z.infer<typeof emailPreferencesGetInputSchema>;
+export declare const emailPreferencesUpdateInputSchema: z.ZodObject<{
+  categories: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
+  unsubscribedAll: z.ZodOptional<z.ZodBoolean>;
+  locale: z.ZodEnum<{
+    en: "en";
+    es: "es";
+    ja: "ja";
+    ko: "ko";
+    ru: "ru";
+    tr: "tr";
+    vi: "vi";
+    zh: "zh";
+    "zh-TW": "zh-TW";
+  }>;
+}, z.core.$strict>;
+export type EmailPreferencesUpdateInput = z.infer<typeof emailPreferencesUpdateInputSchema>;
+export declare const emailPreferencesGetByTokenInputSchema: z.ZodObject<{
+  token: z.ZodString;
+  locale: z.ZodEnum<{
+    en: "en";
+    es: "es";
+    ja: "ja";
+    ko: "ko";
+    ru: "ru";
+    tr: "tr";
+    vi: "vi";
+    zh: "zh";
+    "zh-TW": "zh-TW";
+  }>;
+}, z.core.$strict>;
+export type EmailPreferencesGetByTokenInput = z.infer<typeof emailPreferencesGetByTokenInputSchema>;
+export declare const emailPreferencesUpdateByTokenInputSchema: z.ZodObject<{
+  categories: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
+  unsubscribedAll: z.ZodOptional<z.ZodBoolean>;
+  token: z.ZodString;
+  locale: z.ZodEnum<{
+    en: "en";
+    es: "es";
+    ja: "ja";
+    ko: "ko";
+    ru: "ru";
+    tr: "tr";
+    vi: "vi";
+    zh: "zh";
+    "zh-TW": "zh-TW";
+  }>;
+}, z.core.$strict>;
+export type EmailPreferencesUpdateByTokenInput = z.infer<typeof emailPreferencesUpdateByTokenInputSchema>;
+//#endregion
+//#region src/schemas/feature-access.d.ts
+export declare const GatedFeatureKeySchema: z.ZodEnum<{
+  ebook: "ebook";
+}>;
+export type GatedFeatureKey = z.infer<typeof GatedFeatureKeySchema>;
+export declare const FeatureAccessStatusInputSchema: z.ZodObject<{
+  featureKey: z.ZodEnum<{
+    ebook: "ebook";
+  }>;
+}, z.core.$strict>;
+export type FeatureAccessStatusInput = z.infer<typeof FeatureAccessStatusInputSchema>;
+export declare const FeatureAccessStatusOutputSchema: z.ZodObject<{
+  featureKey: z.ZodEnum<{
+    ebook: "ebook";
+  }>;
+  allowed: z.ZodBoolean;
+}, z.core.$strip>;
+export type FeatureAccessStatusOutput = z.infer<typeof FeatureAccessStatusOutputSchema>;
+//#endregion
 //#region src/schemas/hosted-ai.d.ts
 export declare const HostedAiOutputFieldTypeSchema: z.ZodEnum<{
   number: "number";
@@ -1639,13 +1777,16 @@ export declare const HostedAiRateLimitErrorDataSchema: z.ZodObject<{
   }>;
 }, z.core.$strip>;
 /**
+ * A recurring pool: the plan's credit for a day or a week, which refills at
+ * `resetAt`.
+ *
  * Deliberately free of dollar amounts and of the versioned policy id. Clients
  * render a consumption bar and a reset time, so a percentage and a period kind
  * are all they need, and neither leaks what a call costs us. `usedPercent`
  * counts settled spend only: including in-flight reservations would make the
  * bar jump forward and then back as each stream settles.
  */
-export declare const HostedAiCreditStatusSchema: z.ZodObject<{
+export declare const HostedAiRecurringCreditStatusSchema: z.ZodObject<{
   periodKind: z.ZodEnum<{
     daily: "daily";
     weekly: "weekly";
@@ -1662,6 +1803,62 @@ export declare const HostedAiCreditStatusSchema: z.ZodObject<{
     videoSubtitles: "videoSubtitles";
   }>>;
 }, z.core.$strict>;
+/**
+ * A one-time pool, such as credit from a campaign or from support. It never
+ * refills: once spent or past `expiresAt` it is gone, so a client shows the
+ * expiry, not a reset. It is drawn on only after the plan's own pool for a
+ * feature is spent, or for a feature the plan does not fund. Listed until it
+ * expires, even when spent. Same fields as a recurring pool otherwise.
+ */
+export declare const HostedAiOneTimeCreditStatusSchema: z.ZodObject<{
+  periodKind: z.ZodLiteral<"once">;
+  usedPercent: z.ZodNumber;
+  expiresAt: z.ZodISODateTime;
+  features: z.ZodArray<z.ZodEnum<{
+    customAction: "customAction";
+    inputTranslation: "inputTranslation";
+    languageDetection: "languageDetection";
+    noteSuggestion: "noteSuggestion";
+    pageTranslation: "pageTranslation";
+    selectionTranslation: "selectionTranslation";
+    videoSubtitles: "videoSubtitles";
+  }>>;
+}, z.core.$strict>;
+/**
+ * One pool that can pay for Built-in AI, told apart by `periodKind`: a
+ * recurring `daily` or `weekly` pool refills at `resetAt`, a one-time (`once`)
+ * pool ends at `expiresAt`. Narrow on `periodKind` before reading either.
+ */
+export declare const HostedAiCreditPoolStatusSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  periodKind: z.ZodEnum<{
+    daily: "daily";
+    weekly: "weekly";
+  }>;
+  usedPercent: z.ZodNumber;
+  resetAt: z.ZodNullable<z.ZodISODateTime>;
+  features: z.ZodArray<z.ZodEnum<{
+    customAction: "customAction";
+    inputTranslation: "inputTranslation";
+    languageDetection: "languageDetection";
+    noteSuggestion: "noteSuggestion";
+    pageTranslation: "pageTranslation";
+    selectionTranslation: "selectionTranslation";
+    videoSubtitles: "videoSubtitles";
+  }>>;
+}, z.core.$strict>, z.ZodObject<{
+  periodKind: z.ZodLiteral<"once">;
+  usedPercent: z.ZodNumber;
+  expiresAt: z.ZodISODateTime;
+  features: z.ZodArray<z.ZodEnum<{
+    customAction: "customAction";
+    inputTranslation: "inputTranslation";
+    languageDetection: "languageDetection";
+    noteSuggestion: "noteSuggestion";
+    pageTranslation: "pageTranslation";
+    selectionTranslation: "selectionTranslation";
+    videoSubtitles: "videoSubtitles";
+  }>>;
+}, z.core.$strict>], "periodKind">;
 export declare const HostedAiTierStatusSchema: z.ZodObject<{
   accessAllowed: z.ZodBoolean;
   available: z.ZodBoolean;
@@ -1718,6 +1915,36 @@ export declare const HostedAiStatusOutputSchema: z.ZodObject<{
       videoSubtitles: "videoSubtitles";
     }>>;
   }, z.core.$strict>>;
+  pools: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    periodKind: z.ZodEnum<{
+      daily: "daily";
+      weekly: "weekly";
+    }>;
+    usedPercent: z.ZodNumber;
+    resetAt: z.ZodNullable<z.ZodISODateTime>;
+    features: z.ZodArray<z.ZodEnum<{
+      customAction: "customAction";
+      inputTranslation: "inputTranslation";
+      languageDetection: "languageDetection";
+      noteSuggestion: "noteSuggestion";
+      pageTranslation: "pageTranslation";
+      selectionTranslation: "selectionTranslation";
+      videoSubtitles: "videoSubtitles";
+    }>>;
+  }, z.core.$strict>, z.ZodObject<{
+    periodKind: z.ZodLiteral<"once">;
+    usedPercent: z.ZodNumber;
+    expiresAt: z.ZodISODateTime;
+    features: z.ZodArray<z.ZodEnum<{
+      customAction: "customAction";
+      inputTranslation: "inputTranslation";
+      languageDetection: "languageDetection";
+      noteSuggestion: "noteSuggestion";
+      pageTranslation: "pageTranslation";
+      selectionTranslation: "selectionTranslation";
+      videoSubtitles: "videoSubtitles";
+    }>>;
+  }, z.core.$strict>], "periodKind">>;
   features: z.ZodObject<{
     pageTranslation: z.ZodObject<{
       normal: z.ZodObject<{
@@ -1918,7 +2145,9 @@ export type HostedAiCreditPolicyId = z.infer<typeof HostedAiCreditPolicyIdSchema
 export type HostedAiCreditPeriodKind = z.infer<typeof HostedAiCreditPeriodKindSchema>;
 export type HostedAiQuotaScope = z.infer<typeof HostedAiQuotaScopeSchema>;
 export type HostedAiRateLimitErrorData = z.infer<typeof HostedAiRateLimitErrorDataSchema>;
-export type HostedAiCreditStatus = z.infer<typeof HostedAiCreditStatusSchema>;
+export type HostedAiRecurringCreditStatus = z.infer<typeof HostedAiRecurringCreditStatusSchema>;
+export type HostedAiOneTimeCreditStatus = z.infer<typeof HostedAiOneTimeCreditStatusSchema>;
+export type HostedAiCreditPoolStatus = z.infer<typeof HostedAiCreditPoolStatusSchema>;
 export type HostedAiTierStatus = z.infer<typeof HostedAiTierStatusSchema>;
 export type HostedAiFeatureStatus = z.infer<typeof HostedAiFeatureStatusSchema>;
 export type HostedAiStatusOutput = z.infer<typeof HostedAiStatusOutputSchema>;
@@ -2003,6 +2232,7 @@ export declare const notebaseSchema: z.ZodObject<{
     "FSRS-6": "FSRS-6";
     "FSRS-7": "FSRS-7";
   }>;
+  srsSleepingAt: z.ZodNullable<z.ZodDate>;
   createdAt: z.ZodDate;
   updatedAt: z.ZodDate;
 }, z.core.$strip>;
@@ -2110,6 +2340,7 @@ export declare const NotebaseCreateOutputSchema: z.ZodObject<{
       "FSRS-6": "FSRS-6";
       "FSRS-7": "FSRS-7";
     }>;
+    srsSleepingAt: z.ZodNullable<z.ZodDate>;
     createdAt: z.ZodDate;
     updatedAt: z.ZodDate;
   }, z.core.$strip>;
@@ -2150,12 +2381,22 @@ export declare const NotebaseUpdateOutputSchema: z.ZodObject<{
       "FSRS-6": "FSRS-6";
       "FSRS-7": "FSRS-7";
     }>;
+    srsSleepingAt: z.ZodNullable<z.ZodDate>;
     createdAt: z.ZodDate;
     updatedAt: z.ZodDate;
   }, z.core.$strip>;
   txid: z.ZodNumber;
 }, z.core.$strip>;
 export type NotebaseUpdateOutput = z.infer<typeof NotebaseUpdateOutputSchema>;
+export declare const NotebaseSetSleepInputSchema: z.ZodObject<{
+  id: z.ZodUUID;
+  enabled: z.ZodBoolean;
+}, z.core.$strict>;
+export type NotebaseSetSleepInput = z.infer<typeof NotebaseSetSleepInputSchema>;
+export declare const NotebaseSetSleepOutputSchema: z.ZodObject<{
+  txid: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export type NotebaseSetSleepOutput = z.infer<typeof NotebaseSetSleepOutputSchema>;
 export declare const NotebaseDeleteInputSchema: z.ZodObject<{
   id: z.ZodUUID;
 }, z.core.$strip>;
@@ -2204,6 +2445,7 @@ export declare const NotebaseGetOutputSchema: z.ZodObject<{
     "FSRS-6": "FSRS-6";
     "FSRS-7": "FSRS-7";
   }>;
+  srsSleepingAt: z.ZodNullable<z.ZodDate>;
   createdAt: z.ZodCoercedDate<unknown>;
   updatedAt: z.ZodCoercedDate<unknown>;
   notebaseColumns: z.ZodArray<z.ZodObject<{
@@ -4031,12 +4273,27 @@ export declare const speechSynthesizeInputSchema: z.ZodObject<{
   voice: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type SpeechSynthesizeInput = z.infer<typeof speechSynthesizeInputSchema>;
-/** The audio, as an MP3 file. */
-export declare const speechSynthesizeOutputSchema: z.ZodFile;
+/**
+ * Where to download the audio, an MP3: a link to fetch at once, which stops
+ * working at `expiresAt`.
+ */
+export declare const speechSynthesizeOutputSchema: z.ZodObject<{
+  url: z.ZodURL;
+  expiresAt: z.ZodCoercedDate<unknown>;
+}, z.core.$strict>;
+export type SpeechSynthesizeOutput = z.infer<typeof speechSynthesizeOutputSchema>;
 //#endregion
 //#region src/schemas/timezone.d.ts
 export declare const timezoneSchema: z.ZodString;
 export type Timezone = z.infer<typeof timezoneSchema>;
+/**
+ * The zone a call reckons days in, under the name an account's zone is stored
+ * under (`canonicalTimeZone`): "Asia/Calcutta" arrives as "Asia/Kolkata" and
+ * "CST" as "America/Chicago", names that Temporal and a Debian Postgres both
+ * read. A fixed offset ("+08:00") is refused, as Postgres reads it with the
+ * opposite sign and would put the call's days on the wrong side of UTC.
+ */
+export declare const canonicalTimezoneSchema: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
 //#endregion
 //#region src/schemas/srs.d.ts
 export declare const stepSchema: z.ZodTemplateLiteral<`${number}d` | `${number}h` | `${number}m`>;
@@ -4057,7 +4314,7 @@ export declare const srsReviewInputSchema: z.ZodObject<{
     hard: "hard";
   }>;
   durationMs: z.ZodNumber;
-  timezone: z.ZodString;
+  timezone: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
 }, z.core.$strict>;
 export type SrsReviewInput = z.infer<typeof srsReviewInputSchema>;
 export declare const srsRollbackReviewInputSchema: z.ZodObject<{
@@ -4073,7 +4330,7 @@ export declare const srsScheduleStatusStatsSchema: z.ZodRecord<z.ZodEnum<{
 export type SrsScheduleStatusStats = z.infer<typeof srsScheduleStatusStatsSchema>;
 export declare const srsScheduleStatusStatsInputSchema: z.ZodObject<{
   notebaseIds: z.ZodOptional<z.ZodArray<z.ZodUUID>>;
-  timezone: z.ZodString;
+  timezone: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
 }, z.core.$strict>;
 export type SrsScheduleStatusStatsInput = z.infer<typeof srsScheduleStatusStatsInputSchema>;
 export declare const srsScheduleStatusStatsOutputSchema: z.ZodRecord<z.ZodUUID, z.ZodRecord<z.ZodEnum<{
@@ -4083,7 +4340,7 @@ export declare const srsScheduleStatusStatsOutputSchema: z.ZodRecord<z.ZodUUID,
 }>, z.ZodNumber>>;
 export type SrsScheduleStatusStatsOutput = z.infer<typeof srsScheduleStatusStatsOutputSchema>;
 export declare const srsRecentNotebaseScheduleStatusStatsInputSchema: z.ZodObject<{
-  timezone: z.ZodString;
+  timezone: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
 }, z.core.$strict>;
 export type SrsRecentNotebaseScheduleStatusStatsInput = z.infer<typeof srsRecentNotebaseScheduleStatusStatsInputSchema>;
 /** Null when the user has no notebase yet. */
@@ -4446,7 +4703,7 @@ export declare const statsInputSchema: z.ZodObject<{
   notebaseIds: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodUUID>, z.ZodTransform<string[], string[]>>>;
   from: z.ZodOptional<z.ZodISODate>;
   to: z.ZodISODate;
-  timezone: z.ZodString;
+  timezone: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
 }, z.core.$strict>;
 export type StatsInput = z.infer<typeof statsInputSchema>;
 export declare const activityStatsOutputSchema: z.ZodObject<{
@@ -4485,6 +4742,63 @@ export declare const userUpdateTimezoneOutputSchema: z.ZodObject<{
   timezone: z.ZodString;
 }, z.core.$strict>;
 export type UserUpdateTimezoneOutput = z.infer<typeof userUpdateTimezoneOutputSchema>;
+export declare const userEnsureLocaleInputSchema: z.ZodObject<{
+  locale: z.ZodEnum<{
+    en: "en";
+    es: "es";
+    ja: "ja";
+    ko: "ko";
+    ru: "ru";
+    tr: "tr";
+    vi: "vi";
+    zh: "zh";
+    "zh-TW": "zh-TW";
+  }>;
+}, z.core.$strict>;
+export type UserEnsureLocaleInput = z.infer<typeof userEnsureLocaleInputSchema>;
+export declare const userEnsureLocaleOutputSchema: z.ZodObject<{
+  locale: z.ZodEnum<{
+    en: "en";
+    es: "es";
+    ja: "ja";
+    ko: "ko";
+    ru: "ru";
+    tr: "tr";
+    vi: "vi";
+    zh: "zh";
+    "zh-TW": "zh-TW";
+  }>;
+  updated: z.ZodBoolean;
+}, z.core.$strict>;
+export type UserEnsureLocaleOutput = z.infer<typeof userEnsureLocaleOutputSchema>;
+export declare const userUpdateLocaleInputSchema: z.ZodObject<{
+  locale: z.ZodEnum<{
+    en: "en";
+    es: "es";
+    ja: "ja";
+    ko: "ko";
+    ru: "ru";
+    tr: "tr";
+    vi: "vi";
+    zh: "zh";
+    "zh-TW": "zh-TW";
+  }>;
+}, z.core.$strict>;
+export type UserUpdateLocaleInput = z.infer<typeof userUpdateLocaleInputSchema>;
+export declare const userUpdateLocaleOutputSchema: z.ZodObject<{
+  locale: z.ZodEnum<{
+    en: "en";
+    es: "es";
+    ja: "ja";
+    ko: "ko";
+    ru: "ru";
+    tr: "tr";
+    vi: "vi";
+    zh: "zh";
+    "zh-TW": "zh-TW";
+  }>;
+}, z.core.$strict>;
+export type UserUpdateLocaleOutput = z.infer<typeof userUpdateLocaleOutputSchema>;
 //#endregion
 //#region src/schemas/video-transcript.d.ts
 export declare const videoTranscriptStatusSchema: z.ZodEnum<{
@@ -4580,22 +4894,6 @@ export declare const deletionResultSchema: z.ZodObject<{
 //#endregion
 //#region src/index.d.ts
 export declare const contract: {
-  betaAccess: {
-    status: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
-      featureKey: import("zod").ZodEnum<{
-        ebook: "ebook";
-        notebase: "notebase";
-        videoTranscription: "videoTranscription";
-      }>;
-    }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
-      featureKey: import("zod").ZodEnum<{
-        ebook: "ebook";
-        notebase: "notebase";
-        videoTranscription: "videoTranscription";
-      }>;
-      allowed: import("zod").ZodBoolean;
-    }, import("zod/v4/core").$strip>, Record<never, never>, Record<never, never>>;
-  };
   billing: {
     status: import("@orpc/contract").ContractProcedureBuilderWithOutput<import("@orpc/contract").Schema<unknown, unknown>, import("zod").ZodObject<{
       plan: import("zod").ZodEnum<{
@@ -4634,6 +4932,14 @@ export declare const contract: {
         }>;
         effectiveAt: import("zod").ZodCoercedDate<unknown>;
       }, import("zod/v4/core").$strict>>;
+      paymentDue: import("zod").ZodNullable<import("zod").ZodObject<{
+        dueBy: import("zod").ZodCoercedDate<unknown>;
+        plan: import("zod").ZodEnum<{
+          pro: "pro";
+          ultra: "ultra";
+        }>;
+        url: import("zod").ZodNullable<import("zod").ZodURL>;
+      }, import("zod/v4/core").$strict>>;
       unlimitedNotebaseNotes: import("zod").ZodBoolean;
       notebaseNoteLimit: import("zod").ZodNumber;
       notebaseNoteCount: import("zod").ZodNumber;
@@ -5081,23 +5387,27 @@ export declare const contract: {
       title: import("zod").ZodString;
       author: import("zod").ZodOptional<import("zod").ZodString>;
       language: import("zod").ZodOptional<import("zod").ZodString>;
-      coverContentType: import("zod").ZodOptional<import("zod").ZodEnum<{
-        "image/jpeg": "image/jpeg";
-        "image/png": "image/png";
-        "image/webp": "image/webp";
-      }>>;
+      fileByteSize: import("zod").ZodNumber;
+      cover: import("zod").ZodOptional<import("zod").ZodObject<{
+        contentType: import("zod").ZodEnum<{
+          "image/jpeg": "image/jpeg";
+          "image/png": "image/png";
+          "image/webp": "image/webp";
+        }>;
+        byteSize: import("zod").ZodNumber;
+      }, import("zod/v4/core").$strict>>;
     }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
       ebookId: import("zod").ZodUUID;
       upload: import("zod").ZodObject<{
         url: import("zod").ZodURL;
-        fields: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>;
+        headers: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>;
       }, import("zod/v4/core").$strict>;
       coverUpload: import("zod").ZodNullable<import("zod").ZodObject<{
         url: import("zod").ZodURL;
-        fields: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>;
+        headers: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>;
       }, import("zod/v4/core").$strict>>;
       expiresAt: import("zod").ZodCoercedDate<unknown>;
-    }, import("zod/v4/core").$strict>, import("@orpc/contract").MergedErrorMap<Record<never, never>, Pick<import("@orpc/contract").ErrorMap, "EBOOK_BETA_RESTRICTED" | "EBOOK_LIMIT_EXCEEDED">>, Record<never, never>>;
+    }, import("zod/v4/core").$strict>, import("@orpc/contract").MergedErrorMap<Record<never, never>, Pick<import("@orpc/contract").ErrorMap, "EBOOK_BETA_RESTRICTED" | "EBOOK_FILE_TOO_LARGE" | "EBOOK_LIMIT_EXCEEDED">>, Record<never, never>>;
     finalizeUpload: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
       ebookId: import("zod").ZodUUID;
     }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
@@ -5159,6 +5469,122 @@ export declare const contract: {
       id: import("zod").ZodUUID;
     }, import("zod/v4/core").$strict>, import("@orpc/contract").MergedErrorMap<Record<never, never>, Pick<import("@orpc/contract").ErrorMap, "EBOOK_BETA_RESTRICTED" | "EBOOK_NOT_FOUND">>, Record<never, never>>;
   };
+  emailPreferences: {
+    get: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
+      locale: import("zod").ZodEnum<{
+        en: "en";
+        es: "es";
+        ja: "ja";
+        ko: "ko";
+        ru: "ru";
+        tr: "tr";
+        vi: "vi";
+        zh: "zh";
+        "zh-TW": "zh-TW";
+      }>;
+    }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
+      categories: import("zod").ZodArray<import("zod").ZodObject<{
+        key: import("zod").ZodString;
+        name: import("zod").ZodString;
+        description: import("zod").ZodNullable<import("zod").ZodString>;
+        commercial: import("zod").ZodBoolean;
+        required: import("zod").ZodBoolean;
+        subscribed: import("zod").ZodBoolean;
+      }, import("zod/v4/core").$strict>>;
+      unsubscribedAll: import("zod").ZodBoolean;
+    }, import("zod/v4/core").$strict>, Record<never, never>, Record<never, never>>;
+    update: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
+      categories: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodBoolean>>;
+      unsubscribedAll: import("zod").ZodOptional<import("zod").ZodBoolean>;
+      locale: import("zod").ZodEnum<{
+        en: "en";
+        es: "es";
+        ja: "ja";
+        ko: "ko";
+        ru: "ru";
+        tr: "tr";
+        vi: "vi";
+        zh: "zh";
+        "zh-TW": "zh-TW";
+      }>;
+    }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
+      categories: import("zod").ZodArray<import("zod").ZodObject<{
+        key: import("zod").ZodString;
+        name: import("zod").ZodString;
+        description: import("zod").ZodNullable<import("zod").ZodString>;
+        commercial: import("zod").ZodBoolean;
+        required: import("zod").ZodBoolean;
+        subscribed: import("zod").ZodBoolean;
+      }, import("zod/v4/core").$strict>>;
+      unsubscribedAll: import("zod").ZodBoolean;
+    }, import("zod/v4/core").$strict>, Record<never, never>, Record<never, never>>;
+    getByToken: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
+      token: import("zod").ZodString;
+      locale: import("zod").ZodEnum<{
+        en: "en";
+        es: "es";
+        ja: "ja";
+        ko: "ko";
+        ru: "ru";
+        tr: "tr";
+        vi: "vi";
+        zh: "zh";
+        "zh-TW": "zh-TW";
+      }>;
+    }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
+      categories: import("zod").ZodArray<import("zod").ZodObject<{
+        key: import("zod").ZodString;
+        name: import("zod").ZodString;
+        description: import("zod").ZodNullable<import("zod").ZodString>;
+        commercial: import("zod").ZodBoolean;
+        required: import("zod").ZodBoolean;
+        subscribed: import("zod").ZodBoolean;
+      }, import("zod/v4/core").$strict>>;
+      unsubscribedAll: import("zod").ZodBoolean;
+      maskedEmail: import("zod").ZodString;
+      highlightCategory: import("zod").ZodNullable<import("zod").ZodString>;
+    }, import("zod/v4/core").$strict>, import("@orpc/contract").MergedErrorMap<Record<never, never>, Pick<import("@orpc/contract").ErrorMap, "EMAIL_LINK_INVALID">>, Record<never, never>>;
+    updateByToken: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
+      categories: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodBoolean>>;
+      unsubscribedAll: import("zod").ZodOptional<import("zod").ZodBoolean>;
+      token: import("zod").ZodString;
+      locale: import("zod").ZodEnum<{
+        en: "en";
+        es: "es";
+        ja: "ja";
+        ko: "ko";
+        ru: "ru";
+        tr: "tr";
+        vi: "vi";
+        zh: "zh";
+        "zh-TW": "zh-TW";
+      }>;
+    }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
+      categories: import("zod").ZodArray<import("zod").ZodObject<{
+        key: import("zod").ZodString;
+        name: import("zod").ZodString;
+        description: import("zod").ZodNullable<import("zod").ZodString>;
+        commercial: import("zod").ZodBoolean;
+        required: import("zod").ZodBoolean;
+        subscribed: import("zod").ZodBoolean;
+      }, import("zod/v4/core").$strict>>;
+      unsubscribedAll: import("zod").ZodBoolean;
+      maskedEmail: import("zod").ZodString;
+      highlightCategory: import("zod").ZodNullable<import("zod").ZodString>;
+    }, import("zod/v4/core").$strict>, import("@orpc/contract").MergedErrorMap<Record<never, never>, Pick<import("@orpc/contract").ErrorMap, "EMAIL_LINK_INVALID">>, Record<never, never>>;
+  };
+  featureAccess: {
+    status: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
+      featureKey: import("zod").ZodEnum<{
+        ebook: "ebook";
+      }>;
+    }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
+      featureKey: import("zod").ZodEnum<{
+        ebook: "ebook";
+      }>;
+      allowed: import("zod").ZodBoolean;
+    }, import("zod/v4/core").$strip>, Record<never, never>, Record<never, never>>;
+  };
   hostedAi: {
     status: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
       credits: import("zod").ZodArray<import("zod").ZodObject<{
@@ -5178,6 +5604,36 @@ export declare const contract: {
           videoSubtitles: "videoSubtitles";
         }>>;
       }, import("zod/v4/core").$strict>>;
+      pools: import("zod").ZodArray<import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
+        periodKind: import("zod").ZodEnum<{
+          daily: "daily";
+          weekly: "weekly";
+        }>;
+        usedPercent: import("zod").ZodNumber;
+        resetAt: import("zod").ZodNullable<import("zod").ZodISODateTime>;
+        features: import("zod").ZodArray<import("zod").ZodEnum<{
+          customAction: "customAction";
+          inputTranslation: "inputTranslation";
+          languageDetection: "languageDetection";
+          noteSuggestion: "noteSuggestion";
+          pageTranslation: "pageTranslation";
+          selectionTranslation: "selectionTranslation";
+          videoSubtitles: "videoSubtitles";
+        }>>;
+      }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
+        periodKind: import("zod").ZodLiteral<"once">;
+        usedPercent: import("zod").ZodNumber;
+        expiresAt: import("zod").ZodISODateTime;
+        features: import("zod").ZodArray<import("zod").ZodEnum<{
+          customAction: "customAction";
+          inputTranslation: "inputTranslation";
+          languageDetection: "languageDetection";
+          noteSuggestion: "noteSuggestion";
+          pageTranslation: "pageTranslation";
+          selectionTranslation: "selectionTranslation";
+          videoSubtitles: "videoSubtitles";
+        }>>;
+      }, import("zod/v4/core").$strict>], "periodKind">>;
       features: import("zod").ZodObject<{
         pageTranslation: import("zod").ZodObject<{
           normal: import("zod").ZodObject<{
@@ -5580,6 +6036,7 @@ export declare const contract: {
         "FSRS-6": "FSRS-6";
         "FSRS-7": "FSRS-7";
       }>;
+      srsSleepingAt: import("zod").ZodNullable<import("zod").ZodDate>;
       createdAt: import("zod").ZodCoercedDate<unknown>;
       updatedAt: import("zod").ZodCoercedDate<unknown>;
       notebaseColumns: import("zod").ZodArray<import("zod").ZodObject<{
@@ -5748,6 +6205,7 @@ export declare const contract: {
           "FSRS-6": "FSRS-6";
           "FSRS-7": "FSRS-7";
         }>;
+        srsSleepingAt: import("zod").ZodNullable<import("zod").ZodDate>;
         createdAt: import("zod").ZodDate;
         updatedAt: import("zod").ZodDate;
       }, import("zod/v4/core").$strip>;
@@ -5781,6 +6239,7 @@ export declare const contract: {
           "FSRS-6": "FSRS-6";
           "FSRS-7": "FSRS-7";
         }>;
+        srsSleepingAt: import("zod").ZodNullable<import("zod").ZodDate>;
         createdAt: import("zod").ZodDate;
         updatedAt: import("zod").ZodDate;
       }, import("zod/v4/core").$strip>;
@@ -5789,6 +6248,15 @@ export declare const contract: {
       summary: string;
       description: string;
     } & Record<never, never>>;
+    setSleep: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
+      id: import("zod").ZodUUID;
+      enabled: import("zod").ZodBoolean;
+    }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
+      txid: import("zod").ZodNullable<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, Pick<import("@orpc/contract").ErrorMap, "NOTEBASE_NOT_FOUND">>, {
+      summary: string;
+      description: string;
+    } & Record<never, never>>;
     delete: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
       id: import("zod").ZodUUID;
     }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
@@ -7209,12 +7677,15 @@ export declare const contract: {
         zyb: "zyb";
       }>>;
       voice: import("zod").ZodOptional<import("zod").ZodString>;
-    }, import("zod/v4/core").$strict>, import("zod").ZodFile, Record<never, never>, Record<never, never>>;
+    }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
+      url: import("zod").ZodURL;
+      expiresAt: import("zod").ZodCoercedDate<unknown>;
+    }, import("zod/v4/core").$strict>, Record<never, never>, Record<never, never>>;
   };
   srs: {
     scheduleStatusStats: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
       notebaseIds: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodUUID>>;
-      timezone: import("zod").ZodString;
+      timezone: import("zod").ZodPipe<import("zod").ZodString, import("zod").ZodTransform<string, string>>;
     }, import("zod/v4/core").$strict>, import("zod").ZodRecord<import("zod").ZodUUID, import("zod").ZodRecord<import("zod").ZodEnum<{
       learning: "learning";
       new: "new";
@@ -7224,7 +7695,7 @@ export declare const contract: {
       description: string;
     } & Record<never, never>>;
     recentNotebaseScheduleStatusStats: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
-      timezone: import("zod").ZodString;
+      timezone: import("zod").ZodPipe<import("zod").ZodString, import("zod").ZodTransform<string, string>>;
     }, import("zod/v4/core").$strict>, import("zod").ZodNullable<import("zod").ZodObject<{
       notebase: import("zod").ZodObject<{
         id: import("zod").ZodString;
@@ -7303,7 +7774,7 @@ export declare const contract: {
         hard: "hard";
       }>;
       durationMs: import("zod").ZodNumber;
-      timezone: import("zod").ZodString;
+      timezone: import("zod").ZodPipe<import("zod").ZodString, import("zod").ZodTransform<string, string>>;
     }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
       card: import("zod").ZodObject<{
         notebaseId: import("zod").ZodUUID;
@@ -7461,7 +7932,7 @@ export declare const contract: {
       notebaseIds: import("zod").ZodOptional<import("zod").ZodPipe<import("zod").ZodArray<import("zod").ZodUUID>, import("zod").ZodTransform<string[], string[]>>>;
       from: import("zod").ZodOptional<import("zod").ZodISODate>;
       to: import("zod").ZodISODate;
-      timezone: import("zod").ZodString;
+      timezone: import("zod").ZodPipe<import("zod").ZodString, import("zod").ZodTransform<string, string>>;
     }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
       srs: import("zod").ZodObject<{
         learnedCards: import("zod").ZodNumber;
@@ -7482,7 +7953,7 @@ export declare const contract: {
       notebaseIds: import("zod").ZodOptional<import("zod").ZodPipe<import("zod").ZodArray<import("zod").ZodUUID>, import("zod").ZodTransform<string[], string[]>>>;
       from: import("zod").ZodOptional<import("zod").ZodISODate>;
       to: import("zod").ZodISODate;
-      timezone: import("zod").ZodString;
+      timezone: import("zod").ZodPipe<import("zod").ZodString, import("zod").ZodTransform<string, string>>;
     }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
       baseTotal: import("zod").ZodNumber;
       daily: import("zod").ZodArray<import("zod").ZodObject<{
@@ -7494,7 +7965,7 @@ export declare const contract: {
       notebaseIds: import("zod").ZodOptional<import("zod").ZodPipe<import("zod").ZodArray<import("zod").ZodUUID>, import("zod").ZodTransform<string[], string[]>>>;
       from: import("zod").ZodOptional<import("zod").ZodISODate>;
       to: import("zod").ZodISODate;
-      timezone: import("zod").ZodString;
+      timezone: import("zod").ZodPipe<import("zod").ZodString, import("zod").ZodTransform<string, string>>;
     }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
       baseTotal: import("zod").ZodNumber;
       daily: import("zod").ZodArray<import("zod").ZodObject<{
@@ -7515,6 +7986,57 @@ export declare const contract: {
     }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
       timezone: import("zod").ZodString;
     }, import("zod/v4/core").$strict>, Record<never, never>, Record<never, never>>;
+    ensureLocale: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
+      locale: import("zod").ZodEnum<{
+        en: "en";
+        es: "es";
+        ja: "ja";
+        ko: "ko";
+        ru: "ru";
+        tr: "tr";
+        vi: "vi";
+        zh: "zh";
+        "zh-TW": "zh-TW";
+      }>;
+    }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
+      locale: import("zod").ZodEnum<{
+        en: "en";
+        es: "es";
+        ja: "ja";
+        ko: "ko";
+        ru: "ru";
+        tr: "tr";
+        vi: "vi";
+        zh: "zh";
+        "zh-TW": "zh-TW";
+      }>;
+      updated: import("zod").ZodBoolean;
+    }, import("zod/v4/core").$strict>, Record<never, never>, Record<never, never>>;
+    updateLocale: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
+      locale: import("zod").ZodEnum<{
+        en: "en";
+        es: "es";
+        ja: "ja";
+        ko: "ko";
+        ru: "ru";
+        tr: "tr";
+        vi: "vi";
+        zh: "zh";
+        "zh-TW": "zh-TW";
+      }>;
+    }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
+      locale: import("zod").ZodEnum<{
+        en: "en";
+        es: "es";
+        ja: "ja";
+        ko: "ko";
+        ru: "ru";
+        tr: "tr";
+        vi: "vi";
+        zh: "zh";
+        "zh-TW": "zh-TW";
+      }>;
+    }, import("zod/v4/core").$strict>, Record<never, never>, Record<never, never>>;
   };
   videoTranscript: {
     create: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{