@read-frog/api-contract 0.21.1 → 0.22.0

package/dist/index.js

@@ -1,22 +1,6 @@
 import { eventIterator, oc } from "@orpc/contract";
-import { BETA_FEATURE_KEYS, EBOOK_ALLOWED_COVER_CONTENT_TYPES, NOTEBASE_COLUMN_MAX_WIDTH, NOTEBASE_COLUMN_MIN_WIDTH, SRS_REVIEW_DURATION_MS_MAX, activeScheduleStatusSchema, cardIdentityShape, cardMemoryStateShape, cardStateSchema, cardStateSchema as cardStateSchema$1, cardTemplateConfigSchema, cardTemplateCreatedBySchema, fsrsMemoryStateSchema, fsrsReviewLogSnapshotSchema, getVideoIdFromUrl, langCodeISO6393Schema, notebaseColumnConfigSchema, reviewRatingSchema, scheduleStatusSchema, scheduleStatusSchema as scheduleStatusSchema$1, schedulingParamsSchema, schedulingParamsShape, srsModelVersionSchema, srsStepSchema, srsWeightsSchema, transcriptSegmentSchema } from "@read-frog/definitions";
 import { z } from "zod";
-//#region src/schemas/beta-access.ts
-const BetaFeatureKeySchema = z.enum(BETA_FEATURE_KEYS);
-const BetaAccessStatusInputSchema = z.object({ featureKey: BetaFeatureKeySchema }).strict();
-const BetaAccessStatusOutputSchema = z.object({
-	featureKey: BetaFeatureKeySchema,
-	allowed: z.boolean()
-});
-//#endregion
-//#region src/contracts/beta-access.ts
-const betaAccessContract = { status: oc.route({
-	method: "GET",
-	path: "/beta-access/status",
-	summary: "Get beta access status for a feature",
-	tags: ["Beta Access"]
-}).input(BetaAccessStatusInputSchema).output(BetaAccessStatusOutputSchema) };
-//#endregion
+import { EBOOK_ALLOWED_COVER_CONTENT_TYPES, GATED_FEATURE_KEYS, NOTEBASE_COLUMN_MAX_WIDTH, NOTEBASE_COLUMN_MIN_WIDTH, SRS_REVIEW_DURATION_MS_MAX, activeScheduleStatusSchema, canonicalTimeZone, cardIdentityShape, cardMemoryStateShape, cardStateSchema, cardStateSchema as cardStateSchema$1, cardTemplateConfigSchema, cardTemplateCreatedBySchema, fsrsMemoryStateSchema, fsrsReviewLogSnapshotSchema, getVideoIdFromUrl, langCodeISO6393Schema, notebaseColumnConfigSchema, reviewRatingSchema, scheduleStatusSchema, scheduleStatusSchema as scheduleStatusSchema$1, schedulingParamsSchema, schedulingParamsShape, srsModelVersionSchema, srsStepSchema, srsWeightsSchema, transcriptSegmentSchema } from "@read-frog/definitions";
 //#region src/schemas/hosted-ai.ts
 const HostedAiOutputFieldTypeSchema = z.enum(["string", "number"]);
 const HostedAiOutputFieldSchema = z.strictObject({
@@ -184,13 +168,16 @@ const HostedAiRateLimitErrorDataSchema = z.object({
 	quotaScope: HostedAiQuotaScopeSchema
 });
 /**
+* 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.
 */
-const HostedAiCreditStatusSchema = z.strictObject({
+const HostedAiRecurringCreditStatusSchema = z.strictObject({
 	periodKind: HostedAiCreditPeriodKindSchema,
 	usedPercent: z.number().min(0).max(100),
 	resetAt: z.iso.datetime().nullable(),
@@ -201,6 +188,25 @@ const HostedAiCreditStatusSchema = z.strictObject({
 	*/
 	features: z.array(HostedAiFeatureSchema).min(1)
 });
+/**
+* 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.
+*/
+const HostedAiOneTimeCreditStatusSchema = z.strictObject({
+	periodKind: z.literal("once"),
+	usedPercent: z.number().min(0).max(100),
+	expiresAt: z.iso.datetime(),
+	features: z.array(HostedAiFeatureSchema).min(1)
+});
+/**
+* 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.
+*/
+const HostedAiCreditPoolStatusSchema = z.discriminatedUnion("periodKind", [HostedAiRecurringCreditStatusSchema, HostedAiOneTimeCreditStatusSchema]);
 const HostedAiTierStatusSchema = z.strictObject({
 	accessAllowed: z.boolean(),
 	available: z.boolean(),
@@ -219,7 +225,21 @@ const HostedAiFeatureStatusSchema = z.strictObject({
 	advance: HostedAiTierStatusSchema
 });
 const HostedAiStatusOutputSchema = z.strictObject({
-	credits: z.array(HostedAiCreditStatusSchema),
+	/**
+	* @deprecated Read `pools`. This lists the recurring pools only, never a
+	* one-time one: extensions released before mengxi-ream/read-frog#2395 look
+	* up a label for every entry's `periodKind`, and one they do not know
+	* crashes their usage page. They also throw if the field is missing.
+	*
+	* TODO(2026-11-07): remove once those extensions have drained (#710).
+	*/
+	credits: z.array(HostedAiRecurringCreditStatusSchema),
+	/**
+	* Everything that can pay for a feature, in the order the server draws on it:
+	* the plan's recurring pools first, then one-time pools by soonest expiry. A
+	* feature can appear in several entries.
+	*/
+	pools: z.array(HostedAiCreditPoolStatusSchema),
 	features: z.strictObject({
 		pageTranslation: HostedAiFeatureStatusSchema,
 		customAction: HostedAiFeatureStatusSchema,
@@ -297,18 +317,10 @@ const PUBLIC_APP_ERROR_DEFS = {
 		message: "Built-in AI credit exhausted",
 		status: 429
 	},
-	NOTEBASE_BETA_RESTRICTED: {
-		message: "Notebase is currently in beta for selected accounts",
-		status: 403
-	},
 	NOTEBASE_NOT_FOUND: {
 		message: "Notebase not found",
 		status: 404
 	},
-	VIDEO_TRANSCRIPTION_BETA_RESTRICTED: {
-		message: "Video transcription is currently in beta for selected accounts",
-		status: 403
-	},
 	VIDEO_TRANSCRIPTION_SUBSCRIPTION_REQUIRED: {
 		message: "AI subtitles require a Pro or Ultra subscription",
 		status: 403
@@ -461,6 +473,10 @@ const PUBLIC_APP_ERROR_DEFS = {
 	EBOOK_UPLOAD_NOT_COMPLETED: {
 		message: "Ebook upload has not been completed",
 		status: 409
+	},
+	EMAIL_LINK_INVALID: {
+		message: "This email link is not valid",
+		status: 400
 	}
 };
 function isPublicAppErrorCode(code) {
@@ -484,6 +500,24 @@ function pickPublicErrorMap(...codes) {
 	}));
 }
 //#endregion
+//#region src/schemas/app-locale.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`.
+*/
+const appLocaleSchema = z.enum([
+	"en",
+	"es",
+	"ja",
+	"ko",
+	"ru",
+	"tr",
+	"vi",
+	"zh",
+	"zh-TW"
+]);
+//#endregion
 //#region src/schemas/billing.ts
 const billingIntervalSchema = z.enum(["month", "year"]);
 const billingSubscriptionStatusSchema = z.enum([
@@ -502,52 +536,55 @@ const billingPlanSchema = z.enum([
 	"ultra"
 ]);
 /**
-* Whether a plan may use a feature, given the plans that feature allows.
-*
-* 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`.
-*/
-function isPlanAllowed(plan, allowed) {
-	return allowed.includes(plan);
-}
-/**
-* Plans that may use the remote MCP server.
+* 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.
 *
-* 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.
+* Read by the MCP server's gate AND by the website's copy, so the pages cannot
+* promise calls the server refuses.
 *
-* 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.
 */
-const MCP_ALLOWED_PLANS = ["ultra"];
+const MCP_DAILY_CALL_LIMITS = {
+	free: 10,
+	pro: 50,
+	ultra: null
+};
 const billingCheckoutPlanSchema = z.enum(["pro", "ultra"]);
 const billingCurrencySchema = z.enum([
 	"usd",
 	"cad",
 	"cny"
 ]);
-const billingLocaleSchema = z.enum([
-	"en",
-	"es",
-	"ja",
-	"ko",
-	"ru",
-	"tr",
-	"vi",
-	"zh",
-	"zh-TW"
-]);
+const billingLocaleSchema = appLocaleSchema;
 const billingAccessSourceSchema = z.enum(["subscription", "pass"]);
 const billingScheduledChangeSchema = z.object({
 	plan: billingCheckoutPlanSchema,
 	interval: billingIntervalSchema,
 	effectiveAt: z.coerce.date()
 }).strict();
+/**
+* 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.
+*/
+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.
+*/
+const billingPaymentDueSchema = z.object({
+	/** The last instant of the plan; show it in BILLING_PAYMENT_DUE_TIME_ZONE. */
+	dueBy: z.coerce.date(),
+	/**
+	* The plan the payment keeps. Not `BillingStatus.plan`: past `dueBy` that
+	* already reads "free" while the invoice is still payable.
+	*/
+	plan: billingCheckoutPlanSchema,
+	/** The Stripe-hosted page that pays the invoice; null if Stripe gave none. */
+	url: z.url().nullable()
+}).strict();
 const billingStatusSchema = z.object({
 	plan: billingPlanSchema,
 	status: billingSubscriptionStatusSchema.nullable(),
@@ -562,6 +599,7 @@ const billingStatusSchema = z.object({
 	cancelAt: z.coerce.date().nullable(),
 	accessSource: billingAccessSourceSchema.nullable(),
 	scheduledChange: billingScheduledChangeSchema.nullable(),
+	paymentDue: billingPaymentDueSchema.nullable(),
 	unlimitedNotebaseNotes: z.boolean(),
 	notebaseNoteLimit: z.number().int().positive(),
 	notebaseNoteCount: z.number().int().min(0)
@@ -569,10 +607,10 @@ const billingStatusSchema = z.object({
 const billingCreateCheckoutSessionInputSchema = z.object({
 	currency: billingCurrencySchema,
 	interval: billingIntervalSchema,
-	locale: billingLocaleSchema,
+	locale: appLocaleSchema,
 	plan: billingCheckoutPlanSchema.default("pro")
 }).strict();
-const billingCreateCustomerPortalSessionInputSchema = z.object({ locale: billingLocaleSchema }).strict();
+const billingCreateCustomerPortalSessionInputSchema = z.object({ locale: appLocaleSchema }).strict();
 const billingSessionUrlOutputSchema = z.object({ url: z.url() }).strict();
 const billingCancelScheduledChangeOutputSchema = z.object({ success: z.literal(true) }).strict();
 //#endregion
@@ -797,20 +835,24 @@ const ebookRequestUploadInputSchema = z.object({
 	title: z.string().min(1).max(500),
 	author: z.string().max(500).optional(),
 	language: z.string().max(35).optional(),
-	coverContentType: ebookCoverContentTypeSchema.optional()
+	fileByteSize: z.number().int().min(1),
+	cover: z.object({
+		contentType: ebookCoverContentTypeSchema,
+		byteSize: z.number().int().min(1)
+	}).strict().optional()
 }).strict();
 /**
-* 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.
 */
-const ebookPresignedPostSchema = z.object({
+const ebookPresignedUploadSchema = z.object({
 	url: z.url(),
-	fields: z.record(z.string(), z.string())
+	headers: z.record(z.string(), z.string())
 }).strict();
 const ebookRequestUploadOutputSchema = z.object({
 	ebookId: z.uuid(),
-	upload: ebookPresignedPostSchema,
-	coverUpload: ebookPresignedPostSchema.nullable(),
+	upload: ebookPresignedUploadSchema,
+	coverUpload: ebookPresignedUploadSchema.nullable(),
 	expiresAt: z.coerce.date()
 }).strict();
 const ebookFinalizeUploadInputSchema = z.object({ ebookId: z.uuid() }).strict();
@@ -850,7 +892,7 @@ const ebookContract = {
 		summary: "Get an ebook with reading progress",
 		tags: ["Ebooks"]
 	}).input(ebookGetInputSchema).output(ebookGetOutputSchema),
-	requestUpload: ebookProcedure.errors(pickPublicErrorMap("EBOOK_BETA_RESTRICTED", "EBOOK_LIMIT_EXCEEDED")).route({
+	requestUpload: ebookProcedure.errors(pickPublicErrorMap("EBOOK_BETA_RESTRICTED", "EBOOK_LIMIT_EXCEEDED", "EBOOK_FILE_TOO_LARGE")).route({
 		method: "POST",
 		path: "/ebooks/uploads",
 		summary: "Request presigned upload URLs for a new ebook",
@@ -888,6 +930,95 @@ const ebookContract = {
 	}).input(ebookDeleteInputSchema).output(ebookDeleteOutputSchema)
 };
 //#endregion
+//#region src/schemas/email-preferences.ts
+/** A category's key, such as `promotions`. */
+const emailCategoryKeySchema = z.string().max(64).regex(/^[a-z][a-z0-9_]*$/);
+/** The token in an email's unsubscribe link. */
+const emailLinkTokenSchema = z.string().min(1).max(1024);
+const emailCategoryStateSchema = z.object({
+	key: z.string(),
+	name: z.string(),
+	description: z.string().nullable(),
+	commercial: z.boolean(),
+	required: z.boolean(),
+	subscribed: z.boolean()
+}).strict();
+const emailPreferencesStateSchema = z.object({
+	categories: z.array(emailCategoryStateSchema),
+	unsubscribedAll: z.boolean()
+}).strict();
+/**
+* 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.
+*/
+const emailPreferencesByTokenStateSchema = z.object({
+	...emailPreferencesStateSchema.shape,
+	maskedEmail: z.string(),
+	highlightCategory: z.string().nullable()
+}).strict();
+const emailPreferencesChangesShape = {
+	categories: z.record(emailCategoryKeySchema, z.boolean()).optional(),
+	unsubscribedAll: z.boolean().optional()
+};
+const emailPreferencesGetInputSchema = z.object({ locale: appLocaleSchema }).strict();
+const emailPreferencesUpdateInputSchema = z.object({
+	locale: appLocaleSchema,
+	...emailPreferencesChangesShape
+}).strict();
+const emailPreferencesGetByTokenInputSchema = z.object({
+	token: emailLinkTokenSchema,
+	locale: appLocaleSchema
+}).strict();
+const emailPreferencesUpdateByTokenInputSchema = z.object({
+	token: emailLinkTokenSchema,
+	locale: appLocaleSchema,
+	...emailPreferencesChangesShape
+}).strict();
+//#endregion
+//#region src/contracts/email-preferences.ts
+const emailPreferencesContract = {
+	get: oc.route({
+		method: "GET",
+		path: "/users/me/email-preferences",
+		summary: "Get which emails the authenticated user receives",
+		tags: ["Email preferences"]
+	}).input(emailPreferencesGetInputSchema).output(emailPreferencesStateSchema),
+	update: oc.route({
+		method: "PATCH",
+		path: "/users/me/email-preferences",
+		summary: "Change which emails the authenticated user receives",
+		tags: ["Email preferences"]
+	}).input(emailPreferencesUpdateInputSchema).output(emailPreferencesStateSchema),
+	getByToken: oc.route({
+		method: "POST",
+		path: "/email-preferences/by-token",
+		summary: "Get the email preferences an email link is for",
+		tags: ["Email preferences"]
+	}).errors(pickPublicErrorMap("EMAIL_LINK_INVALID")).input(emailPreferencesGetByTokenInputSchema).output(emailPreferencesByTokenStateSchema),
+	updateByToken: oc.route({
+		method: "POST",
+		path: "/email-preferences/by-token/update",
+		summary: "Change the email preferences an email link is for",
+		tags: ["Email preferences"]
+	}).errors(pickPublicErrorMap("EMAIL_LINK_INVALID")).input(emailPreferencesUpdateByTokenInputSchema).output(emailPreferencesByTokenStateSchema)
+};
+//#endregion
+//#region src/schemas/feature-access.ts
+const GatedFeatureKeySchema = z.enum(GATED_FEATURE_KEYS);
+const FeatureAccessStatusInputSchema = z.object({ featureKey: GatedFeatureKeySchema }).strict();
+const FeatureAccessStatusOutputSchema = z.object({
+	featureKey: GatedFeatureKeySchema,
+	allowed: z.boolean()
+});
+//#endregion
+//#region src/contracts/feature-access.ts
+const featureAccessContract = { status: oc.route({
+	method: "GET",
+	path: "/feature-access/status",
+	summary: "Get whether the caller can use a gated feature",
+	tags: ["Feature Access"]
+}).input(FeatureAccessStatusInputSchema).output(FeatureAccessStatusOutputSchema) };
+//#endregion
 //#region src/contracts/hosted-ai.ts
 const hostedAiStreamErrors = pickPublicErrorMap("HOSTED_AI_TIER_RESTRICTED", "HOSTED_AI_QUOTA_EXHAUSTED");
 const hostedAiContract = {
@@ -1265,6 +1396,7 @@ const notebaseSchema = z.object({
 	srsEnableFuzz: schedulingParamsShape.enableFuzz,
 	srsWeights: srsWeightsSchema.nullable(),
 	srsModelVersion: srsModelVersionSchema,
+	srsSleepingAt: z.date().nullable(),
 	createdAt: z.date(),
 	updatedAt: z.date()
 });
@@ -1325,6 +1457,11 @@ const NotebaseUpdateOutputSchema = z.object({
 	notebase: notebaseSchema,
 	txid: z.number()
 });
+const NotebaseSetSleepInputSchema = z.object({
+	id: z.uuid(),
+	enabled: z.boolean()
+}).strict();
+const NotebaseSetSleepOutputSchema = z.object({ txid: z.number().nullable() });
 const NotebaseDeleteInputSchema = z.object({ id: z.uuid() });
 const NotebaseDeleteOutputSchema = deletionResultSchema;
 const NotebaseGetInputSchema = z.object({ id: z.uuid() });
@@ -1393,6 +1530,13 @@ const notebaseContract = {
 		description: "Update the supplied name or public study settings of an owned notebase, preserving omitted properties.",
 		tags: ["Notebases"]
 	}).errors(pickPublicErrorMap("NOTEBASE_NOT_FOUND")).input(NotebaseUpdateInputSchema).output(NotebaseUpdateOutputSchema),
+	setSleep: defineAgentProcedure({
+		method: "POST",
+		path: "/notebases/{id}/sleep",
+		summary: "Set notebase sleep",
+		description: "Put an owned notebase to sleep (enabled=true) or wake it (enabled=false). A sleeping notebase is left out of the combined review; its cards, memory states and review history are unchanged and it can still be reviewed directly. A request matching the current state succeeds without a change.",
+		tags: ["Notebases"]
+	}).errors(pickPublicErrorMap("NOTEBASE_NOT_FOUND")).input(NotebaseSetSleepInputSchema).output(NotebaseSetSleepOutputSchema),
 	delete: defineAgentProcedure({
 		method: "DELETE",
 		path: "/notebases/{id}",
@@ -1565,8 +1709,14 @@ const speechSynthesizeInputSchema = z.object({
 	language: langCodeISO6393Schema.optional(),
 	voice: speechVoiceNameSchema.optional()
 }).strict();
-/** The audio, as an MP3 file. */
-const speechSynthesizeOutputSchema = z.file();
+/**
+* Where to download the audio, an MP3: a link to fetch at once, which stops
+* working at `expiresAt`.
+*/
+const speechSynthesizeOutputSchema = z.object({
+	url: z.url(),
+	expiresAt: z.coerce.date()
+}).strict();
 //#endregion
 //#region src/contracts/speech.ts
 const speechContract = {
@@ -1591,7 +1741,7 @@ const speechContract = {
 	synthesize: oc.route({
 		method: "POST",
 		path: "/speech/synthesize",
-		summary: "Read a text aloud, as MP3 audio",
+		summary: "Read a text aloud, and link to its MP3 audio",
 		tags: ["Speech"]
 	}).input(speechSynthesizeInputSchema).output(speechSynthesizeOutputSchema)
 };
@@ -1621,6 +1771,24 @@ const timezoneSchema = z.string().trim().min(1).refine((timezone) => {
 		return false;
 	}
 }, "Invalid timezone");
+/**
+* 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.
+*/
+const canonicalTimezoneSchema = timezoneSchema.transform((timezone, ctx) => {
+	const name = canonicalTimeZone(timezone);
+	if (!name) {
+		ctx.addIssue({
+			code: "custom",
+			message: "Use an IANA time zone identifier instead of a fixed UTC offset. See https://www.iana.org/time-zones"
+		});
+		return z.NEVER;
+	}
+	return name;
+});
 //#endregion
 //#region src/schemas/srs.ts
 const stepSchema = srsStepSchema;
@@ -1635,7 +1803,7 @@ const srsReviewInputSchema = z.object({
 	id: z.uuid().optional(),
 	rating: reviewRatingSchema,
 	durationMs: z.number().int().min(0).max(SRS_REVIEW_DURATION_MS_MAX),
-	timezone: timezoneSchema
+	timezone: canonicalTimezoneSchema
 }).strict();
 const srsRollbackReviewInputSchema = z.object({
 	expectedReviewId: z.uuid().optional(),
@@ -1644,10 +1812,10 @@ const srsRollbackReviewInputSchema = z.object({
 const srsScheduleStatusStatsSchema = z.record(activeScheduleStatusSchema, z.number().int().min(0));
 const srsScheduleStatusStatsInputSchema = z.object({
 	notebaseIds: z.array(z.uuid()).optional(),
-	timezone: timezoneSchema
+	timezone: canonicalTimezoneSchema
 }).strict();
 const srsScheduleStatusStatsOutputSchema = z.record(z.uuid(), srsScheduleStatusStatsSchema);
-const srsRecentNotebaseScheduleStatusStatsInputSchema = z.object({ timezone: timezoneSchema }).strict();
+const srsRecentNotebaseScheduleStatusStatsInputSchema = z.object({ timezone: canonicalTimezoneSchema }).strict();
 /** Null when the user has no notebase yet. */
 const srsRecentNotebaseScheduleStatusStatsOutputSchema = z.object({
 	notebase: notebaseSummarySchema,
@@ -1848,7 +2016,7 @@ const statsInputSchema = z.object({
 	notebaseIds: statsNotebaseIdsSchema.optional(),
 	from: z.iso.date().optional(),
 	to: z.iso.date(),
-	timezone: timezoneSchema
+	timezone: canonicalTimezoneSchema
 }).strict().refine((input) => !input.from || input.from <= input.to, {
 	message: "from must be before or equal to to",
 	path: ["from"]
@@ -1888,6 +2056,13 @@ const userEnsureTimezoneOutputSchema = z.object({
 }).strict();
 const userUpdateTimezoneInputSchema = z.object({ timezone: timezoneSchema }).strict();
 const userUpdateTimezoneOutputSchema = z.object({ timezone: timezoneSchema }).strict();
+const userEnsureLocaleInputSchema = z.object({ locale: appLocaleSchema }).strict();
+const userEnsureLocaleOutputSchema = z.object({
+	locale: appLocaleSchema,
+	updated: z.boolean()
+}).strict();
+const userUpdateLocaleInputSchema = z.object({ locale: appLocaleSchema }).strict();
+const userUpdateLocaleOutputSchema = z.object({ locale: appLocaleSchema }).strict();
 //#endregion
 //#region src/contracts/user.ts
 const userContract = {
@@ -1902,7 +2077,19 @@ const userContract = {
 		path: "/users/me/timezone",
 		summary: "Update the authenticated user's timezone",
 		tags: ["Users"]
-	}).input(userUpdateTimezoneInputSchema).output(userUpdateTimezoneOutputSchema)
+	}).input(userUpdateTimezoneInputSchema).output(userUpdateTimezoneOutputSchema),
+	ensureLocale: oc.route({
+		method: "POST",
+		path: "/users/me/locale/ensure",
+		summary: "Ensure the authenticated user has a locale",
+		tags: ["Users"]
+	}).input(userEnsureLocaleInputSchema).output(userEnsureLocaleOutputSchema),
+	updateLocale: oc.route({
+		method: "PATCH",
+		path: "/users/me/locale",
+		summary: "Update the authenticated user's locale",
+		tags: ["Users"]
+	}).input(userUpdateLocaleInputSchema).output(userUpdateLocaleOutputSchema)
 };
 //#endregion
 //#region src/schemas/video-transcript.ts
@@ -1953,11 +2140,12 @@ const videoTranscriptUsageSchema = z.object({
 //#endregion
 //#region src/index.ts
 const contract = {
-	betaAccess: betaAccessContract,
 	billing: billingContract,
 	card: cardContract,
 	cardTemplate: cardTemplateContract,
 	ebook: ebookContract,
+	emailPreferences: emailPreferencesContract,
+	featureAccess: featureAccessContract,
 	hostedAi: hostedAiContract,
 	masteryGoal: masteryGoalContract,
 	mcpConnection: mcpConnectionContract,
@@ -1996,6 +2184,6 @@ const contract = {
 	}
 };
 //#endregion
-export { BetaAccessStatusInputSchema, BetaAccessStatusOutputSchema, BetaFeatureKeySchema, CardGenerateInputSchema, CardGenerateOutputSchema, CardGetInputSchema, CardGetOutputSchema, CardListInputSchema, CardListOutputSchema, CardTemplateCreateInputSchema, CardTemplateCreateOutputSchema, CardTemplateDeleteInputSchema, CardTemplateDeleteOutputSchema, CardTemplateGetInputSchema, CardTemplateGetOutputSchema, CardTemplateInvalidColumnsDataSchema, CardTemplateInvalidLayoutDataSchema, CardTemplateListInputSchema, CardTemplateListOutputSchema, CardTemplateNotebaseColumnInUseDataSchema, CardTemplateUpdateInputSchema, CardTemplateUpdateOutputSchema, CellValidationFailedDataSchema, CellValidationFailureDetailsSchema, CellValidationFailureReasonSchema, DEFAULT_SPEECH_PREFERENCES, HOSTED_AI_CLIENT_STREAM_PART_TYPES, HOSTED_AI_NOTE_SUGGESTION_MAX_NOTES, HOSTED_AI_NOTE_SUGGESTION_MAX_NOTE_FIELDS, HostedAiCreditPeriodKindSchema, HostedAiCreditPolicyIdSchema, HostedAiCreditStatusSchema, HostedAiFeatureSchema, HostedAiFeatureStatusSchema, HostedAiModelTierSchema, HostedAiNoteSuggestionObjectSchema, HostedAiNoteSuggestionStreamInputSchema, HostedAiOutputFieldSchema, HostedAiOutputFieldTypeSchema, HostedAiQuotaExhaustedDataSchema, HostedAiQuotaScopeSchema, HostedAiRateLimitErrorDataSchema, HostedAiRequestIdSchema, HostedAiStatusInputSchema, HostedAiStatusOutputSchema, HostedAiStreamPartSchema, HostedAiStreamStructuredObjectInputSchema, HostedAiStreamTextInputSchema, HostedAiTierRestrictedDataSchema, HostedAiTierStatusSchema, HostedAiUnavailableReasonSchema, MASTERY_GOAL_TARGET_MAX, MCP_ALLOWED_PLANS, NOTEBASE_ROW_CREATE_MANY_MAX_ROWS, NOTEBASE_ROW_DELETE_MANY_MAX_ROWS, NOTEBASE_ROW_UPDATE_MANY_MAX_ROWS, NotebaseColumnCreateInputSchema, NotebaseColumnCreateOutputSchema, NotebaseColumnDeleteInputSchema, NotebaseColumnDeleteOutputSchema, NotebaseColumnReorderInputSchema, NotebaseColumnReorderOutputSchema, NotebaseColumnUpdateInputSchema, NotebaseColumnUpdateOutputSchema, NotebaseCreateInputSchema, NotebaseCreateOutputSchema, NotebaseDeleteInputSchema, NotebaseDeleteOutputSchema, NotebaseGetInputSchema, NotebaseGetOutputSchema, NotebaseGetSchemaInputSchema, NotebaseGetSchemaOutputSchema, NotebaseGetSummaryInputSchema, NotebaseGetSummaryOutputSchema, NotebaseListInputSchema, NotebaseListItemSchema, NotebaseListOutputSchema, NotebaseRowCreateInputSchema, NotebaseRowCreateManyInputSchema, NotebaseRowCreateManyOutputSchema, NotebaseRowCreateOutputSchema, NotebaseRowDeleteInputSchema, NotebaseRowDeleteManyInputSchema, NotebaseRowDeleteManyOutputSchema, NotebaseRowDeleteOutputSchema, NotebaseRowGetInputSchema, NotebaseRowGetOutputSchema, NotebaseRowListInputSchema, NotebaseRowListOutputSchema, NotebaseRowReorderInputSchema, NotebaseRowReorderOutputSchema, NotebaseRowUpdateInputSchema, NotebaseRowUpdateManyInputSchema, NotebaseRowUpdateManyOutputSchema, NotebaseRowUpdateOutputSchema, NotebaseUpdateInputSchema, NotebaseUpdateOutputSchema, PUBLIC_APP_ERROR_DEFS, SPEECH_DAILY_REQUEST_LIMITS, SPEECH_RATE_MAX, SPEECH_RATE_MIN, SPEECH_TEXT_MAX_LENGTH, SRS_REVIEW_CLIENT_ID_NAMESPACE, SRS_REVIEW_DURATION_MS_MAX, SpeechDailyLimitReachedDataSchema, activityStatsOutputSchema, billingAccessSourceSchema, billingCancelScheduledChangeOutputSchema, billingCheckoutPlanSchema, billingCreateCheckoutSessionInputSchema, billingCreateCustomerPortalSessionInputSchema, billingCurrencySchema, billingIntervalSchema, billingLocaleSchema, billingPlanSchema, billingScheduledChangeSchema, billingSessionUrlOutputSchema, billingStatusSchema, billingSubscriptionStatusSchema, cardSchema, cardStateSchema, cardTemplateSchema, contract, createSrsReviewClientId, defineAgentProcedure, deletionResultSchema, ebookCoverContentTypeSchema, ebookDeleteInputSchema, ebookDeleteOutputSchema, ebookDetailSchema, ebookFinalizeUploadInputSchema, ebookFinalizeUploadOutputSchema, ebookGetDownloadUrlInputSchema, ebookGetDownloadUrlOutputSchema, ebookGetInputSchema, ebookGetOutputSchema, ebookListInputSchema, ebookListItemSchema, ebookListOutputSchema, ebookPresignedPostSchema, ebookQuotaSchema, ebookRenameDataSchema, ebookRenameInputSchema, ebookRenameOutputSchema, ebookRequestUploadInputSchema, ebookRequestUploadOutputSchema, ebookStatusSchema, ebookUpdateProgressDataSchema, ebookUpdateProgressInputSchema, ebookUpdateProgressOutputSchema, expectedUpdatedAtSchema, getPublicErrorDefinition, isPlanAllowed, isPublicAppErrorCode, masteryGoalOutputSchema, masteryGoalTargetSchema, masteryGoalUpdateInputSchema, mcpConnectionListOutputSchema, mcpConnectionRevokeInputSchema, mcpConnectionRevokeOutputSchema, mcpConnectionSchema, notebaseActivityStatsItemSchema, notebaseActivityStatsOutputSchema, notebaseColumnCreateDataSchema, notebaseColumnSchema, notebaseColumnUpdateDataSchema, notebaseColumnWidthSchema, notebaseCreateDataSchema, notebaseRowCellsSchema, notebaseRowCreateDataSchema, notebaseRowGrowthStatsItemSchema, notebaseRowGrowthStatsOutputSchema, notebaseRowSchema, notebaseRowUpdateDataSchema, notebaseSchema, notebaseSummarySchema, notebaseUpdateDataSchema, notebaseViewConfigSchema, notebaseViewCreateDataSchema, notebaseViewFilterSchema, notebaseViewFiltersSchema, notebaseViewSchema, notebaseViewSortSchema, notebaseViewSortsSchema, notebaseViewTypeSchema, notebaseViewUpdateDataSchema, pageSchema, paginationShape, pickPublicErrorMap, renderedCardSchema, reviewRatingSchema, scheduleStatusSchema, schedulingParamsSchema, speechPreferencesSchema, speechPreferencesUpdateInputSchema, speechRateSchema, speechSynthesizeInputSchema, speechSynthesizeOutputSchema, speechVoiceGenderSchema, speechVoiceNameSchema, speechVoiceSchema, speechVoicesOutputSchema, srsAcknowledgeOptimizerResultsInputSchema, srsAcknowledgeOptimizerResultsOutputSchema, srsActivityStatsItemSchema, srsActivityStatsOutputSchema, srsListCardRevlogsInputSchema, srsListCardRevlogsOutputSchema, srsListUnreadOptimizerResultsInputSchema, srsListUnreadOptimizerResultsOutputSchema, srsManualCardStatusInputSchema, srsMemoryGrowthStatsItemSchema, srsMemoryGrowthStatsOutputSchema, srsOptimizerUnreadResultSchema, srsRecentNotebaseScheduleStatusStatsInputSchema, srsRecentNotebaseScheduleStatusStatsOutputSchema, srsReviewInputSchema, srsReviewOutputSchema, srsRevlogSchema, srsRevlogWithoutSnapshotSchema, srsRollbackReviewInputSchema, srsRollbackReviewOutputSchema, srsScheduleStatusStatsInputSchema, srsScheduleStatusStatsOutputSchema, srsScheduleStatusStatsSchema, srsSetCardBuriedInputSchema, srsSetCardBuriedOutputSchema, srsSetCardSuspendedInputSchema, srsSetCardSuspendedOutputSchema, srsTxidOutputSchema, statsInputSchema, stepSchema, timezoneSchema, userEnsureTimezoneInputSchema, userEnsureTimezoneOutputSchema, userUpdateTimezoneInputSchema, userUpdateTimezoneOutputSchema, videoTranscriptCreateInputSchema, videoTranscriptGetInputSchema, videoTranscriptResourceSchema, videoTranscriptStatusSchema, videoTranscriptSubtitlesSchema, videoTranscriptUsagePoolSchema, videoTranscriptUsageSchema };
+export { BILLING_PAYMENT_DUE_TIME_ZONE, CardGenerateInputSchema, CardGenerateOutputSchema, CardGetInputSchema, CardGetOutputSchema, CardListInputSchema, CardListOutputSchema, CardTemplateCreateInputSchema, CardTemplateCreateOutputSchema, CardTemplateDeleteInputSchema, CardTemplateDeleteOutputSchema, CardTemplateGetInputSchema, CardTemplateGetOutputSchema, CardTemplateInvalidColumnsDataSchema, CardTemplateInvalidLayoutDataSchema, CardTemplateListInputSchema, CardTemplateListOutputSchema, CardTemplateNotebaseColumnInUseDataSchema, CardTemplateUpdateInputSchema, CardTemplateUpdateOutputSchema, CellValidationFailedDataSchema, CellValidationFailureDetailsSchema, CellValidationFailureReasonSchema, DEFAULT_SPEECH_PREFERENCES, FeatureAccessStatusInputSchema, FeatureAccessStatusOutputSchema, GatedFeatureKeySchema, HOSTED_AI_CLIENT_STREAM_PART_TYPES, HOSTED_AI_NOTE_SUGGESTION_MAX_NOTES, HOSTED_AI_NOTE_SUGGESTION_MAX_NOTE_FIELDS, HostedAiCreditPeriodKindSchema, HostedAiCreditPolicyIdSchema, HostedAiCreditPoolStatusSchema, HostedAiFeatureSchema, HostedAiFeatureStatusSchema, HostedAiModelTierSchema, HostedAiNoteSuggestionObjectSchema, HostedAiNoteSuggestionStreamInputSchema, HostedAiOneTimeCreditStatusSchema, HostedAiOutputFieldSchema, HostedAiOutputFieldTypeSchema, HostedAiQuotaExhaustedDataSchema, HostedAiQuotaScopeSchema, HostedAiRateLimitErrorDataSchema, HostedAiRecurringCreditStatusSchema, HostedAiRequestIdSchema, HostedAiStatusInputSchema, HostedAiStatusOutputSchema, HostedAiStreamPartSchema, HostedAiStreamStructuredObjectInputSchema, HostedAiStreamTextInputSchema, HostedAiTierRestrictedDataSchema, HostedAiTierStatusSchema, HostedAiUnavailableReasonSchema, MASTERY_GOAL_TARGET_MAX, MCP_DAILY_CALL_LIMITS, NOTEBASE_ROW_CREATE_MANY_MAX_ROWS, NOTEBASE_ROW_DELETE_MANY_MAX_ROWS, NOTEBASE_ROW_UPDATE_MANY_MAX_ROWS, NotebaseColumnCreateInputSchema, NotebaseColumnCreateOutputSchema, NotebaseColumnDeleteInputSchema, NotebaseColumnDeleteOutputSchema, NotebaseColumnReorderInputSchema, NotebaseColumnReorderOutputSchema, NotebaseColumnUpdateInputSchema, NotebaseColumnUpdateOutputSchema, NotebaseCreateInputSchema, NotebaseCreateOutputSchema, NotebaseDeleteInputSchema, NotebaseDeleteOutputSchema, NotebaseGetInputSchema, NotebaseGetOutputSchema, NotebaseGetSchemaInputSchema, NotebaseGetSchemaOutputSchema, NotebaseGetSummaryInputSchema, NotebaseGetSummaryOutputSchema, NotebaseListInputSchema, NotebaseListItemSchema, NotebaseListOutputSchema, NotebaseRowCreateInputSchema, NotebaseRowCreateManyInputSchema, NotebaseRowCreateManyOutputSchema, NotebaseRowCreateOutputSchema, NotebaseRowDeleteInputSchema, NotebaseRowDeleteManyInputSchema, NotebaseRowDeleteManyOutputSchema, NotebaseRowDeleteOutputSchema, NotebaseRowGetInputSchema, NotebaseRowGetOutputSchema, NotebaseRowListInputSchema, NotebaseRowListOutputSchema, NotebaseRowReorderInputSchema, NotebaseRowReorderOutputSchema, NotebaseRowUpdateInputSchema, NotebaseRowUpdateManyInputSchema, NotebaseRowUpdateManyOutputSchema, NotebaseRowUpdateOutputSchema, NotebaseSetSleepInputSchema, NotebaseSetSleepOutputSchema, NotebaseUpdateInputSchema, NotebaseUpdateOutputSchema, PUBLIC_APP_ERROR_DEFS, SPEECH_DAILY_REQUEST_LIMITS, SPEECH_RATE_MAX, SPEECH_RATE_MIN, SPEECH_TEXT_MAX_LENGTH, SRS_REVIEW_CLIENT_ID_NAMESPACE, SRS_REVIEW_DURATION_MS_MAX, SpeechDailyLimitReachedDataSchema, activityStatsOutputSchema, appLocaleSchema, billingAccessSourceSchema, billingCancelScheduledChangeOutputSchema, billingCheckoutPlanSchema, billingCreateCheckoutSessionInputSchema, billingCreateCustomerPortalSessionInputSchema, billingCurrencySchema, billingIntervalSchema, billingLocaleSchema, billingPaymentDueSchema, billingPlanSchema, billingScheduledChangeSchema, billingSessionUrlOutputSchema, billingStatusSchema, billingSubscriptionStatusSchema, canonicalTimezoneSchema, cardSchema, cardStateSchema, cardTemplateSchema, contract, createSrsReviewClientId, defineAgentProcedure, deletionResultSchema, ebookCoverContentTypeSchema, ebookDeleteInputSchema, ebookDeleteOutputSchema, ebookDetailSchema, ebookFinalizeUploadInputSchema, ebookFinalizeUploadOutputSchema, ebookGetDownloadUrlInputSchema, ebookGetDownloadUrlOutputSchema, ebookGetInputSchema, ebookGetOutputSchema, ebookListInputSchema, ebookListItemSchema, ebookListOutputSchema, ebookPresignedUploadSchema, ebookQuotaSchema, ebookRenameDataSchema, ebookRenameInputSchema, ebookRenameOutputSchema, ebookRequestUploadInputSchema, ebookRequestUploadOutputSchema, ebookStatusSchema, ebookUpdateProgressDataSchema, ebookUpdateProgressInputSchema, ebookUpdateProgressOutputSchema, emailCategoryKeySchema, emailCategoryStateSchema, emailLinkTokenSchema, emailPreferencesByTokenStateSchema, emailPreferencesGetByTokenInputSchema, emailPreferencesGetInputSchema, emailPreferencesStateSchema, emailPreferencesUpdateByTokenInputSchema, emailPreferencesUpdateInputSchema, expectedUpdatedAtSchema, getPublicErrorDefinition, isPublicAppErrorCode, masteryGoalOutputSchema, masteryGoalTargetSchema, masteryGoalUpdateInputSchema, mcpConnectionListOutputSchema, mcpConnectionRevokeInputSchema, mcpConnectionRevokeOutputSchema, mcpConnectionSchema, notebaseActivityStatsItemSchema, notebaseActivityStatsOutputSchema, notebaseColumnCreateDataSchema, notebaseColumnSchema, notebaseColumnUpdateDataSchema, notebaseColumnWidthSchema, notebaseCreateDataSchema, notebaseRowCellsSchema, notebaseRowCreateDataSchema, notebaseRowGrowthStatsItemSchema, notebaseRowGrowthStatsOutputSchema, notebaseRowSchema, notebaseRowUpdateDataSchema, notebaseSchema, notebaseSummarySchema, notebaseUpdateDataSchema, notebaseViewConfigSchema, notebaseViewCreateDataSchema, notebaseViewFilterSchema, notebaseViewFiltersSchema, notebaseViewSchema, notebaseViewSortSchema, notebaseViewSortsSchema, notebaseViewTypeSchema, notebaseViewUpdateDataSchema, pageSchema, paginationShape, pickPublicErrorMap, renderedCardSchema, reviewRatingSchema, scheduleStatusSchema, schedulingParamsSchema, speechPreferencesSchema, speechPreferencesUpdateInputSchema, speechRateSchema, speechSynthesizeInputSchema, speechSynthesizeOutputSchema, speechVoiceGenderSchema, speechVoiceNameSchema, speechVoiceSchema, speechVoicesOutputSchema, srsAcknowledgeOptimizerResultsInputSchema, srsAcknowledgeOptimizerResultsOutputSchema, srsActivityStatsItemSchema, srsActivityStatsOutputSchema, srsListCardRevlogsInputSchema, srsListCardRevlogsOutputSchema, srsListUnreadOptimizerResultsInputSchema, srsListUnreadOptimizerResultsOutputSchema, srsManualCardStatusInputSchema, srsMemoryGrowthStatsItemSchema, srsMemoryGrowthStatsOutputSchema, srsOptimizerUnreadResultSchema, srsRecentNotebaseScheduleStatusStatsInputSchema, srsRecentNotebaseScheduleStatusStatsOutputSchema, srsReviewInputSchema, srsReviewOutputSchema, srsRevlogSchema, srsRevlogWithoutSnapshotSchema, srsRollbackReviewInputSchema, srsRollbackReviewOutputSchema, srsScheduleStatusStatsInputSchema, srsScheduleStatusStatsOutputSchema, srsScheduleStatusStatsSchema, srsSetCardBuriedInputSchema, srsSetCardBuriedOutputSchema, srsSetCardSuspendedInputSchema, srsSetCardSuspendedOutputSchema, srsTxidOutputSchema, statsInputSchema, stepSchema, timezoneSchema, userEnsureLocaleInputSchema, userEnsureLocaleOutputSchema, userEnsureTimezoneInputSchema, userEnsureTimezoneOutputSchema, userUpdateLocaleInputSchema, userUpdateLocaleOutputSchema, userUpdateTimezoneInputSchema, userUpdateTimezoneOutputSchema, videoTranscriptCreateInputSchema, videoTranscriptGetInputSchema, videoTranscriptResourceSchema, videoTranscriptStatusSchema, videoTranscriptSubtitlesSchema, videoTranscriptUsagePoolSchema, videoTranscriptUsageSchema };
 
 //# sourceMappingURL=index.js.map