@antiphony/shared 0.5.0 → 0.6.0

package/dist/esm/api-codecs.d.ts

@@ -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/esm/api-codecs.js

@@ -1,5 +1,7 @@
-export { CreateAudioPostRequestSchema, PatchAudioPostRequestSchema } from './chunk-F5ZKFJL2.js';
-import './chunk-TVOXIQKF.js';
-import './chunk-D655OH2I.js';
+export { CreateAudioPostRequestSchema, PatchAudioPostRequestSchema } from './chunk-6EJLU4LG.js';
+import './chunk-QQ5GOLYW.js';
 import './chunk-SMK4OZNU.js';
+import './chunk-AKIWUNNK.js';
+import './chunk-D655OH2I.js';
+import './chunk-KMQWUFMV.js';
 import './chunk-5JBD5THX.js';

package/dist/esm/{chunk-F5ZKFJL2.js → chunk-6EJLU4LG.js}

@@ -1,4 +1,5 @@
-import { ProcessingRequestSchema, ReplyRefSchema, AudioEmbedSchema } from './chunk-TVOXIQKF.js';
+import { ReplyRefSchema, AudioEmbedSchema } from './chunk-QQ5GOLYW.js';
+import { ProcessingRequestSchema } from './chunk-AKIWUNNK.js';
 import { z } from 'zod';
 
 var CreateAudioPostRequestSchema = z.object({
@@ -11,9 +12,9 @@ var CreateAudioPostRequestSchema = z.object({
   /** Present ⇒ this is a reply (StrongRef root + parent). */
   reply: ReplyRefSchema.optional(),
   /** BCP-47 language tags. */
-  langs: z.array(z.string()).max(3).optional(),
+  langs: z.array(z.string().max(35)).max(3).optional(),
   /** Author self-label values (content warnings). */
-  selfLabels: z.array(z.string()).optional(),
+  selfLabels: z.array(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/esm/chunk-AKIWUNNK.js

@@ -0,0 +1,129 @@
+import { FirestoreTimestampSchema } from './chunk-D655OH2I.js';
+import { z } from 'zod';
+
+var ProcessingStageStatusSchema = z.enum(["pending", "ready", "failed", "skipped"]);
+var PROCESSING_STAGES = ["denoise", "trim", "transcribe", "waveform"];
+var ProcessingStageSchema = z.enum(PROCESSING_STAGES);
+var BYTE_MUTATING_STAGES = ["denoise", "trim"];
+var DERIVED_STAGES = ["transcribe", "waveform"];
+var ProcessingRequestSchema = z.object({
+  transcribe: z.boolean().optional(),
+  denoise: z.boolean().optional(),
+  trim: z.boolean().optional(),
+  waveform: 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: z.boolean().optional()
+});
+var ProcessingStageMapSchema = z.object({
+  transcribe: ProcessingStageStatusSchema.optional(),
+  denoise: ProcessingStageStatusSchema.optional(),
+  trim: ProcessingStageStatusSchema.optional(),
+  waveform: ProcessingStageStatusSchema.optional()
+});
+var ResolvedProcessingSchema = ProcessingStageMapSchema.extend({
+  reprocess: 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: 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: 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: 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: 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
+   * a view can never carry a larger payload than the record allows.
+   */
+  waveformPeaks: z.array(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
+  };
+}
+
+export { BYTE_MUTATING_STAGES, DERIVED_STAGES, PROCESSING_STAGES, ProcessingRequestSchema, ProcessingStageMapSchema, ProcessingStageSchema, ProcessingStageStatusSchema, ProcessingStateSchema, ProcessingViewSchema, ResolvedProcessingSchema, resolveAudioVariant, toProcessingView };

package/dist/esm/{chunk-SBYNIQRZ.js → chunk-F5RKN3GY.js}

@@ -14,10 +14,19 @@ 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",
   [NSID.AudioTranscript]: "audio_transcripts"
 };
 
-export { COLLECTIONS, EMBED_NSID, NSID };
+export { COLLECTIONS, EMBED_NSID, NSID, XRPC_NSID };

package/dist/esm/chunk-KMQWUFMV.js

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+
+// types/url.ts
+function httpsUrl() {
+  return z.string().trim().url().regex(/^https?:\/\//i, { message: "URL must use the http or https scheme" });
+}
+
+export { httpsUrl };