@antiphony/shared 0.1.0 → 0.4.0

package/dist/cjs/index.d.cts

@@ -1,11 +1,93 @@
-export { BadgeResetRequestSchema, BulkReplyActionRequestSchema, ConnectorConfigInputSchema, ConnectorConfigUpdateSchema, CreateAudioPostRequest, CreateAudioPostRequestSchema, CreateOrgInviteRequestSchema, CreateOrgRequestSchema, CreatePromptRequestSchema, FcmTokenRequestSchema, PersonMergeRequestSchema, PersonNotesUpdateSchema, ScreeningRuleInputSchema, ScreeningRuleUpdateSchema, SwitchOrgRequestSchema, UpdateMemberRoleRequestSchema, UpdateOrgRequestSchema, UpdateProfileRequestSchema, UpdateReplyStatusRequestSchema } from './api-codecs.cjs';
-export { CallForwardingConfig, CallForwardingConfigSchema, ConnectorConfigRecord, ConnectorConfigRecordSchema, ConnectorStatus, ConnectorStatusSchema, ConnectorType, ConnectorTypeSchema, FirestoreTimestamp, FirestoreTimestampSchema, OrgInviteRecord, OrgInviteRecordSchema, OrganizationMemberRecord, OrganizationMemberRecordSchema, OrganizationRecord, OrganizationRecordSchema, PersonEnrichmentRecord, PersonEnrichmentRecordSchema, PromptRecord, PromptRecordSchema, ReplyEnrichmentRecord, ReplyEnrichmentRecordSchema, ReplyRecord, ReplyRecordSchema, ScreeningRuleRecord, ScreeningRuleRecordSchema, SipEnrichment, SipEnrichmentSchema, UserRecord, UserRecordSchema, httpsUrl } from './types/records.cjs';
-export { ContactCrmData, EnrichedReplier, EnrichedReplierSchema, HandleResolution, HandleResolutionSchema, OrgInviteView, OrgInviteViewSchema, OrgProfileData, OrgProfileDataSchema, OrganizationMemberView, OrganizationMemberViewSchema, OrganizationView, OrganizationViewSchema, ProfileView, ProfileViewAdmin, ProfileViewAdminSchema, ProfileViewBasic, ProfileViewBasicSchema, ProfileViewDetailed, ProfileViewDetailedSchema, ProfileViewSchema, ProfileViewSelf, ProfileViewSelfSchema, PromptRepliers, PromptRepliersSchema, PromptView, PromptViewPublic, PromptViewPublicSchema, PromptViewSchema, PromptWithReplies, PromptWithRepliesSchema, Replier, ReplierSchema, ReplyView, ReplyViewPublic, ReplyViewPublicSchema, ReplyViewSchema, RssSummary, RssSummarySchema, UserProfileData, UserProfileDataSchema, VoxPopEmbedWidgetProps, toProfileViewBasic, toPromptViewPublic, toReplyViewPublic } 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, PublicReplyDto, PublicReplyDtoSchema } 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

@@ -2,14 +2,14 @@
 
 // nsid.ts
 var NSID = {
-  // Legacy Vox Pop record types (deprecated; removed in Stream 4).
-  Prompt: "com.voxpop.audio.prompt",
-  Reply: "com.voxpop.audio.reply",
-  Profile: "com.voxpop.actor.profile",
-  // Antiphony canonical record types (dev.antiphony.*). Added additively in
-  // Stream 1; see lexicons/dev/antiphony/ + packages/shared/types/audio.ts.
+  // Antiphony canonical record types (dev.antiphony.*).
+  // 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 = {
@@ -17,21 +17,11 @@ var EMBED_NSID = {
   RecordWithAudio: "dev.antiphony.embed.recordWithAudio"
 };
 var COLLECTIONS = {
-  [NSID.Prompt]: "prompts",
-  [NSID.Reply]: "replies",
-  [NSID.Profile]: "users",
-  // Antiphony: one post collection + the transcript enrichment namespace.
+  // 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

@@ -1,5 +1,5 @@
 /**
- * AT Protocol Namespaced Identifiers (NSIDs) for Vox Pop record types.
+ * AT Protocol Namespaced Identifiers (NSIDs) for Antiphony record types.
  *
  * NSIDs are the canonical way to identify record types in AT Protocol.
  * This mapping connects AT Protocol NSIDs to Firestore collection names,
@@ -8,14 +8,13 @@
  * @see https://atproto.com/specs/nsid
  */
 declare const NSID: {
-    readonly Prompt: "com.voxpop.audio.prompt";
-    readonly Reply: "com.voxpop.audio.reply";
-    readonly Profile: "com.voxpop.actor.profile";
     readonly AudioPost: "dev.antiphony.audio.post";
     readonly AudioTranscript: "dev.antiphony.audio.transcript";
     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`.
@@ -25,18 +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.
- *
- * Note: `dev.antiphony.actor.profile` and the legacy `com.voxpop.actor.profile`
- * both map to `users`. `nsidForCollection('users')` returns the legacy NSID
- * (listed first) — preserving today's reverse-lookup behavior until Stream 4
- * removes the legacy entry.
- */
-declare const COLLECTIONS: Record<NsidValue, string>;
-/**
- * Reverse lookup: get the NSID for a Firestore collection name.
+ * 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 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 };