@antiphony/shared 0.1.0

package/dist/cjs/api-codecs.d.cts

@@ -0,0 +1,542 @@
+import { z } from 'zod';
+
+/**
+ * Create-request codec for the new Antiphony `dev.antiphony.audio.post` model
+ * (Stream 1, additive — does not replace `CreatePromptRequestSchema`). The
+ * audio is uploaded first (signed-URL flow); the request references it as the
+ * embed. `reply` presence makes the new post a reply; absence makes it a
+ * prompt. `originAppId`/`authorId`/`kind` are stamped server-side, not sent.
+ */
+declare const CreateAudioPostRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
+    /** User-authored text; may be empty for pure-audio posts. */
+    text: z.ZodDefault<z.ZodString>;
+    /** Optional headline (prompt feature). */
+    title: z.ZodOptional<z.ZodString>;
+    /** The uploaded audio attachment. */
+    embed: z.ZodOptional<z.ZodObject<{
+        $type: z.ZodLiteral<"dev.antiphony.embed.audio">;
+        audio: z.ZodObject<{
+            $type: z.ZodLiteral<"blob">;
+            ref: z.ZodString;
+            mimeType: z.ZodString;
+            size: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            $type: "blob";
+            ref: string;
+            mimeType: string;
+            size: number;
+        }, {
+            $type: "blob";
+            ref: string;
+            mimeType: string;
+            size: number;
+        }>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        alt: z.ZodOptional<z.ZodString>;
+        waveform: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        $type: "dev.antiphony.embed.audio";
+        audio: {
+            $type: "blob";
+            ref: string;
+            mimeType: string;
+            size: number;
+        };
+        durationMs?: number | undefined;
+        alt?: string | undefined;
+        waveform?: number[] | undefined;
+    }, {
+        $type: "dev.antiphony.embed.audio";
+        audio: {
+            $type: "blob";
+            ref: string;
+            mimeType: string;
+            size: number;
+        };
+        durationMs?: number | undefined;
+        alt?: string | undefined;
+        waveform?: number[] | undefined;
+    }>>;
+    /** Present ⇒ this is a reply (StrongRef root + parent). */
+    reply: z.ZodOptional<z.ZodObject<{
+        root: z.ZodObject<{
+            uri: z.ZodString;
+            cid: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            uri: string;
+            cid: string;
+        }, {
+            uri: string;
+            cid: string;
+        }>;
+        parent: z.ZodObject<{
+            uri: z.ZodString;
+            cid: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            uri: string;
+            cid: string;
+        }, {
+            uri: string;
+            cid: string;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        root: {
+            uri: string;
+            cid: string;
+        };
+        parent: {
+            uri: string;
+            cid: string;
+        };
+    }, {
+        root: {
+            uri: string;
+            cid: string;
+        };
+        parent: {
+            uri: string;
+            cid: string;
+        };
+    }>>;
+    /** BCP-47 language tags. */
+    langs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Author self-label values (content warnings). */
+    selfLabels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    text: string;
+    title?: string | undefined;
+    reply?: {
+        root: {
+            uri: string;
+            cid: string;
+        };
+        parent: {
+            uri: string;
+            cid: 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;
+    } | undefined;
+    langs?: string[] | undefined;
+    selfLabels?: string[] | undefined;
+}, {
+    title?: string | undefined;
+    text?: string | undefined;
+    reply?: {
+        root: {
+            uri: string;
+            cid: string;
+        };
+        parent: {
+            uri: string;
+            cid: 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;
+    } | undefined;
+    langs?: string[] | undefined;
+    selfLabels?: string[] | undefined;
+}>, {
+    text: string;
+    title?: string | undefined;
+    reply?: {
+        root: {
+            uri: string;
+            cid: string;
+        };
+        parent: {
+            uri: string;
+            cid: 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;
+    } | undefined;
+    langs?: string[] | undefined;
+    selfLabels?: string[] | undefined;
+}, {
+    title?: string | undefined;
+    text?: string | undefined;
+    reply?: {
+        root: {
+            uri: string;
+            cid: string;
+        };
+        parent: {
+            uri: string;
+            cid: 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;
+    } | undefined;
+    langs?: string[] | undefined;
+    selfLabels?: string[] | undefined;
+}>, {
+    text: string;
+    title?: string | undefined;
+    reply?: {
+        root: {
+            uri: string;
+            cid: string;
+        };
+        parent: {
+            uri: string;
+            cid: 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;
+    } | undefined;
+    langs?: string[] | undefined;
+    selfLabels?: string[] | undefined;
+}, {
+    title?: string | undefined;
+    text?: string | undefined;
+    reply?: {
+        root: {
+            uri: string;
+            cid: string;
+        };
+        parent: {
+            uri: string;
+            cid: 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;
+    } | undefined;
+    langs?: string[] | undefined;
+    selfLabels?: string[] | undefined;
+}>;
+type CreateAudioPostRequest = z.infer<typeof CreateAudioPostRequestSchema>;
+declare const CreatePromptRequestSchema: z.ZodObject<{
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    audioUrl: z.ZodUnion<[z.ZodString, z.ZodLiteral<"">]>;
+    setAsGreeting: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodEffects<z.ZodString, boolean, string>]>>;
+    /** Explicit org context override (normally inferred from auth.currentOrg) */
+    orgId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    audioUrl: string;
+    orgId?: string | null | undefined;
+    description?: string | undefined;
+    setAsGreeting?: boolean | undefined;
+}, {
+    title: string;
+    audioUrl: string;
+    orgId?: string | null | undefined;
+    description?: string | undefined;
+    setAsGreeting?: string | boolean | undefined;
+}>;
+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;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        url: string;
+    }, {
+        label: string;
+        url: string;
+    }>, "many">>;
+    /** When true, surfaces the linked Bluesky identity on the public profile. */
+    showBlueskyPublicly: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    handle?: string | undefined;
+    usageIntent?: string | null | undefined;
+    displayName?: string | undefined;
+    bio?: string | undefined;
+    avatarUrl?: string | null | undefined;
+    website?: string | null | undefined;
+    links?: {
+        label: string;
+        url: string;
+    }[] | undefined;
+    showBlueskyPublicly?: boolean | undefined;
+}, {
+    handle?: string | undefined;
+    usageIntent?: string | null | undefined;
+    displayName?: string | undefined;
+    bio?: string | undefined;
+    avatarUrl?: string | null | undefined;
+    website?: string | null | undefined;
+    links?: {
+        label: string;
+        url: string;
+    }[] | undefined;
+    showBlueskyPublicly?: boolean | undefined;
+}>;
+declare const FcmTokenRequestSchema: z.ZodObject<{
+    token: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    token: string;
+}, {
+    token: string;
+}>;
+declare const BadgeResetRequestSchema: z.ZodObject<{
+    type: z.ZodEnum<["new_replier", "unread_reply"]>;
+}, "strip", z.ZodTypeAny, {
+    type: "new_replier" | "unread_reply";
+}, {
+    type: "new_replier" | "unread_reply";
+}>;
+declare const CreateOrgRequestSchema: z.ZodObject<{
+    name: z.ZodString;
+    slug: z.ZodString;
+    avatarUrl: z.ZodOptional<z.ZodString>;
+    rssFeedUrl: z.ZodOptional<z.ZodString>;
+    websiteUrl: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    slug: string;
+    avatarUrl?: string | undefined;
+    description?: string | undefined;
+    rssFeedUrl?: string | undefined;
+    websiteUrl?: string | undefined;
+}, {
+    name: string;
+    slug: string;
+    avatarUrl?: string | undefined;
+    description?: string | undefined;
+    rssFeedUrl?: string | undefined;
+    websiteUrl?: string | undefined;
+}>;
+declare const UpdateOrgRequestSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    slug: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    avatarUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    rssFeedUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    websiteUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    billingEmail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    domain: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    domain?: string | null | undefined;
+    avatarUrl?: string | null | undefined;
+    description?: string | undefined;
+    name?: string | undefined;
+    slug?: string | undefined;
+    rssFeedUrl?: string | null | undefined;
+    websiteUrl?: string | null | undefined;
+    billingEmail?: string | null | undefined;
+}, {
+    domain?: string | null | undefined;
+    avatarUrl?: string | null | undefined;
+    description?: string | undefined;
+    name?: string | undefined;
+    slug?: string | undefined;
+    rssFeedUrl?: string | null | undefined;
+    websiteUrl?: string | null | undefined;
+    billingEmail?: string | null | undefined;
+}>;
+declare const CreateOrgInviteRequestSchema: z.ZodObject<{
+    email: z.ZodString;
+    role: z.ZodEnum<["admin", "member"]>;
+}, "strip", z.ZodTypeAny, {
+    role: "admin" | "member";
+    email: string;
+}, {
+    role: "admin" | "member";
+    email: string;
+}>;
+declare const UpdateMemberRoleRequestSchema: z.ZodObject<{
+    role: z.ZodEnum<["admin", "member"]>;
+}, "strip", z.ZodTypeAny, {
+    role: "admin" | "member";
+}, {
+    role: "admin" | "member";
+}>;
+declare const SwitchOrgRequestSchema: z.ZodObject<{
+    /** orgId to switch to, or null to switch to personal context */
+    orgId: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    orgId: string | null;
+}, {
+    orgId: string | null;
+}>;
+declare const ConnectorConfigInputSchema: z.ZodObject<Omit<{
+    connectorType: z.ZodEnum<["telephony"]>;
+    ownerId: z.ZodString;
+    settings: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    secretRef: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    status: z.ZodDefault<z.ZodObject<{
+        state: z.ZodDefault<z.ZodEnum<["unconfigured", "pending", "active", "error", "disabled"]>>;
+        detail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        data: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        updatedAt: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodType<unknown, z.ZodTypeDef, unknown>, z.ZodString, z.ZodNumber, z.ZodDate]>, Date, unknown>>;
+    }, "strip", z.ZodTypeAny, {
+        state: "active" | "pending" | "error" | "unconfigured" | "disabled";
+        updatedAt?: Date | undefined;
+        detail?: string | null | undefined;
+        data?: Record<string, unknown> | null | undefined;
+    }, {
+        updatedAt?: unknown;
+        state?: "active" | "pending" | "error" | "unconfigured" | "disabled" | undefined;
+        detail?: string | null | undefined;
+        data?: Record<string, unknown> | null | undefined;
+    }>>;
+    createdAt: z.ZodEffects<z.ZodUnion<[z.ZodType<unknown, z.ZodTypeDef, unknown>, z.ZodString, z.ZodNumber, z.ZodDate]>, Date, unknown>;
+    updatedAt: z.ZodEffects<z.ZodUnion<[z.ZodType<unknown, z.ZodTypeDef, unknown>, z.ZodString, z.ZodNumber, z.ZodDate]>, Date, unknown>;
+}, "status" | "createdAt" | "updatedAt" | "connectorType" | "ownerId">, "strip", z.ZodTypeAny, {
+    enabled: boolean;
+    settings: Record<string, unknown>;
+    secretRef?: string | null | undefined;
+}, {
+    enabled?: boolean | undefined;
+    settings?: Record<string, unknown> | undefined;
+    secretRef?: string | null | undefined;
+}>;
+declare const ConnectorConfigUpdateSchema: z.ZodObject<{
+    enabled: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    settings: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    secretRef: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+}, "strip", z.ZodTypeAny, {
+    enabled?: boolean | undefined;
+    settings?: Record<string, unknown> | undefined;
+    secretRef?: string | null | undefined;
+}, {
+    enabled?: boolean | undefined;
+    settings?: Record<string, unknown> | undefined;
+    secretRef?: string | null | undefined;
+}>;
+declare const PersonNotesUpdateSchema: z.ZodObject<{
+    notes: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    notes?: string | undefined;
+    tags?: string[] | undefined;
+}, {
+    notes?: string | undefined;
+    tags?: string[] | undefined;
+}>;
+declare const PersonMergeRequestSchema: z.ZodObject<{
+    alternateUid: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    alternateUid: string;
+}, {
+    alternateUid: string;
+}>;
+declare const ScreeningRuleInputSchema: z.ZodObject<{
+    e164: z.ZodString;
+    label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    action: z.ZodEnum<["allow", "screen"]>;
+    expiresAt: z.ZodEffects<z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>, string | number | null | undefined, string | number | null | undefined>;
+}, "strip", z.ZodTypeAny, {
+    e164: string;
+    action: "allow" | "screen";
+    label?: string | null | undefined;
+    expiresAt?: string | number | null | undefined;
+}, {
+    e164: string;
+    action: "allow" | "screen";
+    label?: string | null | undefined;
+    expiresAt?: string | number | null | undefined;
+}>;
+declare const ScreeningRuleUpdateSchema: z.ZodObject<{
+    e164: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    action: z.ZodOptional<z.ZodEnum<["allow", "screen"]>>;
+    expiresAt: z.ZodOptional<z.ZodEffects<z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>, string | number | null | undefined, string | number | null | undefined>>;
+}, "strip", z.ZodTypeAny, {
+    label?: string | null | undefined;
+    e164?: string | undefined;
+    action?: "allow" | "screen" | undefined;
+    expiresAt?: string | number | null | undefined;
+}, {
+    label?: string | null | undefined;
+    e164?: string | undefined;
+    action?: "allow" | "screen" | undefined;
+    expiresAt?: string | number | null | undefined;
+}>;
+declare const UpdateReplyStatusRequestSchema: z.ZodObject<{
+    status: z.ZodEnum<["live", "archived", "deleted"]>;
+}, "strip", z.ZodTypeAny, {
+    status: "live" | "archived" | "deleted";
+}, {
+    status: "live" | "archived" | "deleted";
+}>;
+declare const BulkReplyActionRequestSchema: z.ZodObject<{
+    replyIds: z.ZodArray<z.ZodString, "many">;
+    action: z.ZodEnum<["markRead", "archive", "delete", "restore"]>;
+}, "strip", z.ZodTypeAny, {
+    action: "markRead" | "archive" | "delete" | "restore";
+    replyIds: string[];
+}, {
+    action: "markRead" | "archive" | "delete" | "restore";
+    replyIds: string[];
+}>;
+
+export { BadgeResetRequestSchema, BulkReplyActionRequestSchema, ConnectorConfigInputSchema, ConnectorConfigUpdateSchema, type CreateAudioPostRequest, CreateAudioPostRequestSchema, CreateOrgInviteRequestSchema, CreateOrgRequestSchema, CreatePromptRequestSchema, FcmTokenRequestSchema, PersonMergeRequestSchema, PersonNotesUpdateSchema, ScreeningRuleInputSchema, ScreeningRuleUpdateSchema, SwitchOrgRequestSchema, UpdateMemberRoleRequestSchema, UpdateOrgRequestSchema, UpdateProfileRequestSchema, UpdateReplyStatusRequestSchema };

package/dist/cjs/errors/index.cjs

@@ -0,0 +1,56 @@
+'use strict';
+
+// errors/index.ts
+var ServiceError = class extends Error {
+  constructor(message, status, details, code) {
+    super(message);
+    this.name = "ServiceError";
+    this.status = status;
+    this.details = details;
+    this.code = code;
+  }
+};
+var ValidationError = class extends ServiceError {
+  constructor(message, details) {
+    super(message, 400, details, "VALIDATION_ERROR");
+    this.name = "ValidationError";
+  }
+};
+var UnauthorizedError = class extends ServiceError {
+  constructor(message = "Unauthorized") {
+    super(message, 401, void 0, "UNAUTHORIZED");
+    this.name = "UnauthorizedError";
+  }
+};
+var ForbiddenError = class extends ServiceError {
+  constructor(message = "Forbidden") {
+    super(message, 403, void 0, "FORBIDDEN");
+    this.name = "ForbiddenError";
+  }
+};
+var NotFoundError = class extends ServiceError {
+  constructor(message = "Resource not found") {
+    super(message, 404, void 0, "NOT_FOUND");
+    this.name = "NotFoundError";
+  }
+};
+var ConflictError = class extends ServiceError {
+  constructor(message = "Conflict") {
+    super(message, 409, void 0, "CONFLICT");
+    this.name = "ConflictError";
+  }
+};
+var RateLimitError = class extends ServiceError {
+  constructor(message = "Too many requests") {
+    super(message, 429, void 0, "RATE_LIMIT");
+    this.name = "RateLimitError";
+  }
+};
+
+exports.ConflictError = ConflictError;
+exports.ForbiddenError = ForbiddenError;
+exports.NotFoundError = NotFoundError;
+exports.RateLimitError = RateLimitError;
+exports.ServiceError = ServiceError;
+exports.UnauthorizedError = UnauthorizedError;
+exports.ValidationError = ValidationError;

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

@@ -0,0 +1,45 @@
+/**
+ * Typed service errors for consistent error handling across the API layer.
+ *
+ * Usage:
+ *   throw new NotFoundError('Prompt not found');
+ *   throw new ConflictError('Handle is already taken');
+ *
+ * The `withErrorHandler` middleware catches these and maps `error.status`
+ * directly to the HTTP response status code.
+ */
+declare class ServiceError extends Error {
+    /** HTTP status code to return when this error reaches the API layer. */
+    readonly status: number;
+    /** Optional structured details (e.g., Zod issues). */
+    readonly details?: unknown;
+    /** Stable, machine-readable error identifier surfaced in the response envelope's `error.code`. */
+    readonly code?: string;
+    constructor(message: string, status: number, details?: unknown, code?: string);
+}
+/** 400 — Invalid input or Zod validation failure. */
+declare class ValidationError extends ServiceError {
+    constructor(message: string, details?: unknown);
+}
+/** 401 — Missing or invalid authentication credentials. */
+declare class UnauthorizedError extends ServiceError {
+    constructor(message?: string);
+}
+/** 403 — Authenticated but insufficient permissions. */
+declare class ForbiddenError extends ServiceError {
+    constructor(message?: string);
+}
+/** 404 — Resource does not exist. */
+declare class NotFoundError extends ServiceError {
+    constructor(message?: string);
+}
+/** 409 — Conflict with existing state (e.g., handle already taken). */
+declare class ConflictError extends ServiceError {
+    constructor(message?: string);
+}
+/** 429 — Client has sent too many requests. */
+declare class RateLimitError extends ServiceError {
+    constructor(message?: string);
+}
+
+export { ConflictError, ForbiddenError, NotFoundError, RateLimitError, ServiceError, UnauthorizedError, ValidationError };