@read-frog/api-contract 0.26.0 → 0.27.0

package/package.json

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

package/src/contracts/speech.ts

@@ -1,5 +1,8 @@
 import { oc } from "@orpc/contract";
+import { z } from "zod";
 import {
+  speechDeleteAllAudioOutputSchema,
+  speechDeleteAudioInputSchema,
   speechPreferencesSchema,
   speechPreferencesUpdateInputSchema,
   speechSynthesizeInputSchema,
@@ -42,4 +45,21 @@ export const speechContract = {
     })
     .input(speechSynthesizeInputSchema)
     .output(speechSynthesizeOutputSchema),
+  deleteAudio: oc
+    .route({
+      method: "POST",
+      path: "/speech/audio/delete",
+      summary: "Forget the audio kept for some texts, so each is read anew next time",
+      tags: ["Speech"],
+    })
+    .input(speechDeleteAudioInputSchema)
+    .output(z.void()),
+  deleteAllAudio: oc
+    .route({
+      method: "DELETE",
+      path: "/speech/audio",
+      summary: "Forget all the audio kept for the authenticated user's texts",
+      tags: ["Speech"],
+    })
+    .output(speechDeleteAllAudioOutputSchema),
 };

package/src/schemas/speech.ts

@@ -109,6 +109,29 @@ export const speechSynthesizeInputSchema = z
   .strict();
 export type SpeechSynthesizeInput = z.infer<typeof speechSynthesizeInputSchema>;
 
+/** The most texts one request forgets the audio of. */
+export const SPEECH_DELETE_AUDIO_MAX_TEXTS = 50;
+
+/**
+ * Texts whose kept audio to forget, each as it is asked to be read aloud
+ * (`speech.synthesize`): the next time one is, it is read anew. Audio for a
+ * text that has none kept is no error.
+ */
+export const speechDeleteAudioInputSchema = z
+  .object({
+    texts: z.array(speechSynthesizeInputSchema).min(1).max(SPEECH_DELETE_AUDIO_MAX_TEXTS),
+  })
+  .strict();
+export type SpeechDeleteAudioInput = z.infer<typeof speechDeleteAudioInputSchema>;
+
+export const speechDeleteAllAudioOutputSchema = z
+  .object({
+    // How many audio files there were.
+    deleted: z.number().int().nonnegative(),
+  })
+  .strict();
+export type SpeechDeleteAllAudioOutput = z.infer<typeof speechDeleteAllAudioOutputSchema>;
+
 /**
  * Where to download the audio, an MP3: a link to fetch at once, which stops
  * working at `expiresAt`.