@read-frog/api-contract 0.27.0 → 0.29.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@read-frog/api-contract",
-  "version": "0.27.0",
+  "version": "0.29.0",
   "private": false,
   "repository": {
     "type": "git",
@@ -25,7 +25,7 @@
   },
   "dependencies": {
     "@orpc/contract": "^1.16.1",
-    "@read-frog/definitions": "0.15.0",
+    "@read-frog/definitions": "0.16.0",
     "zod": "^4.6.7"
   },
   "devDependencies": {

package/src/schemas/hosted-ai.ts

@@ -280,14 +280,6 @@ export const HostedAiTierStatusSchema = z.strictObject({
    * signing in. Clients badge an option with it and offer that plan.
    */
   upgradeTo: HostedAiUpgradePlanSchema.nullable(),
-  /**
-   * @deprecated Read `upgradeTo`. Viewer-independent product fact: no
-   * non-Ultra account can ever use this feature/tier. Extensions released
-   * before `upgradeTo` badge options with it, including for Ultra accounts.
-   *
-   * TODO(2026-11-21): remove once those extensions have drained (#710).
-   */
-  requiresUltra: z.boolean(),
   modelRevision: z.string().trim().min(1),
 });
 
@@ -297,15 +289,6 @@ export const HostedAiFeatureStatusSchema = z.strictObject({
 });
 
 export const HostedAiStatusOutputSchema = z.strictObject({
-  /**
-   * @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

package/src/schemas/speech.ts

@@ -1,5 +1,5 @@
 import type { BillingPlan } from "./billing";
-import { langCodeISO6393Schema } from "@read-frog/definitions";
+import { langCodeISO6393Schema, languageTagSchema, resolveLanguage } from "@read-frog/definitions";
 import { z } from "zod";
 
 // Reading text aloud in the account's voices: the reader's settings, the
@@ -32,6 +32,14 @@ export const SPEECH_RATE_MAX = 100;
 /** Reading speed: percent faster (+) or slower (−) than normal. */
 export const speechRateSchema = z.number().int().min(SPEECH_RATE_MIN).max(SPEECH_RATE_MAX);
 
+// A language a request names. Pages loaded before languages were keyed by tag
+// still send ISO 639-3 codes (`deu`) until they are reloaded, so those are
+// read as their tags. Answers always name languages by tag.
+const speechLanguageInputSchema = z.union([
+  languageTagSchema,
+  langCodeISO6393Schema.transform((code) => resolveLanguage(code)).pipe(languageTagSchema),
+]);
+
 /**
  * How the account reads aloud. A language left out of `languageVoices`, and a
  * `null` `multilingualVoice`, read in the default voice (`speech.listVoices`
@@ -39,7 +47,7 @@ export const speechRateSchema = z.number().int().min(SPEECH_RATE_MIN).max(SPEECH
  */
 export const speechPreferencesSchema = z
   .object({
-    languageVoices: z.partialRecord(langCodeISO6393Schema, speechVoiceNameSchema),
+    languageVoices: z.partialRecord(languageTagSchema, speechVoiceNameSchema),
     // Reads text whose language is not known, working the language out itself.
     multilingualVoice: speechVoiceNameSchema.nullable(),
     rate: speechRateSchema,
@@ -60,7 +68,7 @@ export const DEFAULT_SPEECH_PREFERENCES: SpeechPreferences = {
 export const speechPreferencesUpdateInputSchema = z
   .object({
     languageVoices: z
-      .partialRecord(langCodeISO6393Schema, speechVoiceNameSchema.nullable())
+      .partialRecord(speechLanguageInputSchema, speechVoiceNameSchema.nullable())
       .optional(),
     multilingualVoice: speechVoiceNameSchema.nullable().optional(),
     rate: speechRateSchema.optional(),
@@ -78,7 +86,7 @@ export const speechVoiceSchema = z
     displayName: z.string(),
     locale: z.string(),
     // The language the voice is for; null for one this list has no code for.
-    language: langCodeISO6393Schema.nullable(),
+    language: languageTagSchema.nullable(),
     gender: speechVoiceGenderSchema,
     // Reads many languages, working out the text's language itself.
     multilingual: z.boolean(),
@@ -90,7 +98,7 @@ export const speechVoicesOutputSchema = z
   .object({
     voices: z.array(speechVoiceSchema),
     // The voice each language reads in until the reader picks one.
-    defaultVoices: z.partialRecord(langCodeISO6393Schema, speechVoiceNameSchema),
+    defaultVoices: z.partialRecord(languageTagSchema, speechVoiceNameSchema),
     defaultMultilingualVoice: speechVoiceNameSchema,
   })
   .strict();
@@ -101,7 +109,7 @@ export const speechSynthesizeInputSchema = z
     text: z.string().trim().min(1).max(SPEECH_TEXT_MAX_LENGTH),
     // The text's language, when the caller knows it; without one, a
     // multilingual voice works it out.
-    language: langCodeISO6393Schema.optional(),
+    language: speechLanguageInputSchema.optional(),
     // Reads in this voice instead of the account's, such as one the reader is
     // trying out in the settings.
     voice: speechVoiceNameSchema.optional(),