@antiphony/shared 0.3.0 → 0.5.0

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

@@ -16,17 +16,27 @@ declare const CreateAudioPostRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObjec
         $type: z.ZodLiteral<"dev.antiphony.embed.audio">;
         audio: z.ZodObject<{
             $type: z.ZodLiteral<"blob">;
-            ref: z.ZodString;
+            ref: z.ZodObject<{
+                $link: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                $link: string;
+            }, {
+                $link: string;
+            }>;
             mimeType: z.ZodString;
             size: z.ZodNumber;
         }, "strip", z.ZodTypeAny, {
             $type: "blob";
-            ref: string;
+            ref: {
+                $link: string;
+            };
             mimeType: string;
             size: number;
         }, {
             $type: "blob";
-            ref: string;
+            ref: {
+                $link: string;
+            };
             mimeType: string;
             size: number;
         }>;
@@ -37,24 +47,28 @@ declare const CreateAudioPostRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObjec
         $type: "dev.antiphony.embed.audio";
         audio: {
             $type: "blob";
-            ref: string;
+            ref: {
+                $link: string;
+            };
             mimeType: string;
             size: number;
         };
+        waveform?: number[] | undefined;
         durationMs?: number | undefined;
         alt?: string | undefined;
-        waveform?: number[] | undefined;
     }, {
         $type: "dev.antiphony.embed.audio";
         audio: {
             $type: "blob";
-            ref: string;
+            ref: {
+                $link: string;
+            };
             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<{
@@ -101,20 +115,41 @@ declare const CreateAudioPostRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObjec
     langs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     /** Author self-label values (content warnings). */
     selfLabels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * 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, {
+        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;
-    title?: string | undefined;
-    embed?: {
-        $type: "dev.antiphony.embed.audio";
-        audio: {
-            $type: "blob";
-            ref: string;
-            mimeType: string;
-            size: number;
-        };
-        durationMs?: number | undefined;
-        alt?: string | undefined;
-        waveform?: number[] | undefined;
+    processing?: {
+        denoise?: boolean | undefined;
+        trim?: boolean | undefined;
+        transcribe?: boolean | undefined;
+        waveform?: boolean | undefined;
+        reprocess?: boolean | undefined;
     } | undefined;
     reply?: {
         root: {
@@ -126,22 +161,31 @@ declare const CreateAudioPostRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObjec
             cid: string;
         };
     } | undefined;
-    langs?: string[] | undefined;
-    selfLabels?: string[] | undefined;
-}, {
-    text?: string | undefined;
     title?: string | undefined;
     embed?: {
         $type: "dev.antiphony.embed.audio";
         audio: {
             $type: "blob";
-            ref: string;
+            ref: {
+                $link: string;
+            };
             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?: {
+        denoise?: boolean | undefined;
+        trim?: boolean | undefined;
+        transcribe?: boolean | undefined;
+        waveform?: boolean | undefined;
+        reprocess?: boolean | undefined;
     } | undefined;
     reply?: {
         root: {
@@ -153,22 +197,31 @@ declare const CreateAudioPostRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObjec
             cid: string;
         };
     } | undefined;
-    langs?: string[] | undefined;
-    selfLabels?: string[] | undefined;
-}>, {
-    text: string;
     title?: string | undefined;
     embed?: {
         $type: "dev.antiphony.embed.audio";
         audio: {
             $type: "blob";
-            ref: string;
+            ref: {
+                $link: string;
+            };
             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?: {
+        denoise?: boolean | undefined;
+        trim?: boolean | undefined;
+        transcribe?: boolean | undefined;
+        waveform?: boolean | undefined;
+        reprocess?: boolean | undefined;
     } | undefined;
     reply?: {
         root: {
@@ -180,22 +233,31 @@ declare const CreateAudioPostRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObjec
             cid: string;
         };
     } | undefined;
-    langs?: string[] | undefined;
-    selfLabels?: string[] | undefined;
-}, {
-    text?: string | undefined;
     title?: string | undefined;
     embed?: {
         $type: "dev.antiphony.embed.audio";
         audio: {
             $type: "blob";
-            ref: string;
+            ref: {
+                $link: string;
+            };
             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?: {
+        denoise?: boolean | undefined;
+        trim?: boolean | undefined;
+        transcribe?: boolean | undefined;
+        waveform?: boolean | undefined;
+        reprocess?: boolean | undefined;
     } | undefined;
     reply?: {
         root: {
@@ -207,22 +269,31 @@ declare const CreateAudioPostRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObjec
             cid: string;
         };
     } | undefined;
-    langs?: string[] | undefined;
-    selfLabels?: string[] | undefined;
-}>, {
-    text: string;
     title?: string | undefined;
     embed?: {
         $type: "dev.antiphony.embed.audio";
         audio: {
             $type: "blob";
-            ref: string;
+            ref: {
+                $link: string;
+            };
             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?: {
+        denoise?: boolean | undefined;
+        trim?: boolean | undefined;
+        transcribe?: boolean | undefined;
+        waveform?: boolean | undefined;
+        reprocess?: boolean | undefined;
     } | undefined;
     reply?: {
         root: {
@@ -234,22 +305,31 @@ declare const CreateAudioPostRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObjec
             cid: string;
         };
     } | undefined;
-    langs?: string[] | undefined;
-    selfLabels?: string[] | undefined;
-}, {
-    text?: string | undefined;
     title?: string | undefined;
     embed?: {
         $type: "dev.antiphony.embed.audio";
         audio: {
             $type: "blob";
-            ref: string;
+            ref: {
+                $link: string;
+            };
             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?: {
+        denoise?: boolean | undefined;
+        trim?: boolean | undefined;
+        transcribe?: boolean | undefined;
+        waveform?: boolean | undefined;
+        reprocess?: boolean | undefined;
     } | undefined;
     reply?: {
         root: {
@@ -261,64 +341,73 @@ declare const CreateAudioPostRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObjec
             cid: string;
         };
     } | undefined;
+    title?: string | undefined;
+    embed?: {
+        $type: "dev.antiphony.embed.audio";
+        audio: {
+            $type: "blob";
+            ref: {
+                $link: string;
+            };
+            mimeType: string;
+            size: number;
+        };
+        waveform?: number[] | undefined;
+        durationMs?: number | undefined;
+        alt?: string | undefined;
+    } | undefined;
     langs?: string[] | undefined;
     selfLabels?: string[] | undefined;
 }>;
 type CreateAudioPostRequest = z.infer<typeof CreateAudioPostRequestSchema>;
 /**
- * Update-request codec for the authenticated actor's own profile
- * (`PATCH /api/v1/users/me`). Partial-update of identity fields only.
+ * Patch-request codec for the canonical Antiphony `dev.antiphony.audio.post`
+ * model. **Processing opt-in is the ONLY thing a PATCH may change** — it
+ * re-triggers async audio enrichment (transcribe / denoise) on an existing
+ * post. No lexicon fields are editable here: those feed the record CID (its
+ * content address / identity), so a content edit would mint a different record.
+ * Processing state is storage-layer, so this changes no CID. See
+ * `types/processing.ts`.
  */
-declare const UpdateProfileRequestSchema: z.ZodObject<{
-    handle: z.ZodOptional<z.ZodString>;
-    displayName: z.ZodOptional<z.ZodString>;
-    bio: z.ZodOptional<z.ZodString>;
-    avatarUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    usageIntent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    /**
-     * Personal website surfaced on the public profile. Accepts a URL, empty
-     * string, or null from the client; normalizes empty string → null so the
-     * value stored on `UserRecord` (which requires `.url() | null`) round-trips
-     * cleanly through `UserRecordSchema.parse` on subsequent reads.
-     */
-    website: z.ZodEffects<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodLiteral<"">, z.ZodNull]>>, string | null | undefined, string | null | undefined>;
-    /** Up to 5 public links (label + URL) shown under the bio. */
-    links: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        label: z.ZodString;
-        url: z.ZodString;
+declare const PatchAudioPostRequestSchema: z.ZodObject<{
+    /** Opt-in audio processing to (re)run for this post's audio. Required — a
+     *  PATCH with no processing request is a no-op and rejected as invalid. */
+    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, {
-        label: string;
-        url: string;
+        denoise?: boolean | undefined;
+        trim?: boolean | undefined;
+        transcribe?: boolean | undefined;
+        waveform?: boolean | undefined;
+        reprocess?: boolean | undefined;
     }, {
-        label: string;
-        url: string;
-    }>, "many">>;
-    /** When true, surfaces the linked Bluesky identity on the public profile. */
-    showBlueskyPublicly: z.ZodOptional<z.ZodBoolean>;
+        denoise?: boolean | undefined;
+        trim?: boolean | undefined;
+        transcribe?: boolean | undefined;
+        waveform?: boolean | undefined;
+        reprocess?: boolean | undefined;
+    }>;
 }, "strip", z.ZodTypeAny, {
-    handle?: string | undefined;
-    displayName?: string | undefined;
-    bio?: string | undefined;
-    avatarUrl?: string | null | undefined;
-    usageIntent?: string | null | undefined;
-    website?: string | null | undefined;
-    links?: {
-        label: string;
-        url: string;
-    }[] | undefined;
-    showBlueskyPublicly?: boolean | undefined;
+    processing: {
+        denoise?: boolean | undefined;
+        trim?: boolean | undefined;
+        transcribe?: boolean | undefined;
+        waveform?: boolean | undefined;
+        reprocess?: boolean | undefined;
+    };
 }, {
-    handle?: string | undefined;
-    displayName?: string | undefined;
-    bio?: string | undefined;
-    avatarUrl?: string | null | undefined;
-    usageIntent?: string | null | undefined;
-    website?: string | null | undefined;
-    links?: {
-        label: string;
-        url: string;
-    }[] | undefined;
-    showBlueskyPublicly?: boolean | undefined;
+    processing: {
+        denoise?: boolean | undefined;
+        trim?: boolean | undefined;
+        transcribe?: boolean | undefined;
+        waveform?: boolean | undefined;
+        reprocess?: boolean | undefined;
+    };
 }>;
+type PatchAudioPostRequest = z.infer<typeof PatchAudioPostRequestSchema>;
 
-export { type CreateAudioPostRequest, CreateAudioPostRequestSchema, UpdateProfileRequestSchema };
+export { type CreateAudioPostRequest, CreateAudioPostRequestSchema, type PatchAudioPostRequest, PatchAudioPostRequestSchema };

package/dist/esm/api-codecs.js

@@ -1,6 +1,5 @@
-export { CreateAudioPostRequestSchema, UpdateProfileRequestSchema } from './chunk-FDM5FDN4.js';
-import './chunk-F7IHVM34.js';
-import './chunk-5EHV73BA.js';
-import './chunk-R6SBR3IG.js';
-import './chunk-IHIBHQBJ.js';
+export { CreateAudioPostRequestSchema, PatchAudioPostRequestSchema } from './chunk-F5ZKFJL2.js';
+import './chunk-TVOXIQKF.js';
+import './chunk-D655OH2I.js';
+import './chunk-SMK4OZNU.js';
 import './chunk-5JBD5THX.js';

package/dist/esm/chunk-D655OH2I.js

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+
+// types/records.ts
+var FirestoreTimestampSchema = z.union([
+  z.custom((data) => {
+    return data && typeof data === "object" && (typeof data.toDate === "function" || "seconds" in data && "nanoseconds" in data);
+  }),
+  z.string(),
+  z.number(),
+  z.date()
+]).transform((data, ctx) => {
+  let date;
+  if (data instanceof Date) {
+    date = data;
+  } else if (typeof data === "string") {
+    date = new Date(data);
+  } else if (typeof data === "number") {
+    date = new Date(data);
+  } else if (typeof data.toDate === "function") {
+    date = data.toDate();
+  } else {
+    const timestamp = data;
+    date = new Date(timestamp.seconds * 1e3 + timestamp.nanoseconds / 1e6);
+  }
+  if (Number.isNaN(date.getTime())) {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      message: "FirestoreTimestamp coerced to Invalid Date"
+    });
+    return z.NEVER;
+  }
+  return date;
+});
+
+export { FirestoreTimestampSchema };

package/dist/esm/chunk-F5ZKFJL2.js

@@ -0,0 +1,39 @@
+import { ProcessingRequestSchema, ReplyRefSchema, AudioEmbedSchema } from './chunk-TVOXIQKF.js';
+import { z } from 'zod';
+
+var CreateAudioPostRequestSchema = z.object({
+  /** User-authored text; may be empty for pure-audio posts. */
+  text: z.string().max(3e3).default(""),
+  /** Optional headline (prompt feature). */
+  title: z.string().max(3e3).optional(),
+  /** The uploaded audio attachment. */
+  embed: AudioEmbedSchema.optional(),
+  /** Present ⇒ this is a reply (StrongRef root + parent). */
+  reply: ReplyRefSchema.optional(),
+  /** BCP-47 language tags. */
+  langs: z.array(z.string()).max(3).optional(),
+  /** Author self-label values (content warnings). */
+  selfLabels: z.array(z.string()).optional(),
+  /**
+   * 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()
+}).refine((d) => !(d.reply && d.title), {
+  message: "Replies cannot have a title",
+  path: ["title"]
+}).refine((d) => d.text.trim().length > 0 || !!d.embed, {
+  message: "Post must have text or an audio embed",
+  path: ["text"]
+});
+var PatchAudioPostRequestSchema = z.object({
+  /** Opt-in audio processing to (re)run for this post's audio. Required — a
+   *  PATCH with no processing request is a no-op and rejected as invalid. */
+  processing: ProcessingRequestSchema
+});
+
+export { CreateAudioPostRequestSchema, PatchAudioPostRequestSchema };

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

@@ -4,6 +4,10 @@ var NSID = {
   // See lexicons/dev/antiphony/ + packages/shared/types/audio.ts.
   AudioPost: "dev.antiphony.audio.post",
   AudioTranscript: "dev.antiphony.audio.transcript",
+  // Portable lexicon only — the core never stores actor profiles; the
+  // caller BFF is the sole authority for profile data (see
+  // specs/core-bff-boundary.md, "actor.profile lexicon"). Hence no
+  // COLLECTIONS entry below.
   ActorProfile: "dev.antiphony.actor.profile"
 };
 var EMBED_NSID = {
@@ -11,15 +15,9 @@ var EMBED_NSID = {
   RecordWithAudio: "dev.antiphony.embed.recordWithAudio"
 };
 var COLLECTIONS = {
-  // One post collection + the transcript enrichment namespace + actors.
+  // One post collection + the transcript enrichment namespace.
   [NSID.AudioPost]: "posts",
-  [NSID.AudioTranscript]: "audio_transcripts",
-  [NSID.ActorProfile]: "users"
+  [NSID.AudioTranscript]: "audio_transcripts"
 };
-function nsidForCollection(collection) {
-  const entries = Object.entries(COLLECTIONS);
-  const match = entries.find(([, col]) => col === collection);
-  return match == null ? void 0 : match[0];
-}
 
-export { COLLECTIONS, EMBED_NSID, NSID, nsidForCollection };
+export { COLLECTIONS, EMBED_NSID, NSID };

package/dist/esm/chunk-SMK4OZNU.js

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+
+// types/blob.ts
+var BlobRefSchema = z.object({
+  /** Discriminator for AT Protocol type system */
+  $type: z.literal("blob"),
+  /** IPLD link to the blob bytes: the content CID. */
+  ref: z.object({
+    $link: z.string().min(1)
+  }),
+  /** MIME type of the blob (e.g., 'audio/webm') */
+  mimeType: z.string(),
+  /** Size of the blob in bytes */
+  size: z.number().int().min(0)
+});
+
+export { BlobRefSchema };