@antiphony/shared 0.4.0 → 0.5.0

package/dist/cjs/api-codecs.cjs

@@ -46,21 +46,85 @@ var FirestoreTimestampSchema = zod.z.union([
   return date;
 });
 var ProcessingStageStatusSchema = zod.z.enum(["pending", "ready", "failed", "skipped"]);
+var PROCESSING_STAGES = ["denoise", "trim", "transcribe", "waveform"];
+zod.z.enum(PROCESSING_STAGES);
 var ProcessingRequestSchema = zod.z.object({
   transcribe: zod.z.boolean().optional(),
-  denoise: zod.z.boolean().optional()
+  denoise: zod.z.boolean().optional(),
+  trim: zod.z.boolean().optional(),
+  waveform: zod.z.boolean().optional(),
+  /**
+   * Whether a completed byte-mutating stage should invalidate and recompute
+   * the derived artifacts that describe the old audio. Defaults to **true**
+   * — a transcript of superseded audio is wrong, not merely stale.
+   *
+   * `false` opts out, for an app that would rather keep the existing
+   * transcript than pay to regenerate it. It does NOT name a stage, so a
+   * request carrying only `reprocess` requests no work.
+   */
+  reprocess: zod.z.boolean().optional()
 });
-var ProcessingStateSchema = zod.z.object({
+var ProcessingStageMapSchema = zod.z.object({
   transcribe: ProcessingStageStatusSchema.optional(),
   denoise: ProcessingStageStatusSchema.optional(),
-  /** Content CID of the denoised audio variant, once `denoise === 'ready'`. */
-  denoisedBlobCid: zod.z.string().optional(),
-  updatedAt: FirestoreTimestampSchema
+  trim: ProcessingStageStatusSchema.optional(),
+  waveform: ProcessingStageStatusSchema.optional()
 });
-var ProcessingViewSchema = zod.z.object({
-  transcribe: ProcessingStageStatusSchema.optional(),
-  denoise: ProcessingStageStatusSchema.optional()
+var ResolvedProcessingSchema = ProcessingStageMapSchema.extend({
+  reprocess: zod.z.boolean().optional()
+});
+var ProcessingStateSchema = ResolvedProcessingSchema.extend({
+  /**
+   * Content CID of the processed audio variant — the composed output of every
+   * byte-mutating stage that has completed. The record's own
+   * `embed.audio.ref.$link` stays the ORIGINAL CID (immutable content
+   * address); only the read-time view swaps playback to this variant.
+   */
+  processedBlobCid: zod.z.string().optional(),
+  /**
+   * MIME type of the processed variant. Present because providers may
+   * TRANSCODE — the ElevenLabs Voice Isolator returns MP3 regardless of what
+   * it is given — so the variant's type cannot be assumed to match
+   * `embed.audio.mimeType`. Anything reading the variant's bytes must use
+   * this, not the embed's.
+   */
+  processedMimeType: zod.z.string().optional(),
+  /**
+   * Duration of the processed variant, when a byte-mutating stage changed it
+   * (i.e. trim). Absent when the variant's duration matches the original.
+   */
+  processedDurationMs: zod.z.number().int().min(0).optional(),
+  /**
+   * Peaks for the processed variant, once the `waveform` stage completes.
+   * Same normalization and bounds as `embed.waveform` (0–100, max 1000), so
+   * a view can never carry a larger payload than the record allows.
+   */
+  waveformPeaks: zod.z.array(zod.z.number().int().min(0).max(100)).max(1e3).optional(),
+  /**
+   * When the current runner's exclusive claim on this post expires.
+   *
+   * Queue delivery is at-least-once, so the same job can arrive twice and
+   * run CONCURRENTLY. `process()` is idempotent under sequential retry — it
+   * acts on `pending` and re-does nothing already settled — but two passes
+   * interleaved is a different failure: both read the same `pending` state,
+   * both bill the provider for the same stage, and both write
+   * `processedBlobCid`, so the surviving variant is whichever finished last
+   * and the other's blob is orphaned.
+   *
+   * A runner claims this field transactionally before doing any work and
+   * clears it when finished; a second runner finding it unexpired declines
+   * and returns. It is an EXPIRY, not a boolean lock, because the holder can
+   * die mid-run (instance recycled, process killed) with no chance to
+   * release — a plain flag would strand the post permanently, where a lapsed
+   * lease lets the next delivery pick it up.
+   *
+   * Internal, like the variant fields above: `toProcessingView` projects
+   * stages only, so this never reaches a client.
+   */
+  leaseUntil: FirestoreTimestampSchema.optional(),
+  updatedAt: FirestoreTimestampSchema
 });
+var ProcessingViewSchema = ProcessingStageMapSchema;
 
 // types/audio.ts
 var StrongRefSchema = zod.z.object({
@@ -96,20 +160,34 @@ var TimedTranscriptSchema = zod.z.object({
 });
 var AudioEmbedViewSchema = zod.z.object({
   $type: zod.z.literal("dev.antiphony.embed.audio#view"),
+  /**
+   * `url`, `durationMs` and `waveform` are RESOLVED, not copied: once
+   * processing has produced an audio variant they describe that variant
+   * rather than the bytes the client uploaded. They always agree with one
+   * another — a duration and a set of peaks are only meaningful against the
+   * audio `url` actually points at.
+   *
+   * A client that stored `durationMs` at upload time should therefore expect
+   * it to change (trim removes leading/trailing silence), and should render
+   * these three as a set rather than caching them independently. The record's
+   * originals are immutable and unaffected; this is a read-time resolution.
+   */
   url: zod.z.string().url(),
   durationMs: zod.z.number().int().min(0).optional(),
-  // `alt`/`waveform` are copied from the stored embed; keep the same bounds
-  // so a view can never carry a larger payload than the record allows.
+  // `alt` is copied from the stored embed; keep the same bounds so a view can
+  // never carry a larger payload than the record allows.
   alt: zod.z.string().max(1e4).optional(),
   waveform: zod.z.array(zod.z.number().int().min(0).max(100)).max(1e3).optional(),
   /** Lifted from the transcript enrichment record; absent until transcription completes. */
   transcript: TimedTranscriptSchema.optional(),
   /**
-   * Per-stage audio-processing status (transcribe / denoise), when the app
-   * opted into processing on create. Absent otherwise. A `pending` stage
-   * means the client should poll (or re-render) for the result. When
-   * `denoise === 'ready'`, `url` above already resolves to the cleaned
-   * audio variant. See `types/processing.ts`.
+   * Per-stage audio-processing status (denoise / trim / transcribe /
+   * waveform), when the app opted into processing. Absent otherwise. A
+   * `pending` stage means the client should poll (or re-render) for the
+   * result — including a stage that returns to `pending` after having been
+   * `ready`, which is how a recompute surfaces. Once a byte-mutating stage
+   * completes, `url`/`durationMs`/`waveform` above already resolve to the
+   * processed audio variant. See `types/processing.ts`.
    */
   processing: ProcessingViewSchema.optional()
 });
@@ -251,9 +329,11 @@ var CreateAudioPostRequestSchema = zod.z.object({
   /** Author self-label values (content warnings). */
   selfLabels: zod.z.array(zod.z.string()).optional(),
   /**
-   * Opt-in audio processing for this post's audio (transcribe / denoise).
-   * Both default off. Stages the deployment can't provide come back marked
-   * `skipped` on the view rather than failing the create. See
+   * Opt-in audio processing for this post's audio (denoise / trim /
+   * transcribe / waveform). All default off. Stages the deployment can't
+   * provide come back marked `skipped` on the view rather than failing the
+   * create. A multi-stage request runs denoise → trim → (transcribe,
+   * waveform); request stages individually to override that order. See
    * `types/processing.ts`.
    */
   processing: ProcessingRequestSchema.optional()

package/dist/cjs/api-codecs.d.cts

@@ -53,9 +53,9 @@ declare const CreateAudioPostRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObjec
             mimeType: string;
             size: number;
         };
+        waveform?: number[] | undefined;
         durationMs?: number | undefined;
         alt?: string | undefined;
-        waveform?: number[] | undefined;
     }, {
         $type: "dev.antiphony.embed.audio";
         audio: {
@@ -66,9 +66,9 @@ declare const CreateAudioPostRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObjec
             mimeType: string;
             size: number;
         };
+        waveform?: number[] | undefined;
         durationMs?: number | undefined;
         alt?: string | undefined;
-        waveform?: number[] | undefined;
     }>>;
     /** Present ⇒ this is a reply (StrongRef root + parent). */
     reply: z.ZodOptional<z.ZodObject<{
@@ -116,26 +116,40 @@ declare const CreateAudioPostRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObjec
     /** Author self-label values (content warnings). */
     selfLabels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     /**
-     * Opt-in audio processing for this post's audio (transcribe / denoise).
-     * Both default off. Stages the deployment can't provide come back marked
-     * `skipped` on the view rather than failing the create. See
+     * Opt-in audio processing for this post's audio (denoise / trim /
+     * transcribe / waveform). All default off. Stages the deployment can't
+     * provide come back marked `skipped` on the view rather than failing the
+     * create. A multi-stage request runs denoise → trim → (transcribe,
+     * waveform); request stages individually to override that order. See
      * `types/processing.ts`.
      */
     processing: z.ZodOptional<z.ZodObject<{
         transcribe: z.ZodOptional<z.ZodBoolean>;
         denoise: z.ZodOptional<z.ZodBoolean>;
+        trim: z.ZodOptional<z.ZodBoolean>;
+        waveform: z.ZodOptional<z.ZodBoolean>;
+        reprocess: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
-        transcribe?: boolean | undefined;
         denoise?: boolean | undefined;
-    }, {
+        trim?: boolean | undefined;
         transcribe?: boolean | undefined;
+        waveform?: boolean | undefined;
+        reprocess?: boolean | undefined;
+    }, {
         denoise?: boolean | undefined;
+        trim?: boolean | undefined;
+        transcribe?: boolean | undefined;
+        waveform?: boolean | undefined;
+        reprocess?: boolean | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     text: string;
     processing?: {
-        transcribe?: boolean | undefined;
         denoise?: boolean | undefined;
+        trim?: boolean | undefined;
+        transcribe?: boolean | undefined;
+        waveform?: boolean | undefined;
+        reprocess?: boolean | undefined;
     } | undefined;
     reply?: {
         root: {
@@ -158,17 +172,20 @@ declare const CreateAudioPostRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObjec
             mimeType: string;
             size: number;
         };
+        waveform?: number[] | undefined;
         durationMs?: number | undefined;
         alt?: string | undefined;
-        waveform?: number[] | undefined;
     } | undefined;
     langs?: string[] | undefined;
     selfLabels?: string[] | undefined;
 }, {
     text?: string | undefined;
     processing?: {
-        transcribe?: boolean | undefined;
         denoise?: boolean | undefined;
+        trim?: boolean | undefined;
+        transcribe?: boolean | undefined;
+        waveform?: boolean | undefined;
+        reprocess?: boolean | undefined;
     } | undefined;
     reply?: {
         root: {
@@ -191,17 +208,20 @@ declare const CreateAudioPostRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObjec
             mimeType: string;
             size: number;
         };
+        waveform?: number[] | undefined;
         durationMs?: number | undefined;
         alt?: string | undefined;
-        waveform?: number[] | undefined;
     } | undefined;
     langs?: string[] | undefined;
     selfLabels?: string[] | undefined;
 }>, {
     text: string;
     processing?: {
-        transcribe?: boolean | undefined;
         denoise?: boolean | undefined;
+        trim?: boolean | undefined;
+        transcribe?: boolean | undefined;
+        waveform?: boolean | undefined;
+        reprocess?: boolean | undefined;
     } | undefined;
     reply?: {
         root: {
@@ -224,17 +244,20 @@ declare const CreateAudioPostRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObjec
             mimeType: string;
             size: number;
         };
+        waveform?: number[] | undefined;
         durationMs?: number | undefined;
         alt?: string | undefined;
-        waveform?: number[] | undefined;
     } | undefined;
     langs?: string[] | undefined;
     selfLabels?: string[] | undefined;
 }, {
     text?: string | undefined;
     processing?: {
-        transcribe?: boolean | undefined;
         denoise?: boolean | undefined;
+        trim?: boolean | undefined;
+        transcribe?: boolean | undefined;
+        waveform?: boolean | undefined;
+        reprocess?: boolean | undefined;
     } | undefined;
     reply?: {
         root: {
@@ -257,17 +280,20 @@ declare const CreateAudioPostRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObjec
             mimeType: string;
             size: number;
         };
+        waveform?: number[] | undefined;
         durationMs?: number | undefined;
         alt?: string | undefined;
-        waveform?: number[] | undefined;
     } | undefined;
     langs?: string[] | undefined;
     selfLabels?: string[] | undefined;
 }>, {
     text: string;
     processing?: {
-        transcribe?: boolean | undefined;
         denoise?: boolean | undefined;
+        trim?: boolean | undefined;
+        transcribe?: boolean | undefined;
+        waveform?: boolean | undefined;
+        reprocess?: boolean | undefined;
     } | undefined;
     reply?: {
         root: {
@@ -290,17 +316,20 @@ declare const CreateAudioPostRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObjec
             mimeType: string;
             size: number;
         };
+        waveform?: number[] | undefined;
         durationMs?: number | undefined;
         alt?: string | undefined;
-        waveform?: number[] | undefined;
     } | undefined;
     langs?: string[] | undefined;
     selfLabels?: string[] | undefined;
 }, {
     text?: string | undefined;
     processing?: {
-        transcribe?: boolean | undefined;
         denoise?: boolean | undefined;
+        trim?: boolean | undefined;
+        transcribe?: boolean | undefined;
+        waveform?: boolean | undefined;
+        reprocess?: boolean | undefined;
     } | undefined;
     reply?: {
         root: {
@@ -323,9 +352,9 @@ declare const CreateAudioPostRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObjec
             mimeType: string;
             size: number;
         };
+        waveform?: number[] | undefined;
         durationMs?: number | undefined;
         alt?: string | undefined;
-        waveform?: number[] | undefined;
     } | undefined;
     langs?: string[] | undefined;
     selfLabels?: string[] | undefined;
@@ -346,22 +375,37 @@ declare const PatchAudioPostRequestSchema: z.ZodObject<{
     processing: z.ZodObject<{
         transcribe: z.ZodOptional<z.ZodBoolean>;
         denoise: z.ZodOptional<z.ZodBoolean>;
+        trim: z.ZodOptional<z.ZodBoolean>;
+        waveform: z.ZodOptional<z.ZodBoolean>;
+        reprocess: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
-        transcribe?: boolean | undefined;
         denoise?: boolean | undefined;
-    }, {
+        trim?: boolean | undefined;
         transcribe?: boolean | undefined;
+        waveform?: boolean | undefined;
+        reprocess?: boolean | undefined;
+    }, {
         denoise?: boolean | undefined;
+        trim?: boolean | undefined;
+        transcribe?: boolean | undefined;
+        waveform?: boolean | undefined;
+        reprocess?: boolean | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
     processing: {
-        transcribe?: boolean | undefined;
         denoise?: boolean | undefined;
+        trim?: boolean | undefined;
+        transcribe?: boolean | undefined;
+        waveform?: boolean | undefined;
+        reprocess?: boolean | undefined;
     };
 }, {
     processing: {
-        transcribe?: boolean | undefined;
         denoise?: boolean | undefined;
+        trim?: boolean | undefined;
+        transcribe?: boolean | undefined;
+        waveform?: boolean | undefined;
+        reprocess?: boolean | undefined;
     };
 }>;
 type PatchAudioPostRequest = z.infer<typeof PatchAudioPostRequestSchema>;

package/dist/cjs/index.cjs

@@ -61,21 +61,105 @@ var FirestoreTimestampSchema = zod.z.union([
   return date;
 });
 var ProcessingStageStatusSchema = zod.z.enum(["pending", "ready", "failed", "skipped"]);
+var PROCESSING_STAGES = ["denoise", "trim", "transcribe", "waveform"];
+var ProcessingStageSchema = zod.z.enum(PROCESSING_STAGES);
+var BYTE_MUTATING_STAGES = ["denoise", "trim"];
+var DERIVED_STAGES = ["transcribe", "waveform"];
 var ProcessingRequestSchema = zod.z.object({
   transcribe: zod.z.boolean().optional(),
-  denoise: zod.z.boolean().optional()
+  denoise: zod.z.boolean().optional(),
+  trim: zod.z.boolean().optional(),
+  waveform: zod.z.boolean().optional(),
+  /**
+   * Whether a completed byte-mutating stage should invalidate and recompute
+   * the derived artifacts that describe the old audio. Defaults to **true**
+   * — a transcript of superseded audio is wrong, not merely stale.
+   *
+   * `false` opts out, for an app that would rather keep the existing
+   * transcript than pay to regenerate it. It does NOT name a stage, so a
+   * request carrying only `reprocess` requests no work.
+   */
+  reprocess: zod.z.boolean().optional()
 });
-var ProcessingStateSchema = zod.z.object({
+var ProcessingStageMapSchema = zod.z.object({
   transcribe: ProcessingStageStatusSchema.optional(),
   denoise: ProcessingStageStatusSchema.optional(),
-  /** Content CID of the denoised audio variant, once `denoise === 'ready'`. */
-  denoisedBlobCid: zod.z.string().optional(),
-  updatedAt: FirestoreTimestampSchema
+  trim: ProcessingStageStatusSchema.optional(),
+  waveform: ProcessingStageStatusSchema.optional()
 });
-var ProcessingViewSchema = zod.z.object({
-  transcribe: ProcessingStageStatusSchema.optional(),
-  denoise: ProcessingStageStatusSchema.optional()
+var ResolvedProcessingSchema = ProcessingStageMapSchema.extend({
+  reprocess: zod.z.boolean().optional()
+});
+var ProcessingStateSchema = ResolvedProcessingSchema.extend({
+  /**
+   * Content CID of the processed audio variant — the composed output of every
+   * byte-mutating stage that has completed. The record's own
+   * `embed.audio.ref.$link` stays the ORIGINAL CID (immutable content
+   * address); only the read-time view swaps playback to this variant.
+   */
+  processedBlobCid: zod.z.string().optional(),
+  /**
+   * MIME type of the processed variant. Present because providers may
+   * TRANSCODE — the ElevenLabs Voice Isolator returns MP3 regardless of what
+   * it is given — so the variant's type cannot be assumed to match
+   * `embed.audio.mimeType`. Anything reading the variant's bytes must use
+   * this, not the embed's.
+   */
+  processedMimeType: zod.z.string().optional(),
+  /**
+   * Duration of the processed variant, when a byte-mutating stage changed it
+   * (i.e. trim). Absent when the variant's duration matches the original.
+   */
+  processedDurationMs: zod.z.number().int().min(0).optional(),
+  /**
+   * Peaks for the processed variant, once the `waveform` stage completes.
+   * Same normalization and bounds as `embed.waveform` (0–100, max 1000), so
+   * a view can never carry a larger payload than the record allows.
+   */
+  waveformPeaks: zod.z.array(zod.z.number().int().min(0).max(100)).max(1e3).optional(),
+  /**
+   * When the current runner's exclusive claim on this post expires.
+   *
+   * Queue delivery is at-least-once, so the same job can arrive twice and
+   * run CONCURRENTLY. `process()` is idempotent under sequential retry — it
+   * acts on `pending` and re-does nothing already settled — but two passes
+   * interleaved is a different failure: both read the same `pending` state,
+   * both bill the provider for the same stage, and both write
+   * `processedBlobCid`, so the surviving variant is whichever finished last
+   * and the other's blob is orphaned.
+   *
+   * A runner claims this field transactionally before doing any work and
+   * clears it when finished; a second runner finding it unexpired declines
+   * and returns. It is an EXPIRY, not a boolean lock, because the holder can
+   * die mid-run (instance recycled, process killed) with no chance to
+   * release — a plain flag would strand the post permanently, where a lapsed
+   * lease lets the next delivery pick it up.
+   *
+   * Internal, like the variant fields above: `toProcessingView` projects
+   * stages only, so this never reaches a client.
+   */
+  leaseUntil: FirestoreTimestampSchema.optional(),
+  updatedAt: FirestoreTimestampSchema
 });
+var ProcessingViewSchema = ProcessingStageMapSchema;
+function toProcessingView(state) {
+  const view = {};
+  for (const stage of PROCESSING_STAGES) {
+    if (state[stage] !== void 0) view[stage] = state[stage];
+  }
+  return view;
+}
+function resolveAudioVariant(canonical, state) {
+  var _a;
+  if (!state) return canonical;
+  const hasVariant = state.processedBlobCid !== void 0;
+  const peaksAreCurrent = state.waveform === "ready" && state.waveformPeaks !== void 0;
+  return {
+    blobCid: hasVariant ? state.processedBlobCid : canonical.blobCid,
+    durationMs: hasVariant ? (_a = state.processedDurationMs) != null ? _a : canonical.durationMs : canonical.durationMs,
+    waveform: peaksAreCurrent ? state.waveformPeaks : canonical.waveform
+  };
+}
 
 // types/audio.ts
 var StrongRefSchema = zod.z.object({
@@ -111,20 +195,34 @@ var TimedTranscriptSchema = zod.z.object({
 });
 var AudioEmbedViewSchema = zod.z.object({
   $type: zod.z.literal("dev.antiphony.embed.audio#view"),
+  /**
+   * `url`, `durationMs` and `waveform` are RESOLVED, not copied: once
+   * processing has produced an audio variant they describe that variant
+   * rather than the bytes the client uploaded. They always agree with one
+   * another — a duration and a set of peaks are only meaningful against the
+   * audio `url` actually points at.
+   *
+   * A client that stored `durationMs` at upload time should therefore expect
+   * it to change (trim removes leading/trailing silence), and should render
+   * these three as a set rather than caching them independently. The record's
+   * originals are immutable and unaffected; this is a read-time resolution.
+   */
   url: zod.z.string().url(),
   durationMs: zod.z.number().int().min(0).optional(),
-  // `alt`/`waveform` are copied from the stored embed; keep the same bounds
-  // so a view can never carry a larger payload than the record allows.
+  // `alt` is copied from the stored embed; keep the same bounds so a view can
+  // never carry a larger payload than the record allows.
   alt: zod.z.string().max(1e4).optional(),
   waveform: zod.z.array(zod.z.number().int().min(0).max(100)).max(1e3).optional(),
   /** Lifted from the transcript enrichment record; absent until transcription completes. */
   transcript: TimedTranscriptSchema.optional(),
   /**
-   * Per-stage audio-processing status (transcribe / denoise), when the app
-   * opted into processing on create. Absent otherwise. A `pending` stage
-   * means the client should poll (or re-render) for the result. When
-   * `denoise === 'ready'`, `url` above already resolves to the cleaned
-   * audio variant. See `types/processing.ts`.
+   * Per-stage audio-processing status (denoise / trim / transcribe /
+   * waveform), when the app opted into processing. Absent otherwise. A
+   * `pending` stage means the client should poll (or re-render) for the
+   * result — including a stage that returns to `pending` after having been
+   * `ready`, which is how a recompute surfaces. Once a byte-mutating stage
+   * completes, `url`/`durationMs`/`waveform` above already resolve to the
+   * processed audio variant. See `types/processing.ts`.
    */
   processing: ProcessingViewSchema.optional()
 });
@@ -266,9 +364,11 @@ var CreateAudioPostRequestSchema = zod.z.object({
   /** Author self-label values (content warnings). */
   selfLabels: zod.z.array(zod.z.string()).optional(),
   /**
-   * Opt-in audio processing for this post's audio (transcribe / denoise).
-   * Both default off. Stages the deployment can't provide come back marked
-   * `skipped` on the view rather than failing the create. See
+   * Opt-in audio processing for this post's audio (denoise / trim /
+   * transcribe / waveform). All default off. Stages the deployment can't
+   * provide come back marked `skipped` on the view rather than failing the
+   * create. A multi-stage request runs denoise → trim → (transcribe,
+   * waveform); request stages individually to override that order. See
    * `types/processing.ts`.
    */
   processing: ProcessingRequestSchema.optional()
@@ -401,23 +501,29 @@ exports.AudioEmbedSchema = AudioEmbedSchema;
 exports.AudioEmbedViewSchema = AudioEmbedViewSchema;
 exports.AudioPostRecordSchema = AudioPostRecordSchema;
 exports.AudioPostViewSchema = AudioPostViewSchema;
+exports.BYTE_MUTATING_STAGES = BYTE_MUTATING_STAGES;
 exports.BlobRefSchema = BlobRefSchema;
 exports.COLLECTIONS = COLLECTIONS;
 exports.ConflictError = ConflictError;
 exports.CreateAudioPostRequestSchema = CreateAudioPostRequestSchema;
+exports.DERIVED_STAGES = DERIVED_STAGES;
 exports.EMBED_NSID = EMBED_NSID;
 exports.FirestoreTimestampSchema = FirestoreTimestampSchema;
 exports.ForbiddenError = ForbiddenError;
 exports.NSID = NSID;
 exports.NotFoundError = NotFoundError;
+exports.PROCESSING_STAGES = PROCESSING_STAGES;
 exports.PatchAudioPostRequestSchema = PatchAudioPostRequestSchema;
 exports.PostRecordPublicSchema = PostRecordPublicSchema;
 exports.ProcessingRequestSchema = ProcessingRequestSchema;
+exports.ProcessingStageMapSchema = ProcessingStageMapSchema;
+exports.ProcessingStageSchema = ProcessingStageSchema;
 exports.ProcessingStageStatusSchema = ProcessingStageStatusSchema;
 exports.ProcessingStateSchema = ProcessingStateSchema;
 exports.ProcessingViewSchema = ProcessingViewSchema;
 exports.RateLimitError = RateLimitError;
 exports.ReplyRefSchema = ReplyRefSchema;
+exports.ResolvedProcessingSchema = ResolvedProcessingSchema;
 exports.ServiceError = ServiceError;
 exports.StrongRefSchema = StrongRefSchema;
 exports.TimedTranscriptSchema = TimedTranscriptSchema;
@@ -429,3 +535,5 @@ exports.ViewerStateSchema = ViewerStateSchema;
 exports.buildReportedErrorEvent = buildReportedErrorEvent;
 exports.isFirestoreTimestamp = isFirestoreTimestamp;
 exports.reportError = reportError;
+exports.resolveAudioVariant = resolveAudioVariant;
+exports.toProcessingView = toProcessingView;