@antiphony/shared 0.1.0

package/dist/cjs/index.d.cts

@@ -0,0 +1,11 @@
+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 { 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';
+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';

package/dist/cjs/nsid.cjs

@@ -0,0 +1,37 @@
+'use strict';
+
+// 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.
+  AudioPost: "dev.antiphony.audio.post",
+  AudioTranscript: "dev.antiphony.audio.transcript",
+  ActorProfile: "dev.antiphony.actor.profile"
+};
+var EMBED_NSID = {
+  Audio: "dev.antiphony.embed.audio",
+  RecordWithAudio: "dev.antiphony.embed.recordWithAudio"
+};
+var COLLECTIONS = {
+  [NSID.Prompt]: "prompts",
+  [NSID.Reply]: "replies",
+  [NSID.Profile]: "users",
+  // Antiphony: one post collection + the transcript enrichment namespace.
+  [NSID.AudioPost]: "posts",
+  [NSID.AudioTranscript]: "audio_transcripts",
+  [NSID.ActorProfile]: "users"
+};
+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

@@ -0,0 +1,42 @@
+/**
+ * AT Protocol Namespaced Identifiers (NSIDs) for Vox Pop record types.
+ *
+ * NSIDs are the canonical way to identify record types in AT Protocol.
+ * This mapping connects AT Protocol NSIDs to Firestore collection names,
+ * creating a single source of truth for the relationship.
+ *
+ * @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];
+/**
+ * Antiphony embed NSIDs. Embeds live inline on a post's `embed` field, not in
+ * their own collection — kept out of `NSID`/`COLLECTIONS`.
+ */
+declare const EMBED_NSID: {
+    readonly Audio: "dev.antiphony.embed.audio";
+    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.
+ */
+declare function nsidForCollection(collection: string): NsidValue | undefined;
+
+export { COLLECTIONS, EMBED_NSID, NSID, type NsidValue, nsidForCollection };

package/dist/cjs/observability/index.cjs

@@ -0,0 +1,58 @@
+'use strict';
+
+var __defProp = Object.defineProperty;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+
+// observability/report-error.ts
+var REPORTED_ERROR_EVENT_TYPE = "type.googleapis.com/google.devtools.clouderrorreporting.v1beta1.ReportedErrorEvent";
+function serviceName() {
+  var _a, _b;
+  return (_b = (_a = process.env.K_SERVICE) != null ? _a : process.env.SERVICE_NAME) != null ? _b : "unknown";
+}
+function serviceVersion() {
+  var _a, _b;
+  return (_b = (_a = process.env.COMMIT_SHA) != null ? _a : process.env.K_REVISION) != null ? _b : "dev";
+}
+function formatUnknownError(err) {
+  var _a;
+  if (typeof err === "string") return err;
+  try {
+    return (_a = JSON.stringify(err)) != null ? _a : String(err);
+  } catch (e) {
+    return String(err);
+  }
+}
+function buildReportedErrorEvent(err, context) {
+  var _a;
+  const error = err instanceof Error ? err : new Error(formatUnknownError(err));
+  const message = (_a = error.stack) != null ? _a : `${error.name}: ${error.message}`;
+  return __spreadValues({
+    severity: "ERROR",
+    "@type": REPORTED_ERROR_EVENT_TYPE,
+    message,
+    serviceContext: { service: serviceName(), version: serviceVersion() }
+  }, context && Object.keys(context).length > 0 ? { context } : {});
+}
+function reportError(err, context) {
+  try {
+    console.error(JSON.stringify(buildReportedErrorEvent(err, context)));
+  } catch (e) {
+  }
+}
+
+exports.buildReportedErrorEvent = buildReportedErrorEvent;
+exports.reportError = reportError;

package/dist/cjs/observability/index.d.cts

@@ -0,0 +1 @@
+export { ReportedErrorEvent, buildReportedErrorEvent, reportError } from './report-error.cjs';

package/dist/cjs/observability/report-error.cjs

@@ -0,0 +1,58 @@
+'use strict';
+
+var __defProp = Object.defineProperty;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+
+// observability/report-error.ts
+var REPORTED_ERROR_EVENT_TYPE = "type.googleapis.com/google.devtools.clouderrorreporting.v1beta1.ReportedErrorEvent";
+function serviceName() {
+  var _a, _b;
+  return (_b = (_a = process.env.K_SERVICE) != null ? _a : process.env.SERVICE_NAME) != null ? _b : "unknown";
+}
+function serviceVersion() {
+  var _a, _b;
+  return (_b = (_a = process.env.COMMIT_SHA) != null ? _a : process.env.K_REVISION) != null ? _b : "dev";
+}
+function formatUnknownError(err) {
+  var _a;
+  if (typeof err === "string") return err;
+  try {
+    return (_a = JSON.stringify(err)) != null ? _a : String(err);
+  } catch (e) {
+    return String(err);
+  }
+}
+function buildReportedErrorEvent(err, context) {
+  var _a;
+  const error = err instanceof Error ? err : new Error(formatUnknownError(err));
+  const message = (_a = error.stack) != null ? _a : `${error.name}: ${error.message}`;
+  return __spreadValues({
+    severity: "ERROR",
+    "@type": REPORTED_ERROR_EVENT_TYPE,
+    message,
+    serviceContext: { service: serviceName(), version: serviceVersion() }
+  }, context && Object.keys(context).length > 0 ? { context } : {});
+}
+function reportError(err, context) {
+  try {
+    console.error(JSON.stringify(buildReportedErrorEvent(err, context)));
+  } catch (e) {
+  }
+}
+
+exports.buildReportedErrorEvent = buildReportedErrorEvent;
+exports.reportError = reportError;

package/dist/cjs/observability/report-error.d.cts

@@ -0,0 +1,48 @@
+/**
+ * GCP Cloud Error Reporting integration — log-based, dependency-free.
+ *
+ * Cloud Error Reporting auto-ingests Cloud Logging entries shaped as a
+ * `ReportedErrorEvent`. On Firebase App Hosting (Cloud Run), single-line JSON
+ * written to stderr lands in Cloud Logging automatically — so emitting a
+ * correctly-shaped line is all it takes to surface a grouped, deduplicated
+ * error in the Error Reporting console. No SDK, no auth, no secrets (the
+ * `@google-cloud/error-reporting` library would add a gRPC client + cold-start
+ * weight + credential config for the same outcome on serverless).
+ *
+ * See https://cloud.google.com/error-reporting/docs/formatting-error-messages
+ *
+ * Grouping rules we satisfy:
+ *   - `severity` must be ERROR or higher.
+ *   - `message` must contain a full stack trace (that's what Error Reporting
+ *     fingerprints on); we fall back to "name: message" when no stack exists,
+ *     which still surfaces, just grouped less precisely.
+ *   - `serviceContext.service` separates errors per deployable
+ *     (core-api / web / public), so each app's errors are tracked apart.
+ *
+ * This module only ever *runs* from server code (core-api error-handler,
+ * Next instrumentation hooks, /api/client-error route handlers). It has no
+ * Node-only or heavy imports, so it stays safe to live in the shared package.
+ */
+interface ReportedErrorEvent {
+    severity: 'ERROR';
+    '@type': string;
+    message: string;
+    serviceContext: {
+        service: string;
+        version: string;
+    };
+    context?: Record<string, unknown>;
+}
+/**
+ * Build the `ReportedErrorEvent` payload. Exported for unit testing; most
+ * callers want `reportError` instead.
+ */
+declare function buildReportedErrorEvent(err: unknown, context?: Record<string, unknown>): ReportedErrorEvent;
+/**
+ * Report an error to GCP Error Reporting by emitting a single-line
+ * ReportedErrorEvent to stderr. Best-effort and total — a failure inside the
+ * reporter is swallowed so it can never mask the original error.
+ */
+declare function reportError(err: unknown, context?: Record<string, unknown>): void;
+
+export { type ReportedErrorEvent, buildReportedErrorEvent, reportError };