@antiphony/shared 0.3.0 → 0.4.0

package/dist/cjs/index.cjs

@@ -21,23 +21,15 @@ var __spreadValues = (a, b) => {
 var BlobRefSchema = zod.z.object({
   /** Discriminator for AT Protocol type system */
   $type: zod.z.literal("blob"),
-  /** Content Identifier (CID) or URL pointing to the blob */
-  ref: zod.z.string(),
+  /** IPLD link to the blob bytes: the content CID. */
+  ref: zod.z.object({
+    $link: zod.z.string().min(1)
+  }),
   /** MIME type of the blob (e.g., 'audio/webm') */
   mimeType: zod.z.string(),
   /** Size of the blob in bytes */
-  size: zod.z.number()
+  size: zod.z.number().int().min(0)
 });
-function resolveAudioUrl(record) {
-  var _a;
-  if ((_a = record.audio) == null ? void 0 : _a.ref) return record.audio.ref;
-  return record.audioUrl;
-}
-function httpsUrl() {
-  return zod.z.string().trim().url().refine((u) => /^https?:\/\//i.test(u), {
-    message: "URL must use the http or https scheme"
-  });
-}
 var FirestoreTimestampSchema = zod.z.union([
   zod.z.custom((data) => {
     return data && typeof data === "object" && (typeof data.toDate === "function" || "seconds" in data && "nanoseconds" in data);
@@ -68,136 +60,22 @@ var FirestoreTimestampSchema = zod.z.union([
   }
   return date;
 });
-var UserRecordSchema = zod.z.object({
-  /** Unique Firebase UID */
-  id: zod.z.string(),
-  /** Public handle (e.g. @brad). Optional for Lite Users. */
-  handle: zod.z.string().min(3).max(20).regex(/^[a-zA-Z0-9_]+$/).nullable().optional(),
-  /** User stated intent (e.g. "Podcaster", "Listener") */
-  usageIntent: zod.z.string().nullable().optional(),
-  /** Domain for federated handle support. */
-  domain: zod.z.string().default("antiphony.dev"),
-  /**
-   * Display Name (e.g. "Brad Thorson"). Nullable: Firestore stores `null`
-   * when the user clears this field via the settings form, and the schema
-   * must match storage reality or `UserRecordSchema.parse` (in
-   * `getUserRecordByUid`) will throw.
-   */
-  displayName: zod.z.string().max(50).nullable().optional(),
-  /** Short bio/description — nullable for the same reason as displayName. */
-  bio: zod.z.string().max(160).nullable().optional(),
-  /** URL to avatar image — nullable for the same reason as displayName. */
-  avatarUrl: zod.z.string().url().nullable().optional(),
-  /** Optional personal website surfaced on the public profile. */
-  website: httpsUrl().nullable().optional(),
-  /** Up to 5 additional public links (label + URL) shown under the bio. */
-  links: zod.z.array(zod.z.object({
-    label: zod.z.string().min(1).max(40),
-    url: httpsUrl()
-  })).max(5).optional(),
-  /** When true and a Bluesky identity is linked, surfaces it on the public profile. */
-  showBlueskyPublicly: zod.z.boolean().optional(),
-  /** Server timestamp of creation */
-  createdAt: FirestoreTimestampSchema,
-  /** Individual account tier — free or creator_pro */
-  tier: zod.z.enum(["free", "creator_pro"]).default("free"),
-  /** Account status. Deactivated accounts retain data but are excluded from lookups. */
-  status: zod.z.enum(["active", "deactivated"]).default("active"),
-  /** Timestamp when the account was deactivated (soft deleted) */
-  deactivatedAt: FirestoreTimestampSchema.optional()
+var ProcessingStageStatusSchema = zod.z.enum(["pending", "ready", "failed", "skipped"]);
+var ProcessingRequestSchema = zod.z.object({
+  transcribe: zod.z.boolean().optional(),
+  denoise: zod.z.boolean().optional()
 });
-var ProfileViewBasicSchema = zod.z.object({
-  id: zod.z.string(),
-  handle: zod.z.string().nullable().optional(),
-  // `displayName` and `bio` are `.nullable()` — Firestore stores `null` for
-  // empty values on these fields (see users-dependencies.ts), and Zod's
-  // `.optional()` alone rejects `null`. Consumers already use truthy
-  // checks / `??` / `||`, so widening the type to include `null` is safe.
-  displayName: zod.z.string().nullable().optional(),
-  avatarUrl: zod.z.string().nullable().optional(),
-  bio: zod.z.string().nullable().optional(),
-  /** Personal website link surfaced on the public profile. */
-  website: zod.z.string().nullable().optional(),
-  /** Public links (label + URL) shown under the bio. */
-  links: zod.z.array(zod.z.object({
-    label: zod.z.string(),
-    url: zod.z.string()
-  })).optional(),
-  /**
-   * AT Protocol identity, surfaced on the public profile only when the user
-   * opts in (`UserRecord.showBlueskyPublicly === true`). Projection happens
-   * in the user dependency layer; this schema simply allows the field.
-   */
-  bluesky: zod.z.object({
-    handle: zod.z.string(),
-    did: zod.z.string()
-  }).optional(),
-  stats: zod.z.object({
-    followers: zod.z.number().default(0),
-    following: zod.z.number().default(0),
-    prompts: zod.z.number().default(0)
-  }).optional(),
-  badges: zod.z.array(zod.z.string()).optional(),
-  isVerified: zod.z.boolean().optional(),
-  createdAt: FirestoreTimestampSchema.optional()
-});
-function toProfileViewBasic(profile) {
-  const { id, handle, displayName, avatarUrl, bio, website, links, bluesky, showBlueskyPublicly, stats, badges, isVerified, createdAt } = profile;
-  return {
-    id,
-    handle,
-    displayName,
-    avatarUrl,
-    bio,
-    website,
-    links,
-    bluesky: showBlueskyPublicly ? bluesky : void 0,
-    stats,
-    badges,
-    isVerified,
-    createdAt
-  };
-}
-var ProfileViewDetailedSchema = ProfileViewBasicSchema.extend({
-  /** AT Protocol Identity link */
-  bluesky: zod.z.object({
-    handle: zod.z.string(),
-    did: zod.z.string()
-  }).optional(),
-  usageIntent: zod.z.string().nullable().optional()
-});
-var ProfileViewSelfSchema = ProfileViewDetailedSchema.extend({
-  phoneNumber: zod.z.string().nullable().optional(),
-  email: zod.z.string().optional(),
-  lastSeenAt: FirestoreTimestampSchema.optional(),
-  lastActiveAt: FirestoreTimestampSchema.optional(),
-  unreadReplyCount: zod.z.number().default(0),
-  newReplierCount: zod.z.number().default(0),
-  /**
-   * Account tier from UserRecord — surfaced on the self profile so the
-   * client can gate paid features. Optional for legacy docs without the
-   * field; consumers should treat missing as `'free'`.
-   */
-  tier: zod.z.enum(["free", "creator_pro"]).optional(),
-  /**
-   * Surfaces the linked Bluesky identity (handle + DID) on the public profile
-   * when true. Persisted on UserRecord; exposed in self/detailed views so the
-   * settings form can render the toggle's current state.
-   */
-  showBlueskyPublicly: zod.z.boolean().optional(),
-  settings: zod.z.object({
-    notifications: zod.z.boolean().optional(),
-    theme: zod.z.string().optional()
-  }).optional()
+var ProcessingStateSchema = 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
 });
-var ProfileViewAdminSchema = ProfileViewSelfSchema.extend({
-  blockedUsers: zod.z.array(zod.z.string()).optional(),
-  followers: zod.z.array(zod.z.string()).optional(),
-  following: zod.z.array(zod.z.string()).optional(),
-  reportCount: zod.z.number().optional(),
-  isBanned: zod.z.boolean().optional()
+var ProcessingViewSchema = zod.z.object({
+  transcribe: ProcessingStageStatusSchema.optional(),
+  denoise: ProcessingStageStatusSchema.optional()
 });
-var ProfileViewSchema = ProfileViewAdminSchema;
 
 // types/audio.ts
 var StrongRefSchema = zod.z.object({
@@ -210,7 +88,7 @@ var ReplyRefSchema = zod.z.object({
 });
 var AudioEmbedSchema = zod.z.object({
   $type: zod.z.literal("dev.antiphony.embed.audio"),
-  /** The audio bytes as a content-addressed storage ref (CID/path). */
+  /** The audio bytes as a content-addressed blob ref (`ref.$link` = CID). */
   audio: BlobRefSchema,
   /** Duration in MILLISECONDS (platform-wide unit; not seconds). */
   durationMs: zod.z.number().int().min(0).optional(),
@@ -240,11 +118,26 @@ var AudioEmbedViewSchema = zod.z.object({
   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()
+  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`.
+   */
+  processing: ProcessingViewSchema.optional()
 });
 var AudioPostRecordSchema = zod.z.object({
   /** Storage id (rkey/doc id). */
   id: zod.z.string(),
+  /**
+   * Content CID of the canonical lexicon record (CIDv1, dag-cbor, sha2-256
+   * — the AT Protocol record-CID rule). Computed at write time over the
+   * lexicon projection (public fields only, NOT the storage/tenancy fields
+   * below), so StrongRefs built from it are verifiable content addresses.
+   */
+  cid: zod.z.string(),
   // --- Tenancy + facets (storage-indexed; NOT in the lexicon) ---
   /** Origin app that created this record — the multi-tenant isolation key. */
   originAppId: zod.z.string(),
@@ -262,9 +155,24 @@ var AudioPostRecordSchema = zod.z.object({
    * opened the branch. Set on replies (deduped, 1–2 ids); absent on prompts
    * (a prompt's repliers are the app's audience policy, not a fixed pair).
    * Inherited down the branch so reply gating is an O(1) field check, never a
-   * thread walk. See `specs/antiphony-data-model.md` §6 "Reply gating".
+   * thread walk.
    */
   threadParticipants: zod.z.array(zod.z.string()).optional(),
+  /**
+   * Author of this reply's thread ROOT (the prompt) — the reply's recipient,
+   * the person whose "replies to me" feed it lands in. Denormalized at write
+   * time so "replies whose root author is X" is a cheap composite-index query
+   * (see `queryByRootAuthor`). Set on replies (`kind === 'reply'`); absent on
+   * prompts. Storage-layer facet, NOT in the public lexicon or the record CID.
+   */
+  rootAuthorId: zod.z.string().optional(),
+  /**
+   * Async audio-processing state (transcribe / denoise), present iff the app
+   * opted into processing on create. Mutated by the processing worker after
+   * the post is created — storage-layer, NOT in the lexicon or the record
+   * CID. See `types/processing.ts`.
+   */
+  processing: ProcessingStateSchema.optional(),
   // --- Lexicon fields (public contract) ---
   /** User-authored text (bsky-semantic). May be empty for pure-audio posts. NEVER the transcript. */
   text: zod.z.string().max(3e3),
@@ -283,10 +191,11 @@ var AudioPostRecordSchema = zod.z.object({
 }).refine(
   // `kind` is denormalized from `reply` presence at write time; enforce the
   // invariant so an inconsistent record can't be written or read silently.
-  // A reply has `reply` and no `title`; a prompt has neither a `reply`.
-  (r) => r.kind === "reply" ? !!r.reply && r.title === void 0 : !r.reply,
+  // A reply has `reply`, no `title`, and a stamped `rootAuthorId` (its
+  // recipient facet); a prompt has none of those.
+  (r) => r.kind === "reply" ? !!r.reply && r.title === void 0 && r.rootAuthorId !== void 0 : !r.reply && r.rootAuthorId === void 0,
   {
-    message: "kind must match reply presence: 'reply' \u21D2 reply set & no title; 'prompt' \u21D2 no reply",
+    message: "kind must match reply presence: 'reply' \u21D2 reply set, no title, rootAuthorId set; 'prompt' \u21D2 no reply, no rootAuthorId",
     path: ["kind"]
   }
 );
@@ -329,9 +238,13 @@ var PostRecordPublicSchema = zod.z.object({
 var AudioPostViewSchema = zod.z.object({
   /** at:// URI (or internal ref) identifying the post. */
   uri: zod.z.string(),
-  cid: zod.z.string().optional(),
+  /** Content CID of the canonical record (see `AudioPostRecordSchema.cid`). */
+  cid: zod.z.string(),
   kind: zod.z.enum(["prompt", "reply"]),
-  author: ProfileViewBasicSchema,
+  /** The acting actor's app-scoped id — an opaque attribution ref, not a profile. */
+  authorId: zod.z.string(),
+  /** The author's app-asserted AT Protocol DID, when the caller provided one. */
+  authorDid: zod.z.string().optional(),
   record: PostRecordPublicSchema,
   /** Hydrated audio embed (signed URL + lifted transcript). */
   embed: AudioEmbedViewSchema.optional(),
@@ -351,7 +264,14 @@ var CreateAudioPostRequestSchema = zod.z.object({
   /** BCP-47 language tags. */
   langs: zod.z.array(zod.z.string()).max(3).optional(),
   /** Author self-label values (content warnings). */
-  selfLabels: zod.z.array(zod.z.string()).optional()
+  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
+   * `types/processing.ts`.
+   */
+  processing: ProcessingRequestSchema.optional()
 }).refine((d) => !(d.reply && d.title), {
   message: "Replies cannot have a title",
   path: ["title"]
@@ -359,34 +279,11 @@ var CreateAudioPostRequestSchema = zod.z.object({
   message: "Post must have text or an audio embed",
   path: ["text"]
 });
-var UpdateProfileRequestSchema = zod.z.object({
-  handle: zod.z.string().min(3).max(20).regex(/^[a-zA-Z0-9_]+$/).optional(),
-  displayName: zod.z.string().max(50).optional(),
-  bio: zod.z.string().max(160).optional(),
-  avatarUrl: zod.z.string().url().nullable().optional(),
-  usageIntent: zod.z.string().max(200).nullable().optional(),
-  /**
-   * 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: zod.z.union([zod.z.string().url(), zod.z.literal(""), zod.z.null()]).optional().transform((v) => v === "" ? null : v),
-  /** Up to 5 public links (label + URL) shown under the bio. */
-  links: zod.z.array(zod.z.object({
-    label: zod.z.string().min(1).max(40),
-    url: zod.z.string().url()
-  })).max(5).optional(),
-  /** When true, surfaces the linked Bluesky identity on the public profile. */
-  showBlueskyPublicly: zod.z.boolean().optional()
+var PatchAudioPostRequestSchema = zod.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
 });
-var PublicProfileDtoSchema = ProfileViewBasicSchema.extend({
-  bluesky: zod.z.object({
-    handle: zod.z.string(),
-    did: zod.z.string()
-  }).optional()
-});
-var ActorViewSchema = ProfileViewSelfSchema;
 
 // nsid.ts
 var NSID = {
@@ -394,6 +291,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 = {
@@ -401,16 +302,10 @@ 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];
-}
 
 // errors/index.ts
 var ServiceError = class extends Error {
@@ -502,7 +397,6 @@ function reportError(err, context) {
 }
 
 exports.ActorProfileRecordSchema = ActorProfileRecordSchema;
-exports.ActorViewSchema = ActorViewSchema;
 exports.AudioEmbedSchema = AudioEmbedSchema;
 exports.AudioEmbedViewSchema = AudioEmbedViewSchema;
 exports.AudioPostRecordSchema = AudioPostRecordSchema;
@@ -516,13 +410,12 @@ exports.FirestoreTimestampSchema = FirestoreTimestampSchema;
 exports.ForbiddenError = ForbiddenError;
 exports.NSID = NSID;
 exports.NotFoundError = NotFoundError;
+exports.PatchAudioPostRequestSchema = PatchAudioPostRequestSchema;
 exports.PostRecordPublicSchema = PostRecordPublicSchema;
-exports.ProfileViewAdminSchema = ProfileViewAdminSchema;
-exports.ProfileViewBasicSchema = ProfileViewBasicSchema;
-exports.ProfileViewDetailedSchema = ProfileViewDetailedSchema;
-exports.ProfileViewSchema = ProfileViewSchema;
-exports.ProfileViewSelfSchema = ProfileViewSelfSchema;
-exports.PublicProfileDtoSchema = PublicProfileDtoSchema;
+exports.ProcessingRequestSchema = ProcessingRequestSchema;
+exports.ProcessingStageStatusSchema = ProcessingStageStatusSchema;
+exports.ProcessingStateSchema = ProcessingStateSchema;
+exports.ProcessingViewSchema = ProcessingViewSchema;
 exports.RateLimitError = RateLimitError;
 exports.ReplyRefSchema = ReplyRefSchema;
 exports.ServiceError = ServiceError;
@@ -531,14 +424,8 @@ exports.TimedTranscriptSchema = TimedTranscriptSchema;
 exports.TranscriptEnrichmentRecordSchema = TranscriptEnrichmentRecordSchema;
 exports.TranscriptSegmentSchema = TranscriptSegmentSchema;
 exports.UnauthorizedError = UnauthorizedError;
-exports.UpdateProfileRequestSchema = UpdateProfileRequestSchema;
-exports.UserRecordSchema = UserRecordSchema;
 exports.ValidationError = ValidationError;
 exports.ViewerStateSchema = ViewerStateSchema;
 exports.buildReportedErrorEvent = buildReportedErrorEvent;
-exports.httpsUrl = httpsUrl;
 exports.isFirestoreTimestamp = isFirestoreTimestamp;
-exports.nsidForCollection = nsidForCollection;
 exports.reportError = reportError;
-exports.resolveAudioUrl = resolveAudioUrl;
-exports.toProfileViewBasic = toProfileViewBasic;

package/dist/cjs/index.d.cts

@@ -1,11 +1,93 @@
-export { CreateAudioPostRequest, CreateAudioPostRequestSchema, UpdateProfileRequestSchema } from './api-codecs.cjs';
-export { FirestoreTimestamp, FirestoreTimestampSchema, UserRecord, UserRecordSchema, httpsUrl } from './types/records.cjs';
-export { ProfileView, ProfileViewAdmin, ProfileViewAdminSchema, ProfileViewBasic, ProfileViewBasicSchema, ProfileViewDetailed, ProfileViewDetailedSchema, ProfileViewSchema, ProfileViewSelf, ProfileViewSelfSchema, toProfileViewBasic } from './types/views.cjs';
+export { CreateAudioPostRequest, CreateAudioPostRequestSchema, PatchAudioPostRequest, PatchAudioPostRequestSchema } from './api-codecs.cjs';
+export { FirestoreTimestamp, FirestoreTimestampSchema } from './types/records.cjs';
 export { ActorProfileRecord, ActorProfileRecordSchema, AudioEmbed, AudioEmbedSchema, AudioEmbedView, AudioEmbedViewSchema, AudioPostRecord, AudioPostRecordSchema, AudioPostView, AudioPostViewSchema, PostRecordPublic, PostRecordPublicSchema, ReplyRef, ReplyRefSchema, StrongRef, StrongRefSchema, TimedTranscript, TimedTranscriptSchema, TranscriptEnrichmentRecord, TranscriptEnrichmentRecordSchema, TranscriptSegment, TranscriptSegmentSchema, ViewerState, ViewerStateSchema } from './types/audio.cjs';
-export { BlobRef, BlobRefSchema, resolveAudioUrl } from './types/blob.cjs';
-export { ActorView, ActorViewSchema, PublicProfileDto, PublicProfileDtoSchema } from './types/api.cjs';
-export { COLLECTIONS, EMBED_NSID, NSID, NsidValue, nsidForCollection } from './nsid.cjs';
+import { z } from 'zod';
+export { BlobRef, BlobRefSchema } from './types/blob.cjs';
+export { COLLECTIONS, EMBED_NSID, NSID, NsidValue, StoredNsidValue } from './nsid.cjs';
 export { ConflictError, ForbiddenError, NotFoundError, RateLimitError, ServiceError, UnauthorizedError, ValidationError } from './errors/index.cjs';
 export { isFirestoreTimestamp } from './utils/index.cjs';
 export { ReportedErrorEvent, buildReportedErrorEvent, reportError } from './observability/report-error.cjs';
-import 'zod';
+
+/**
+ * Audio hygiene / enrichment processing (B5).
+ *
+ * Antiphony can, when the calling app opts in, run two pieces of audio
+ * processing on a post's audio: **transcription** (machine transcript, the
+ * `dev.antiphony.audio.transcript` enrichment) and **denoise** (a cleaned
+ * audio variant for playback). Both are OFF by default — the app asks for
+ * them per post via `CreateAudioPostRequest.processing`.
+ *
+ * The work runs asynchronously (outside the create request), so a post
+ * carries a mutable `processing` state that starts `pending` and settles to
+ * `ready`/`failed`/`skipped` per stage. That state is a storage-layer field —
+ * it is NOT part of the canonical lexicon record and never enters the record
+ * CID (like `kind` and `threadParticipants`), so processing can update it
+ * without changing the post's content address.
+ */
+/**
+ * Per-stage status.
+ *  - `pending`  — requested, not yet done (the worker acts on these).
+ *  - `ready`    — completed.
+ *  - `failed`   — attempted and errored.
+ *  - `skipped`  — requested but this deployment has no provider for it.
+ */
+declare const ProcessingStageStatusSchema: z.ZodEnum<["pending", "ready", "failed", "skipped"]>;
+type ProcessingStageStatus = z.infer<typeof ProcessingStageStatusSchema>;
+/**
+ * What the calling app opts into, on `CreateAudioPostRequest`. Both default
+ * off; only `true` values request a stage.
+ */
+declare const ProcessingRequestSchema: z.ZodObject<{
+    transcribe: z.ZodOptional<z.ZodBoolean>;
+    denoise: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    transcribe?: boolean | undefined;
+    denoise?: boolean | undefined;
+}, {
+    transcribe?: boolean | undefined;
+    denoise?: boolean | undefined;
+}>;
+type ProcessingRequest = z.infer<typeof ProcessingRequestSchema>;
+/**
+ * Stored processing state on the post record (storage-layer; not in the CID).
+ * A stage key is present iff that stage was requested. `denoisedBlobCid`
+ * points at the cleaned audio variant once denoise completes — the record's
+ * own `embed.audio.ref.$link` stays the ORIGINAL CID (immutable content
+ * address); only the read-time view swaps playback to the cleaned variant.
+ */
+declare const ProcessingStateSchema: z.ZodObject<{
+    transcribe: z.ZodOptional<z.ZodEnum<["pending", "ready", "failed", "skipped"]>>;
+    denoise: z.ZodOptional<z.ZodEnum<["pending", "ready", "failed", "skipped"]>>;
+    /** Content CID of the denoised audio variant, once `denoise === 'ready'`. */
+    denoisedBlobCid: z.ZodOptional<z.ZodString>;
+    updatedAt: z.ZodEffects<z.ZodUnion<[z.ZodType<unknown, z.ZodTypeDef, unknown>, z.ZodString, z.ZodNumber, z.ZodDate]>, Date, unknown>;
+}, "strip", z.ZodTypeAny, {
+    updatedAt: Date;
+    transcribe?: "pending" | "ready" | "failed" | "skipped" | undefined;
+    denoise?: "pending" | "ready" | "failed" | "skipped" | undefined;
+    denoisedBlobCid?: string | undefined;
+}, {
+    transcribe?: "pending" | "ready" | "failed" | "skipped" | undefined;
+    denoise?: "pending" | "ready" | "failed" | "skipped" | undefined;
+    denoisedBlobCid?: string | undefined;
+    updatedAt?: unknown;
+}>;
+type ProcessingState = z.infer<typeof ProcessingStateSchema>;
+/**
+ * The processing status surfaced on the hydrated view — the per-stage status
+ * only (no internal storage fields). Absent when no processing was requested.
+ * Clients treat any `pending` stage as "still working".
+ */
+declare const ProcessingViewSchema: z.ZodObject<{
+    transcribe: z.ZodOptional<z.ZodEnum<["pending", "ready", "failed", "skipped"]>>;
+    denoise: z.ZodOptional<z.ZodEnum<["pending", "ready", "failed", "skipped"]>>;
+}, "strip", z.ZodTypeAny, {
+    transcribe?: "pending" | "ready" | "failed" | "skipped" | undefined;
+    denoise?: "pending" | "ready" | "failed" | "skipped" | undefined;
+}, {
+    transcribe?: "pending" | "ready" | "failed" | "skipped" | undefined;
+    denoise?: "pending" | "ready" | "failed" | "skipped" | undefined;
+}>;
+type ProcessingView = z.infer<typeof ProcessingViewSchema>;
+
+export { type ProcessingRequest, ProcessingRequestSchema, type ProcessingStageStatus, ProcessingStageStatusSchema, type ProcessingState, ProcessingStateSchema, type ProcessingView, ProcessingViewSchema };

package/dist/cjs/nsid.cjs

@@ -6,6 +6,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 = {
@@ -13,18 +17,11 @@ 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];
-}
 
 exports.COLLECTIONS = COLLECTIONS;
 exports.EMBED_NSID = EMBED_NSID;
 exports.NSID = NSID;
-exports.nsidForCollection = nsidForCollection;

package/dist/cjs/nsid.d.cts

@@ -13,6 +13,8 @@ declare const NSID: {
     readonly ActorProfile: "dev.antiphony.actor.profile";
 };
 type NsidValue = typeof NSID[keyof typeof NSID];
+/** The subset of record NSIDs the core actually stores. */
+type StoredNsidValue = typeof NSID.AudioPost | typeof NSID.AudioTranscript;
 /**
  * Antiphony embed NSIDs. Embeds live inline on a post's `embed` field, not in
  * their own collection — kept out of `NSID`/`COLLECTIONS`.
@@ -22,13 +24,10 @@ declare const EMBED_NSID: {
     readonly RecordWithAudio: "dev.antiphony.embed.recordWithAudio";
 };
 /**
- * Maps AT Protocol record-type NSIDs to Firestore collection names.
- * When migrating to a PDS, this mapping becomes the adapter layer.
+ * Maps the STORED AT Protocol record-type NSIDs to Firestore collection
+ * names. When migrating to a PDS, this mapping becomes the adapter layer.
+ * `actor.profile` is deliberately absent — portable schema, no core storage.
  */
-declare const COLLECTIONS: Record<NsidValue, string>;
-/**
- * Reverse lookup: get the NSID for a Firestore collection name.
- */
-declare function nsidForCollection(collection: string): NsidValue | undefined;
+declare const COLLECTIONS: Record<StoredNsidValue, string>;
 
-export { COLLECTIONS, EMBED_NSID, NSID, type NsidValue, nsidForCollection };
+export { COLLECTIONS, EMBED_NSID, NSID, type NsidValue, type StoredNsidValue };