@antiphony/shared 0.5.0 → 0.6.0

package/README.md

@@ -34,7 +34,7 @@ The root re-exports the most-used pieces (audio records + views, codecs, NSIDs,
 | `@antiphony/shared/errors` | Shared error types and helpers. |
 | `@antiphony/shared/utils` | Pure shared utilities (projection/date/sanitization helpers). |
 | `@antiphony/shared/observability` | Logging/error-reporting helpers (`./observability/report-error` for just the reporter). |
-| `@antiphony/shared/types/*` | Individual type modules: `audio`, `blob`, `processing`, `records`. |
+| `@antiphony/shared/types/*` | Individual type modules: `audio`, `blob`, `processing`, `records`, `url`. |
 
 ## The records this models
 

package/dist/cjs/api-codecs.cjs

@@ -94,6 +94,30 @@ var ProcessingStateSchema = ResolvedProcessingSchema.extend({
    * (i.e. trim). Absent when the variant's duration matches the original.
    */
   processedDurationMs: zod.z.number().int().min(0).optional(),
+  /**
+   * Which denoiser produced the variant's denoise contribution — provenance,
+   * the counterpart to a transcript record's `model`.
+   *
+   * Lives here because a cleaned variant, unlike a transcript, has no record
+   * of its own to carry it: it is a blob CID on this state. Without it,
+   * changing denoisers leaves no way to tell which variants predate the
+   * switch, so nothing can identify what to re-run.
+   *
+   * Named for the STAGE, not the variant (`processedModel`), because it
+   * describes one link of the byte-mutating chain rather than the composed
+   * artifact. Trim contributes to the same variant and has no model, and a
+   * later external link would want its own field rather than to overwrite
+   * this one.
+   *
+   * Written on every successful denoise, never cleared — it moves with
+   * `processedBlobCid`, which is only ever set, never reset. A denoise that
+   * FAILS leaves both alone, which is correct: the variant still holds the
+   * previous denoiser's output, so the previous model still describes it.
+   *
+   * Internal, like the other variant fields — `toProcessingView` projects
+   * stages only, so this never reaches a client.
+   */
+  denoiseModel: zod.z.string().optional(),
   /**
    * Peaks for the processed variant, once the `waveform` stage completes.
    * Same normalization and bounds as `embed.waveform` (0–100, max 1000), so
@@ -125,11 +149,14 @@ var ProcessingStateSchema = ResolvedProcessingSchema.extend({
   updatedAt: FirestoreTimestampSchema
 });
 var ProcessingViewSchema = ProcessingStageMapSchema;
+function httpsUrl() {
+  return zod.z.string().trim().url().regex(/^https?:\/\//i, { message: "URL must use the http or https scheme" });
+}
 
 // types/audio.ts
 var StrongRefSchema = zod.z.object({
-  uri: zod.z.string().regex(/^at:\/\/.+/, "Must be an at:// URI"),
-  cid: zod.z.string()
+  uri: zod.z.string().regex(/^at:\/\/.+/, "Must be an at:// URI").max(512),
+  cid: zod.z.string().max(128)
 });
 var ReplyRefSchema = zod.z.object({
   root: StrongRefSchema,
@@ -171,8 +198,13 @@ var AudioEmbedViewSchema = zod.z.object({
    * 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.
+   *
+   * Restricted to `http:`/`https:` (`httpsUrl()`), not any URL `new URL()`
+   * will parse. This is the value clients hand to `<audio src>`, so a
+   * `javascript:` or `data:` URL reaching one is stored XSS — and a bare
+   * `.url()` accepts both. See `types/url.ts`.
    */
-  url: zod.z.string().url(),
+  url: httpsUrl(),
   durationMs: zod.z.number().int().min(0).optional(),
   // `alt` is copied from the stored embed; keep the same bounds so a view can
   // never carry a larger payload than the record allows.
@@ -276,7 +308,13 @@ zod.z.object({
 zod.z.object({
   handle: zod.z.string().min(3).max(20).optional(),
   usageIntent: zod.z.string().max(100).optional(),
-  rssFeed: zod.z.string().url().optional()
+  /**
+   * Feed URL, restricted to `http:`/`https:` for the same reason
+   * `AudioEmbedView.url` is: an app renders this as an `<a href>`, and a bare
+   * `.url()` would let a `javascript:` URL through. A feed is a fetchable web
+   * document, so no legitimate value loses anything to the restriction.
+   */
+  rssFeed: httpsUrl().optional()
 });
 var ViewerStateSchema = zod.z.object({
   /** True when the authenticated caller authored this post. */
@@ -291,10 +329,15 @@ var ViewerStateSchema = zod.z.object({
   replyDisabledReason: zod.z.enum(["unauthenticated", "not_a_participant"]).optional()
 });
 var PostRecordPublicSchema = zod.z.object({
-  text: zod.z.string(),
-  title: zod.z.string().optional(),
+  // `text`, `title` and `langs` keep the record's bounds, for the same reason
+  // `AudioEmbedViewSchema.alt` does: a view must never be able to carry a
+  // larger payload than the record it projects. The write path already
+  // enforces these, so no stored post can exceed them — stating them here
+  // keeps the published contract honest rather than adding a new constraint.
+  text: zod.z.string().max(3e3),
+  title: zod.z.string().max(3e3).optional(),
   reply: ReplyRefSchema.optional(),
-  langs: zod.z.array(zod.z.string()).optional(),
+  langs: zod.z.array(zod.z.string()).max(3).optional(),
   selfLabels: zod.z.array(zod.z.string()).optional(),
   createdAt: FirestoreTimestampSchema
 });
@@ -325,9 +368,9 @@ var CreateAudioPostRequestSchema = zod.z.object({
   /** Present ⇒ this is a reply (StrongRef root + parent). */
   reply: ReplyRefSchema.optional(),
   /** BCP-47 language tags. */
-  langs: zod.z.array(zod.z.string()).max(3).optional(),
+  langs: zod.z.array(zod.z.string().max(35)).max(3).optional(),
   /** Author self-label values (content warnings). */
-  selfLabels: zod.z.array(zod.z.string()).optional(),
+  selfLabels: zod.z.array(zod.z.string().max(128)).max(10).optional(),
   /**
    * Opt-in audio processing for this post's audio (denoise / trim /
    * transcribe / waveform). All default off. Stages the deployment can't

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<{
@@ -130,37 +130,20 @@ declare const CreateAudioPostRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObjec
         waveform: z.ZodOptional<z.ZodBoolean>;
         reprocess: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
+        waveform?: boolean | undefined;
+        transcribe?: boolean | undefined;
         denoise?: boolean | undefined;
         trim?: boolean | undefined;
-        transcribe?: boolean | undefined;
-        waveform?: boolean | undefined;
         reprocess?: boolean | undefined;
     }, {
+        waveform?: boolean | undefined;
+        transcribe?: boolean | undefined;
         denoise?: boolean | undefined;
         trim?: boolean | undefined;
-        transcribe?: boolean | undefined;
-        waveform?: boolean | undefined;
         reprocess?: boolean | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     text: string;
-    processing?: {
-        denoise?: boolean | undefined;
-        trim?: boolean | undefined;
-        transcribe?: boolean | undefined;
-        waveform?: boolean | undefined;
-        reprocess?: boolean | undefined;
-    } | undefined;
-    reply?: {
-        root: {
-            uri: string;
-            cid: string;
-        };
-        parent: {
-            uri: string;
-            cid: string;
-        };
-    } | undefined;
     title?: string | undefined;
     embed?: {
         $type: "dev.antiphony.embed.audio";
@@ -172,20 +155,9 @@ declare const CreateAudioPostRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObjec
             mimeType: string;
             size: number;
         };
-        waveform?: number[] | undefined;
         durationMs?: number | undefined;
         alt?: string | undefined;
-    } | undefined;
-    langs?: string[] | undefined;
-    selfLabels?: string[] | undefined;
-}, {
-    text?: string | undefined;
-    processing?: {
-        denoise?: boolean | undefined;
-        trim?: boolean | undefined;
-        transcribe?: boolean | undefined;
-        waveform?: boolean | undefined;
-        reprocess?: boolean | undefined;
+        waveform?: number[] | undefined;
     } | undefined;
     reply?: {
         root: {
@@ -197,6 +169,17 @@ declare const CreateAudioPostRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObjec
             cid: string;
         };
     } | undefined;
+    langs?: string[] | undefined;
+    selfLabels?: string[] | undefined;
+    processing?: {
+        waveform?: boolean | undefined;
+        transcribe?: boolean | undefined;
+        denoise?: boolean | undefined;
+        trim?: boolean | undefined;
+        reprocess?: boolean | undefined;
+    } | undefined;
+}, {
+    text?: string | undefined;
     title?: string | undefined;
     embed?: {
         $type: "dev.antiphony.embed.audio";
@@ -208,20 +191,9 @@ declare const CreateAudioPostRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObjec
             mimeType: string;
             size: number;
         };
-        waveform?: number[] | undefined;
         durationMs?: number | undefined;
         alt?: string | undefined;
-    } | undefined;
-    langs?: string[] | undefined;
-    selfLabels?: string[] | undefined;
-}>, {
-    text: string;
-    processing?: {
-        denoise?: boolean | undefined;
-        trim?: boolean | undefined;
-        transcribe?: boolean | undefined;
-        waveform?: boolean | undefined;
-        reprocess?: boolean | undefined;
+        waveform?: number[] | undefined;
     } | undefined;
     reply?: {
         root: {
@@ -233,6 +205,17 @@ declare const CreateAudioPostRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObjec
             cid: string;
         };
     } | undefined;
+    langs?: string[] | undefined;
+    selfLabels?: string[] | undefined;
+    processing?: {
+        waveform?: boolean | undefined;
+        transcribe?: boolean | undefined;
+        denoise?: boolean | undefined;
+        trim?: boolean | undefined;
+        reprocess?: boolean | undefined;
+    } | undefined;
+}>, {
+    text: string;
     title?: string | undefined;
     embed?: {
         $type: "dev.antiphony.embed.audio";
@@ -244,20 +227,9 @@ declare const CreateAudioPostRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObjec
             mimeType: string;
             size: number;
         };
-        waveform?: number[] | undefined;
         durationMs?: number | undefined;
         alt?: string | undefined;
-    } | undefined;
-    langs?: string[] | undefined;
-    selfLabels?: string[] | undefined;
-}, {
-    text?: string | undefined;
-    processing?: {
-        denoise?: boolean | undefined;
-        trim?: boolean | undefined;
-        transcribe?: boolean | undefined;
-        waveform?: boolean | undefined;
-        reprocess?: boolean | undefined;
+        waveform?: number[] | undefined;
     } | undefined;
     reply?: {
         root: {
@@ -269,6 +241,17 @@ declare const CreateAudioPostRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObjec
             cid: string;
         };
     } | undefined;
+    langs?: string[] | undefined;
+    selfLabels?: string[] | undefined;
+    processing?: {
+        waveform?: boolean | undefined;
+        transcribe?: boolean | undefined;
+        denoise?: boolean | undefined;
+        trim?: boolean | undefined;
+        reprocess?: boolean | undefined;
+    } | undefined;
+}, {
+    text?: string | undefined;
     title?: string | undefined;
     embed?: {
         $type: "dev.antiphony.embed.audio";
@@ -280,20 +263,9 @@ declare const CreateAudioPostRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObjec
             mimeType: string;
             size: number;
         };
-        waveform?: number[] | undefined;
         durationMs?: number | undefined;
         alt?: string | undefined;
-    } | undefined;
-    langs?: string[] | undefined;
-    selfLabels?: string[] | undefined;
-}>, {
-    text: string;
-    processing?: {
-        denoise?: boolean | undefined;
-        trim?: boolean | undefined;
-        transcribe?: boolean | undefined;
-        waveform?: boolean | undefined;
-        reprocess?: boolean | undefined;
+        waveform?: number[] | undefined;
     } | undefined;
     reply?: {
         root: {
@@ -305,6 +277,17 @@ declare const CreateAudioPostRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObjec
             cid: string;
         };
     } | undefined;
+    langs?: string[] | undefined;
+    selfLabels?: string[] | undefined;
+    processing?: {
+        waveform?: boolean | undefined;
+        transcribe?: boolean | undefined;
+        denoise?: boolean | undefined;
+        trim?: boolean | undefined;
+        reprocess?: boolean | undefined;
+    } | undefined;
+}>, {
+    text: string;
     title?: string | undefined;
     embed?: {
         $type: "dev.antiphony.embed.audio";
@@ -316,20 +299,9 @@ declare const CreateAudioPostRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObjec
             mimeType: string;
             size: number;
         };
-        waveform?: number[] | undefined;
         durationMs?: number | undefined;
         alt?: string | undefined;
-    } | undefined;
-    langs?: string[] | undefined;
-    selfLabels?: string[] | undefined;
-}, {
-    text?: string | undefined;
-    processing?: {
-        denoise?: boolean | undefined;
-        trim?: boolean | undefined;
-        transcribe?: boolean | undefined;
-        waveform?: boolean | undefined;
-        reprocess?: boolean | undefined;
+        waveform?: number[] | undefined;
     } | undefined;
     reply?: {
         root: {
@@ -341,6 +313,17 @@ declare const CreateAudioPostRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObjec
             cid: string;
         };
     } | undefined;
+    langs?: string[] | undefined;
+    selfLabels?: string[] | undefined;
+    processing?: {
+        waveform?: boolean | undefined;
+        transcribe?: boolean | undefined;
+        denoise?: boolean | undefined;
+        trim?: boolean | undefined;
+        reprocess?: boolean | undefined;
+    } | undefined;
+}, {
+    text?: string | undefined;
     title?: string | undefined;
     embed?: {
         $type: "dev.antiphony.embed.audio";
@@ -352,12 +335,29 @@ 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;
+    reply?: {
+        root: {
+            uri: string;
+            cid: string;
+        };
+        parent: {
+            uri: string;
+            cid: string;
+        };
     } | undefined;
     langs?: string[] | undefined;
     selfLabels?: string[] | undefined;
+    processing?: {
+        waveform?: boolean | undefined;
+        transcribe?: boolean | undefined;
+        denoise?: boolean | undefined;
+        trim?: boolean | undefined;
+        reprocess?: boolean | undefined;
+    } | undefined;
 }>;
 type CreateAudioPostRequest = z.infer<typeof CreateAudioPostRequestSchema>;
 /**
@@ -379,32 +379,32 @@ declare const PatchAudioPostRequestSchema: z.ZodObject<{
         waveform: z.ZodOptional<z.ZodBoolean>;
         reprocess: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
+        waveform?: boolean | undefined;
+        transcribe?: boolean | undefined;
         denoise?: boolean | undefined;
         trim?: boolean | undefined;
-        transcribe?: boolean | undefined;
-        waveform?: boolean | undefined;
         reprocess?: boolean | undefined;
     }, {
+        waveform?: boolean | undefined;
+        transcribe?: boolean | undefined;
         denoise?: boolean | undefined;
         trim?: boolean | undefined;
-        transcribe?: boolean | undefined;
-        waveform?: boolean | undefined;
         reprocess?: boolean | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
     processing: {
+        waveform?: boolean | undefined;
+        transcribe?: boolean | undefined;
         denoise?: boolean | undefined;
         trim?: boolean | undefined;
-        transcribe?: boolean | undefined;
-        waveform?: boolean | undefined;
         reprocess?: boolean | undefined;
     };
 }, {
     processing: {
+        waveform?: boolean | undefined;
+        transcribe?: boolean | undefined;
         denoise?: boolean | undefined;
         trim?: boolean | undefined;
-        transcribe?: boolean | undefined;
-        waveform?: boolean | undefined;
         reprocess?: boolean | undefined;
     };
 }>;

package/dist/cjs/index.cjs

@@ -111,6 +111,30 @@ var ProcessingStateSchema = ResolvedProcessingSchema.extend({
    * (i.e. trim). Absent when the variant's duration matches the original.
    */
   processedDurationMs: zod.z.number().int().min(0).optional(),
+  /**
+   * Which denoiser produced the variant's denoise contribution — provenance,
+   * the counterpart to a transcript record's `model`.
+   *
+   * Lives here because a cleaned variant, unlike a transcript, has no record
+   * of its own to carry it: it is a blob CID on this state. Without it,
+   * changing denoisers leaves no way to tell which variants predate the
+   * switch, so nothing can identify what to re-run.
+   *
+   * Named for the STAGE, not the variant (`processedModel`), because it
+   * describes one link of the byte-mutating chain rather than the composed
+   * artifact. Trim contributes to the same variant and has no model, and a
+   * later external link would want its own field rather than to overwrite
+   * this one.
+   *
+   * Written on every successful denoise, never cleared — it moves with
+   * `processedBlobCid`, which is only ever set, never reset. A denoise that
+   * FAILS leaves both alone, which is correct: the variant still holds the
+   * previous denoiser's output, so the previous model still describes it.
+   *
+   * Internal, like the other variant fields — `toProcessingView` projects
+   * stages only, so this never reaches a client.
+   */
+  denoiseModel: zod.z.string().optional(),
   /**
    * Peaks for the processed variant, once the `waveform` stage completes.
    * Same normalization and bounds as `embed.waveform` (0–100, max 1000), so
@@ -160,11 +184,14 @@ function resolveAudioVariant(canonical, state) {
     waveform: peaksAreCurrent ? state.waveformPeaks : canonical.waveform
   };
 }
+function httpsUrl() {
+  return zod.z.string().trim().url().regex(/^https?:\/\//i, { message: "URL must use the http or https scheme" });
+}
 
 // types/audio.ts
 var StrongRefSchema = zod.z.object({
-  uri: zod.z.string().regex(/^at:\/\/.+/, "Must be an at:// URI"),
-  cid: zod.z.string()
+  uri: zod.z.string().regex(/^at:\/\/.+/, "Must be an at:// URI").max(512),
+  cid: zod.z.string().max(128)
 });
 var ReplyRefSchema = zod.z.object({
   root: StrongRefSchema,
@@ -206,8 +233,13 @@ var AudioEmbedViewSchema = zod.z.object({
    * 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.
+   *
+   * Restricted to `http:`/`https:` (`httpsUrl()`), not any URL `new URL()`
+   * will parse. This is the value clients hand to `<audio src>`, so a
+   * `javascript:` or `data:` URL reaching one is stored XSS — and a bare
+   * `.url()` accepts both. See `types/url.ts`.
    */
-  url: zod.z.string().url(),
+  url: httpsUrl(),
   durationMs: zod.z.number().int().min(0).optional(),
   // `alt` is copied from the stored embed; keep the same bounds so a view can
   // never carry a larger payload than the record allows.
@@ -311,7 +343,13 @@ var TranscriptEnrichmentRecordSchema = zod.z.object({
 var ActorProfileRecordSchema = zod.z.object({
   handle: zod.z.string().min(3).max(20).optional(),
   usageIntent: zod.z.string().max(100).optional(),
-  rssFeed: zod.z.string().url().optional()
+  /**
+   * Feed URL, restricted to `http:`/`https:` for the same reason
+   * `AudioEmbedView.url` is: an app renders this as an `<a href>`, and a bare
+   * `.url()` would let a `javascript:` URL through. A feed is a fetchable web
+   * document, so no legitimate value loses anything to the restriction.
+   */
+  rssFeed: httpsUrl().optional()
 });
 var ViewerStateSchema = zod.z.object({
   /** True when the authenticated caller authored this post. */
@@ -326,10 +364,15 @@ var ViewerStateSchema = zod.z.object({
   replyDisabledReason: zod.z.enum(["unauthenticated", "not_a_participant"]).optional()
 });
 var PostRecordPublicSchema = zod.z.object({
-  text: zod.z.string(),
-  title: zod.z.string().optional(),
+  // `text`, `title` and `langs` keep the record's bounds, for the same reason
+  // `AudioEmbedViewSchema.alt` does: a view must never be able to carry a
+  // larger payload than the record it projects. The write path already
+  // enforces these, so no stored post can exceed them — stating them here
+  // keeps the published contract honest rather than adding a new constraint.
+  text: zod.z.string().max(3e3),
+  title: zod.z.string().max(3e3).optional(),
   reply: ReplyRefSchema.optional(),
-  langs: zod.z.array(zod.z.string()).optional(),
+  langs: zod.z.array(zod.z.string()).max(3).optional(),
   selfLabels: zod.z.array(zod.z.string()).optional(),
   createdAt: FirestoreTimestampSchema
 });
@@ -360,9 +403,9 @@ var CreateAudioPostRequestSchema = zod.z.object({
   /** Present ⇒ this is a reply (StrongRef root + parent). */
   reply: ReplyRefSchema.optional(),
   /** BCP-47 language tags. */
-  langs: zod.z.array(zod.z.string()).max(3).optional(),
+  langs: zod.z.array(zod.z.string().max(35)).max(3).optional(),
   /** Author self-label values (content warnings). */
-  selfLabels: zod.z.array(zod.z.string()).optional(),
+  selfLabels: zod.z.array(zod.z.string().max(128)).max(10).optional(),
   /**
    * Opt-in audio processing for this post's audio (denoise / trim /
    * transcribe / waveform). All default off. Stages the deployment can't
@@ -401,6 +444,15 @@ var EMBED_NSID = {
   Audio: "dev.antiphony.embed.audio",
   RecordWithAudio: "dev.antiphony.embed.recordWithAudio"
 };
+var XRPC_NSID = {
+  // Queries (GET).
+  GetPost: "dev.antiphony.audio.getPost",
+  GetThread: "dev.antiphony.audio.getThread",
+  GetPlaybackUrl: "dev.antiphony.audio.getPlaybackUrl",
+  // Procedures (POST).
+  CreatePost: "dev.antiphony.audio.createPost",
+  ReprocessPost: "dev.antiphony.audio.reprocessPost"
+};
 var COLLECTIONS = {
   // One post collection + the transcript enrichment namespace.
   [NSID.AudioPost]: "posts",
@@ -532,7 +584,9 @@ exports.TranscriptSegmentSchema = TranscriptSegmentSchema;
 exports.UnauthorizedError = UnauthorizedError;
 exports.ValidationError = ValidationError;
 exports.ViewerStateSchema = ViewerStateSchema;
+exports.XRPC_NSID = XRPC_NSID;
 exports.buildReportedErrorEvent = buildReportedErrorEvent;
+exports.httpsUrl = httpsUrl;
 exports.isFirestoreTimestamp = isFirestoreTimestamp;
 exports.reportError = reportError;
 exports.resolveAudioVariant = resolveAudioVariant;