palbase 0.27.0 → 0.28.0

package/types/internal/src/modules/events.d.ts

@@ -2,6 +2,7 @@ import type { WebhookEvent } from '../event.js';
 import type { Events as AiEvents } from './ai.js';
 import type { Events as AnalyticsEvents } from './analytics.js';
 import type { Events as AuthEvents } from './auth.js';
+import type { Events as CallsEvents } from './calls.js';
 import type { Events as FlagsEvents } from './flags.js';
 import type { Events as JourneysEvents } from './journeys.js';
 import type { Events as MessagingEvents } from './messaging.js';
@@ -10,16 +11,16 @@ import type { Events as PurchasesEvents } from './purchases.js';
 import type { Events as StorageEvents } from './storage.js';
 import type { Events as StoresEvents } from './stores.js';
 /** Every event the modules' contracts say they send the project's webhooks (x-palbase-events), by type: its payload, the event's data. */
-export interface PlatformEvents extends AiEvents, AnalyticsEvents, AuthEvents, FlagsEvents, JourneysEvents, MessagingEvents, NotifyEvents, PurchasesEvents, StorageEvents, StoresEvents {
+export interface PlatformEvents extends AiEvents, AnalyticsEvents, AuthEvents, CallsEvents, FlagsEvents, JourneysEvents, MessagingEvents, NotifyEvents, PurchasesEvents, StorageEvents, StoresEvents {
 }
 /** A platform event's type: one a module's contract declares. */
 export type EventType = keyof PlatformEvents;
 /** Every platform event's type, as the contracts declare them. */
-export declare const EVENT_TYPES: readonly ["ai.goal.updated", "ai.response.completed", "ai.response.failed", "ai.response.started", "ai.voice.closed", "ai.voice.delegated", "ai.voice.started", "ai.workspace.published", "ai.workspace.pushed", "audience.entered", "audience.exited", "consent.changed", "device.revoked", "file.deleted", "file.moved", "file.uploaded", "flag.changed", "flag.override_changed", "journey.converted", "journey.ended", "journey.entered", "journey.event", "journey.step", "messaging.conversation.created", "messaging.conversation.deleted", "messaging.conversation.read", "messaging.message.created", "messaging.report.created", "notification.action", "notification.bounced", "notification.complained", "notification.delivered", "notification.dismissed", "notification.expired", "notification.failed", "notification.not_shown", "notification.opened", "notification.push_failing", "notification.read", "notification.received", "notification.rejected", "notification.sent", "notification.unconfirmed", "notification.undelivered", "notification.uninstalled", "purchases.catalog.applied", "purchases.catalog.changed", "purchases.coupon.redeemed", "purchases.credits.depleted", "purchases.credits.low", "purchases.customer.changed", "purchases.customer.erased", "purchases.customer.merged", "purchases.entitlement.changed", "purchases.offer.redeemed", "purchases.ownership.transferred", "purchases.paywall.published", "purchases.purchase.completed", "purchases.quota.exhausted", "purchases.quota.threshold", "purchases.refund.changed", "purchases.store.changed", "purchases.subscription.changed", "session.ended", "stores.action.changed", "stores.app.changed", "stores.apple.changed", "stores.apple.key.made", "stores.apple.key.revoked", "stores.apple.session.changed", "stores.apple.session.ended", "stores.apple.session.expired", "stores.beta_review.changed", "stores.build.changed", "stores.delivery.changed", "stores.delivery.requested", "stores.feedback.received", "stores.google.changed", "stores.group.changed", "stores.package.changed", "stores.play_release.changed", "stores.product.changed", "stores.review.message", "stores.version.changed", "stores.version.reviewed", "stores.vitals.changed", "stores.webhook.changed", "user.converted", "user.deleted", "user.locale_changed", "user.permissions_changed"];
+export declare const EVENT_TYPES: readonly ["ai.goal.updated", "ai.response.completed", "ai.response.failed", "ai.response.started", "ai.voice.closed", "ai.voice.delegated", "ai.voice.started", "ai.workspace.published", "ai.workspace.pushed", "audience.entered", "audience.exited", "calls.call.ended", "calls.call.started", "calls.participant.joined", "calls.participant.left", "consent.changed", "device.revoked", "file.deleted", "file.moved", "file.uploaded", "flag.changed", "flag.override_changed", "journey.converted", "journey.ended", "journey.entered", "journey.event", "journey.step", "messaging.conversation.created", "messaging.conversation.deleted", "messaging.conversation.read", "messaging.message.created", "messaging.report.created", "notification.action", "notification.bounced", "notification.complained", "notification.delivered", "notification.dismissed", "notification.expired", "notification.failed", "notification.not_shown", "notification.opened", "notification.push_failing", "notification.read", "notification.received", "notification.rejected", "notification.sent", "notification.unconfirmed", "notification.undelivered", "notification.uninstalled", "purchases.catalog.applied", "purchases.catalog.changed", "purchases.coupon.redeemed", "purchases.credits.depleted", "purchases.credits.low", "purchases.customer.changed", "purchases.customer.erased", "purchases.customer.merged", "purchases.entitlement.changed", "purchases.offer.redeemed", "purchases.ownership.transferred", "purchases.paywall.published", "purchases.purchase.completed", "purchases.quota.exhausted", "purchases.quota.threshold", "purchases.refund.changed", "purchases.store.changed", "purchases.subscription.changed", "session.ended", "stores.action.changed", "stores.app.changed", "stores.apple.changed", "stores.apple.key.made", "stores.apple.key.revoked", "stores.apple.session.changed", "stores.apple.session.ended", "stores.apple.session.expired", "stores.beta_review.changed", "stores.build.changed", "stores.delivery.changed", "stores.delivery.requested", "stores.feedback.received", "stores.google.changed", "stores.group.changed", "stores.package.changed", "stores.play_release.changed", "stores.product.changed", "stores.review.message", "stores.version.changed", "stores.version.reviewed", "stores.vitals.changed", "stores.webhook.changed", "user.converted", "user.deleted", "user.locale_changed", "user.permissions_changed"];
 /**
  * A platform event as delivered: one member per type the contracts declare,
  * its data that type's payload, so a switch on its type narrows it. An
  * event of a type none of them declares (one a newer platform sends) is no
  * member: at run time it reaches the switch's default, which takes it.
  */
-export type PalbaseEvent = WebhookEvent<PlatformEvents["ai.goal.updated"], "ai.goal.updated"> | WebhookEvent<PlatformEvents["ai.response.completed"], "ai.response.completed"> | WebhookEvent<PlatformEvents["ai.response.failed"], "ai.response.failed"> | WebhookEvent<PlatformEvents["ai.response.started"], "ai.response.started"> | WebhookEvent<PlatformEvents["ai.voice.closed"], "ai.voice.closed"> | WebhookEvent<PlatformEvents["ai.voice.delegated"], "ai.voice.delegated"> | WebhookEvent<PlatformEvents["ai.voice.started"], "ai.voice.started"> | WebhookEvent<PlatformEvents["ai.workspace.published"], "ai.workspace.published"> | WebhookEvent<PlatformEvents["ai.workspace.pushed"], "ai.workspace.pushed"> | WebhookEvent<PlatformEvents["audience.entered"], "audience.entered"> | WebhookEvent<PlatformEvents["audience.exited"], "audience.exited"> | WebhookEvent<PlatformEvents["consent.changed"], "consent.changed"> | WebhookEvent<PlatformEvents["device.revoked"], "device.revoked"> | WebhookEvent<PlatformEvents["file.deleted"], "file.deleted"> | WebhookEvent<PlatformEvents["file.moved"], "file.moved"> | WebhookEvent<PlatformEvents["file.uploaded"], "file.uploaded"> | WebhookEvent<PlatformEvents["flag.changed"], "flag.changed"> | WebhookEvent<PlatformEvents["flag.override_changed"], "flag.override_changed"> | WebhookEvent<PlatformEvents["journey.converted"], "journey.converted"> | WebhookEvent<PlatformEvents["journey.ended"], "journey.ended"> | WebhookEvent<PlatformEvents["journey.entered"], "journey.entered"> | WebhookEvent<PlatformEvents["journey.event"], "journey.event"> | WebhookEvent<PlatformEvents["journey.step"], "journey.step"> | WebhookEvent<PlatformEvents["messaging.conversation.created"], "messaging.conversation.created"> | WebhookEvent<PlatformEvents["messaging.conversation.deleted"], "messaging.conversation.deleted"> | WebhookEvent<PlatformEvents["messaging.conversation.read"], "messaging.conversation.read"> | WebhookEvent<PlatformEvents["messaging.message.created"], "messaging.message.created"> | WebhookEvent<PlatformEvents["messaging.report.created"], "messaging.report.created"> | WebhookEvent<PlatformEvents["notification.action"], "notification.action"> | WebhookEvent<PlatformEvents["notification.bounced"], "notification.bounced"> | WebhookEvent<PlatformEvents["notification.complained"], "notification.complained"> | WebhookEvent<PlatformEvents["notification.delivered"], "notification.delivered"> | WebhookEvent<PlatformEvents["notification.dismissed"], "notification.dismissed"> | WebhookEvent<PlatformEvents["notification.expired"], "notification.expired"> | WebhookEvent<PlatformEvents["notification.failed"], "notification.failed"> | WebhookEvent<PlatformEvents["notification.not_shown"], "notification.not_shown"> | WebhookEvent<PlatformEvents["notification.opened"], "notification.opened"> | WebhookEvent<PlatformEvents["notification.push_failing"], "notification.push_failing"> | WebhookEvent<PlatformEvents["notification.read"], "notification.read"> | WebhookEvent<PlatformEvents["notification.received"], "notification.received"> | WebhookEvent<PlatformEvents["notification.rejected"], "notification.rejected"> | WebhookEvent<PlatformEvents["notification.sent"], "notification.sent"> | WebhookEvent<PlatformEvents["notification.unconfirmed"], "notification.unconfirmed"> | WebhookEvent<PlatformEvents["notification.undelivered"], "notification.undelivered"> | WebhookEvent<PlatformEvents["notification.uninstalled"], "notification.uninstalled"> | WebhookEvent<PlatformEvents["purchases.catalog.applied"], "purchases.catalog.applied"> | WebhookEvent<PlatformEvents["purchases.catalog.changed"], "purchases.catalog.changed"> | WebhookEvent<PlatformEvents["purchases.coupon.redeemed"], "purchases.coupon.redeemed"> | WebhookEvent<PlatformEvents["purchases.credits.depleted"], "purchases.credits.depleted"> | WebhookEvent<PlatformEvents["purchases.credits.low"], "purchases.credits.low"> | WebhookEvent<PlatformEvents["purchases.customer.changed"], "purchases.customer.changed"> | WebhookEvent<PlatformEvents["purchases.customer.erased"], "purchases.customer.erased"> | WebhookEvent<PlatformEvents["purchases.customer.merged"], "purchases.customer.merged"> | WebhookEvent<PlatformEvents["purchases.entitlement.changed"], "purchases.entitlement.changed"> | WebhookEvent<PlatformEvents["purchases.offer.redeemed"], "purchases.offer.redeemed"> | WebhookEvent<PlatformEvents["purchases.ownership.transferred"], "purchases.ownership.transferred"> | WebhookEvent<PlatformEvents["purchases.paywall.published"], "purchases.paywall.published"> | WebhookEvent<PlatformEvents["purchases.purchase.completed"], "purchases.purchase.completed"> | WebhookEvent<PlatformEvents["purchases.quota.exhausted"], "purchases.quota.exhausted"> | WebhookEvent<PlatformEvents["purchases.quota.threshold"], "purchases.quota.threshold"> | WebhookEvent<PlatformEvents["purchases.refund.changed"], "purchases.refund.changed"> | WebhookEvent<PlatformEvents["purchases.store.changed"], "purchases.store.changed"> | WebhookEvent<PlatformEvents["purchases.subscription.changed"], "purchases.subscription.changed"> | WebhookEvent<PlatformEvents["session.ended"], "session.ended"> | WebhookEvent<PlatformEvents["stores.action.changed"], "stores.action.changed"> | WebhookEvent<PlatformEvents["stores.app.changed"], "stores.app.changed"> | WebhookEvent<PlatformEvents["stores.apple.changed"], "stores.apple.changed"> | WebhookEvent<PlatformEvents["stores.apple.key.made"], "stores.apple.key.made"> | WebhookEvent<PlatformEvents["stores.apple.key.revoked"], "stores.apple.key.revoked"> | WebhookEvent<PlatformEvents["stores.apple.session.changed"], "stores.apple.session.changed"> | WebhookEvent<PlatformEvents["stores.apple.session.ended"], "stores.apple.session.ended"> | WebhookEvent<PlatformEvents["stores.apple.session.expired"], "stores.apple.session.expired"> | WebhookEvent<PlatformEvents["stores.beta_review.changed"], "stores.beta_review.changed"> | WebhookEvent<PlatformEvents["stores.build.changed"], "stores.build.changed"> | WebhookEvent<PlatformEvents["stores.delivery.changed"], "stores.delivery.changed"> | WebhookEvent<PlatformEvents["stores.delivery.requested"], "stores.delivery.requested"> | WebhookEvent<PlatformEvents["stores.feedback.received"], "stores.feedback.received"> | WebhookEvent<PlatformEvents["stores.google.changed"], "stores.google.changed"> | WebhookEvent<PlatformEvents["stores.group.changed"], "stores.group.changed"> | WebhookEvent<PlatformEvents["stores.package.changed"], "stores.package.changed"> | WebhookEvent<PlatformEvents["stores.play_release.changed"], "stores.play_release.changed"> | WebhookEvent<PlatformEvents["stores.product.changed"], "stores.product.changed"> | WebhookEvent<PlatformEvents["stores.review.message"], "stores.review.message"> | WebhookEvent<PlatformEvents["stores.version.changed"], "stores.version.changed"> | WebhookEvent<PlatformEvents["stores.version.reviewed"], "stores.version.reviewed"> | WebhookEvent<PlatformEvents["stores.vitals.changed"], "stores.vitals.changed"> | WebhookEvent<PlatformEvents["stores.webhook.changed"], "stores.webhook.changed"> | WebhookEvent<PlatformEvents["user.converted"], "user.converted"> | WebhookEvent<PlatformEvents["user.deleted"], "user.deleted"> | WebhookEvent<PlatformEvents["user.locale_changed"], "user.locale_changed"> | WebhookEvent<PlatformEvents["user.permissions_changed"], "user.permissions_changed">;
+export type PalbaseEvent = WebhookEvent<PlatformEvents["ai.goal.updated"], "ai.goal.updated"> | WebhookEvent<PlatformEvents["ai.response.completed"], "ai.response.completed"> | WebhookEvent<PlatformEvents["ai.response.failed"], "ai.response.failed"> | WebhookEvent<PlatformEvents["ai.response.started"], "ai.response.started"> | WebhookEvent<PlatformEvents["ai.voice.closed"], "ai.voice.closed"> | WebhookEvent<PlatformEvents["ai.voice.delegated"], "ai.voice.delegated"> | WebhookEvent<PlatformEvents["ai.voice.started"], "ai.voice.started"> | WebhookEvent<PlatformEvents["ai.workspace.published"], "ai.workspace.published"> | WebhookEvent<PlatformEvents["ai.workspace.pushed"], "ai.workspace.pushed"> | WebhookEvent<PlatformEvents["audience.entered"], "audience.entered"> | WebhookEvent<PlatformEvents["audience.exited"], "audience.exited"> | WebhookEvent<PlatformEvents["calls.call.ended"], "calls.call.ended"> | WebhookEvent<PlatformEvents["calls.call.started"], "calls.call.started"> | WebhookEvent<PlatformEvents["calls.participant.joined"], "calls.participant.joined"> | WebhookEvent<PlatformEvents["calls.participant.left"], "calls.participant.left"> | WebhookEvent<PlatformEvents["consent.changed"], "consent.changed"> | WebhookEvent<PlatformEvents["device.revoked"], "device.revoked"> | WebhookEvent<PlatformEvents["file.deleted"], "file.deleted"> | WebhookEvent<PlatformEvents["file.moved"], "file.moved"> | WebhookEvent<PlatformEvents["file.uploaded"], "file.uploaded"> | WebhookEvent<PlatformEvents["flag.changed"], "flag.changed"> | WebhookEvent<PlatformEvents["flag.override_changed"], "flag.override_changed"> | WebhookEvent<PlatformEvents["journey.converted"], "journey.converted"> | WebhookEvent<PlatformEvents["journey.ended"], "journey.ended"> | WebhookEvent<PlatformEvents["journey.entered"], "journey.entered"> | WebhookEvent<PlatformEvents["journey.event"], "journey.event"> | WebhookEvent<PlatformEvents["journey.step"], "journey.step"> | WebhookEvent<PlatformEvents["messaging.conversation.created"], "messaging.conversation.created"> | WebhookEvent<PlatformEvents["messaging.conversation.deleted"], "messaging.conversation.deleted"> | WebhookEvent<PlatformEvents["messaging.conversation.read"], "messaging.conversation.read"> | WebhookEvent<PlatformEvents["messaging.message.created"], "messaging.message.created"> | WebhookEvent<PlatformEvents["messaging.report.created"], "messaging.report.created"> | WebhookEvent<PlatformEvents["notification.action"], "notification.action"> | WebhookEvent<PlatformEvents["notification.bounced"], "notification.bounced"> | WebhookEvent<PlatformEvents["notification.complained"], "notification.complained"> | WebhookEvent<PlatformEvents["notification.delivered"], "notification.delivered"> | WebhookEvent<PlatformEvents["notification.dismissed"], "notification.dismissed"> | WebhookEvent<PlatformEvents["notification.expired"], "notification.expired"> | WebhookEvent<PlatformEvents["notification.failed"], "notification.failed"> | WebhookEvent<PlatformEvents["notification.not_shown"], "notification.not_shown"> | WebhookEvent<PlatformEvents["notification.opened"], "notification.opened"> | WebhookEvent<PlatformEvents["notification.push_failing"], "notification.push_failing"> | WebhookEvent<PlatformEvents["notification.read"], "notification.read"> | WebhookEvent<PlatformEvents["notification.received"], "notification.received"> | WebhookEvent<PlatformEvents["notification.rejected"], "notification.rejected"> | WebhookEvent<PlatformEvents["notification.sent"], "notification.sent"> | WebhookEvent<PlatformEvents["notification.unconfirmed"], "notification.unconfirmed"> | WebhookEvent<PlatformEvents["notification.undelivered"], "notification.undelivered"> | WebhookEvent<PlatformEvents["notification.uninstalled"], "notification.uninstalled"> | WebhookEvent<PlatformEvents["purchases.catalog.applied"], "purchases.catalog.applied"> | WebhookEvent<PlatformEvents["purchases.catalog.changed"], "purchases.catalog.changed"> | WebhookEvent<PlatformEvents["purchases.coupon.redeemed"], "purchases.coupon.redeemed"> | WebhookEvent<PlatformEvents["purchases.credits.depleted"], "purchases.credits.depleted"> | WebhookEvent<PlatformEvents["purchases.credits.low"], "purchases.credits.low"> | WebhookEvent<PlatformEvents["purchases.customer.changed"], "purchases.customer.changed"> | WebhookEvent<PlatformEvents["purchases.customer.erased"], "purchases.customer.erased"> | WebhookEvent<PlatformEvents["purchases.customer.merged"], "purchases.customer.merged"> | WebhookEvent<PlatformEvents["purchases.entitlement.changed"], "purchases.entitlement.changed"> | WebhookEvent<PlatformEvents["purchases.offer.redeemed"], "purchases.offer.redeemed"> | WebhookEvent<PlatformEvents["purchases.ownership.transferred"], "purchases.ownership.transferred"> | WebhookEvent<PlatformEvents["purchases.paywall.published"], "purchases.paywall.published"> | WebhookEvent<PlatformEvents["purchases.purchase.completed"], "purchases.purchase.completed"> | WebhookEvent<PlatformEvents["purchases.quota.exhausted"], "purchases.quota.exhausted"> | WebhookEvent<PlatformEvents["purchases.quota.threshold"], "purchases.quota.threshold"> | WebhookEvent<PlatformEvents["purchases.refund.changed"], "purchases.refund.changed"> | WebhookEvent<PlatformEvents["purchases.store.changed"], "purchases.store.changed"> | WebhookEvent<PlatformEvents["purchases.subscription.changed"], "purchases.subscription.changed"> | WebhookEvent<PlatformEvents["session.ended"], "session.ended"> | WebhookEvent<PlatformEvents["stores.action.changed"], "stores.action.changed"> | WebhookEvent<PlatformEvents["stores.app.changed"], "stores.app.changed"> | WebhookEvent<PlatformEvents["stores.apple.changed"], "stores.apple.changed"> | WebhookEvent<PlatformEvents["stores.apple.key.made"], "stores.apple.key.made"> | WebhookEvent<PlatformEvents["stores.apple.key.revoked"], "stores.apple.key.revoked"> | WebhookEvent<PlatformEvents["stores.apple.session.changed"], "stores.apple.session.changed"> | WebhookEvent<PlatformEvents["stores.apple.session.ended"], "stores.apple.session.ended"> | WebhookEvent<PlatformEvents["stores.apple.session.expired"], "stores.apple.session.expired"> | WebhookEvent<PlatformEvents["stores.beta_review.changed"], "stores.beta_review.changed"> | WebhookEvent<PlatformEvents["stores.build.changed"], "stores.build.changed"> | WebhookEvent<PlatformEvents["stores.delivery.changed"], "stores.delivery.changed"> | WebhookEvent<PlatformEvents["stores.delivery.requested"], "stores.delivery.requested"> | WebhookEvent<PlatformEvents["stores.feedback.received"], "stores.feedback.received"> | WebhookEvent<PlatformEvents["stores.google.changed"], "stores.google.changed"> | WebhookEvent<PlatformEvents["stores.group.changed"], "stores.group.changed"> | WebhookEvent<PlatformEvents["stores.package.changed"], "stores.package.changed"> | WebhookEvent<PlatformEvents["stores.play_release.changed"], "stores.play_release.changed"> | WebhookEvent<PlatformEvents["stores.product.changed"], "stores.product.changed"> | WebhookEvent<PlatformEvents["stores.review.message"], "stores.review.message"> | WebhookEvent<PlatformEvents["stores.version.changed"], "stores.version.changed"> | WebhookEvent<PlatformEvents["stores.version.reviewed"], "stores.version.reviewed"> | WebhookEvent<PlatformEvents["stores.vitals.changed"], "stores.vitals.changed"> | WebhookEvent<PlatformEvents["stores.webhook.changed"], "stores.webhook.changed"> | WebhookEvent<PlatformEvents["user.converted"], "user.converted"> | WebhookEvent<PlatformEvents["user.deleted"], "user.deleted"> | WebhookEvent<PlatformEvents["user.locale_changed"], "user.locale_changed"> | WebhookEvent<PlatformEvents["user.permissions_changed"], "user.permissions_changed">;

package/types/internal/src/modules/index.d.ts

@@ -2,6 +2,7 @@ export * as ai from './ai.js';
 export * as analytics from './analytics.js';
 export * as auth from './auth.js';
 export * as cache from './cache.js';
+export * as calls from './calls.js';
 export * as flags from './flags.js';
 export * as journeys from './journeys.js';
 export * as machines from './machines.js';

package/types/internal/src/modules/messaging.d.ts

@@ -293,6 +293,51 @@ export type BlockPage = {
      */
     next_cursor?: string;
 };
+/**
+ * A call made from a conversation, as its call message keeps it (the calls module's word).
+ */
+export type CallRecord = {
+    /**
+     * When it was answered
+     */
+    answered_at: string | null;
+    /**
+     * The call (GET /calls/{call_id})
+     */
+    call_id: string;
+    /**
+     * Who called
+     */
+    caller_id: string;
+    /**
+     * Why it ended: hung_up, canceled, declined, missed, busy, failed or ended
+     */
+    end_reason: string | null;
+    /**
+     * When it ended
+     */
+    ended_at: string | null;
+    /**
+     * Two people, or a group
+     */
+    kind: "direct" | "group";
+    /**
+     * How long it lasted, from its answer to its end
+     */
+    seconds: number;
+    /**
+     * When it was made
+     */
+    started_at: string;
+    /**
+     * Ringing, going on, or over
+     */
+    state: "ringing" | "active" | "ended";
+    /**
+     * A video call (else voice)
+     */
+    video: boolean;
+};
 /**
  * A conversation as a member reads it.
  */
@@ -822,6 +867,10 @@ export type Message = {
      * Its files.
      */
     attachments: Attachment[];
+    /**
+     * What a call message keeps of its call (kind call): written as the call starts, and again as it is answered and as it ends. It counts as no unread message.
+     */
+    call: CallRecord | null;
     /**
      * The writer's app's own id of it.
      */
@@ -855,9 +904,9 @@ export type Message = {
      */
     id: string;
     /**
-     * text, media (files) or system.
+     * text, media (files), system, or call (a call made from the conversation: `call` says how it went).
      */
-    kind: "text" | "media" | "system";
+    kind: "text" | "media" | "system" | "call";
     /**
      * When its thread was last answered.
      */
@@ -2407,7 +2456,8 @@ export declare function client(t: Transport): {
             limit?: number; /** The cursor a page handed out (next_cursor). */
             cursor?: string; /** Open the timeline at this message: the page holds it, about half the page before it and half after (next_cursor pages back, newer_cursor forward). A thread's answer is read in its thread (`in_thread`). */
             around?: string; /** The cursor a page handed out to read on toward the newest (newer_cursor). */
-            after?: string;
+            after?: string; /** Only messages of this kind — text, media, system or call; several comma-separated (call: the calls made from the conversation). */
+            kind?: string;
         }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
         signal?: AbortSignal;
     }): Promise<Reply<200, MessagePage>>;

package/types/internal/src/modules/realtime.d.ts

@@ -307,7 +307,7 @@ export declare function client(t: Transport): {
     /**
      * Declare the channels
      *
-     * Replaces the project's channel declaration, in its order (100 at most). A pattern is ':'-separated segments; a {name} segment matches exactly one. `owner`: the pattern's one {name} must be the joining user, who may do everything on it. `public`: any signed-in user of the project subscribes, and may publish and read or write state as declared. A channel no pattern matches belongs to no one. roles:, flags:, messaging: and debug: are the platform's. Open sockets are decided again within a heartbeat.
+     * Replaces the project's channel declaration, in its order (100 at most). A pattern is ':'-separated segments; a {name} segment matches exactly one. `owner`: the pattern's one {name} must be the joining user, who may do everything on it. `public`: any signed-in user of the project subscribes, and may publish and read or write state as declared. A channel no pattern matches belongs to no one. roles:, flags:, messaging:, calls: and debug: are the platform's. Open sockets are decided again within a heartbeat.
      */
     putChannels(input: {
         body: ChannelDeclaration; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */

package/types/server/src/server.d.ts

@@ -26,6 +26,13 @@ export interface PalbaseServer {
     auth: ReturnType<typeof modules.auth.client>;
     /** The project's cache entries; palbase/backend's Cache is the way to use them. */
     cache: ReturnType<typeof modules.cache.client>;
+    /**
+     * The project's calls: their settings (getCallSettings, putCallSettings, rotateCallHookSecret), the calls read and
+     * ended (adminListCalls, adminGetCall, adminEndCall), and the project's own agent let into one —
+     * createCallTicket({ path: { call_id }, body: { identity } }) answers the media server's url and an access token its
+     * open-source agent libraries connect with as they are.
+     */
+    calls: ReturnType<typeof modules.calls.client>;
     /**
      * The project's encrypted database fields (fields.ts): `await
      * palbase.fields.load()` at startup, then encrypt, decrypt and lookup —

package/types/web/src/calls-ui/index.d.ts

@@ -0,0 +1,71 @@
+import type { Call, CallSession, Calls } from '../calls.js';
+/** Every word the screens show. */
+export interface CallUITexts {
+    incomingVoice: string;
+    incomingVideo: string;
+    accept: string;
+    acceptVoiceOnly: string;
+    decline: string;
+    calling: string;
+    connecting: string;
+    reconnecting: string;
+    /** How the call ended for this device, by its endReason; `ended` for any other. */
+    declined: string;
+    missed: string;
+    busy: string;
+    hungUp: string;
+    canceled: string;
+    failed: string;
+    answeredElsewhere: string;
+    left: string;
+    ended: string;
+}
+/** What a screen reader says of what shows no words of its own. */
+export interface CallUILabels {
+    /** The ringing sheet. */
+    incoming: string;
+    /** The call's view. */
+    call: string;
+    mute: string;
+    unmute: string;
+    cameraOn: string;
+    cameraOff: string;
+    switchCamera: string;
+    hangUp: string;
+    /** This device's camera. */
+    self: string;
+}
+/** The screens' colors, corners and font: CSS values, set as --pb-call-<name> on the root element. */
+export interface CallUITheme {
+    accent?: string;
+    background?: string;
+    foreground?: string;
+    danger?: string;
+    /** A length; a number is pixels. */
+    radius?: string | number;
+    font?: string;
+}
+export interface CallUIOptions {
+    /** The element the screens are drawn in (positioned): over the whole page (the body) unless given. */
+    container?: HTMLElement;
+    texts?: Partial<CallUITexts>;
+    labels?: Partial<CallUILabels>;
+    /** The light and dark colors the system asks for, unless given. */
+    theme?: CallUITheme;
+    /** Added to the root element's classes. */
+    className?: string;
+    /** A soft ring while a sheet shows (true by default); silent where the page may not play sound yet. */
+    ringtone?: boolean;
+    /** Asked once for each call that rings: false leaves it to the app's own screen. */
+    incoming?(call: Call, session: CallSession): boolean;
+    /** An answer, a microphone or a camera that failed (the person refused the camera, the network). */
+    onError?(error: unknown, session: CallSession): void;
+}
+export interface CallUI {
+    /** Takes the screens away and stops listening; a call goes on. */
+    unmount(): void;
+}
+export declare const CALL_UI_TEXTS: Readonly<CallUITexts>;
+export declare const CALL_UI_LABELS: Readonly<CallUILabels>;
+/** Shows pb.calls' ringing calls and the call this page is in, until unmount. */
+export declare function mountCallUI(calls: Calls, options?: CallUIOptions): CallUI;

package/types/web/src/calls.d.ts

@@ -0,0 +1,274 @@
+import { calls as api } from '../../internal/src/modules/index.js';
+/** A call as the module keeps it: its people, its state, how it ended. */
+export type Call = api.Call;
+/** A person (or the project's agent) in a call, as the call lists them. */
+export type CallParticipant = api.Participant;
+/** A page of calls, newest first. */
+export type CallPage = api.CallPage;
+type Listener = () => void;
+/**
+ * Where a call is, as this device has it:
+ * - `calling` — the person called is being rung;
+ * - `incoming` — this person is rung; `invited` — asked into a call that does not ring (a huddle: join it);
+ * - `connecting` — answered, the media on its way; `connected`; `reconnecting` — the network dropped for a moment;
+ * - `elsewhere` — answered on another device or in another tab;
+ * - `ended` — over for this device (endReason says why).
+ */
+export type CallPhase = 'calling' | 'incoming' | 'invited' | 'connecting' | 'connected' | 'reconnecting' | 'elsewhere' | 'ended';
+/** Someone else in the call, and what is heard and seen of them. */
+export interface RemoteParticipant {
+    /** Their user id — or, for the project's agent, bot:<identity>. */
+    userId: string;
+    name: string | null;
+    imageUrl: string | null;
+    bot: boolean;
+    /** Their audio and video: one stream for the whole call, whichever way the media flows. */
+    stream: MediaStream;
+    /** Their microphone is heard. */
+    audio: boolean;
+    /** Their camera is seen. */
+    video: boolean;
+}
+export interface CallState {
+    /** The call as the module last said it (the highest version heard). */
+    call: Call;
+    /** This person, as the call lists them. */
+    me: CallParticipant | null;
+    phase: CallPhase;
+    /** This person rang (or started the group). */
+    outgoing: boolean;
+    /** Between the two devices, or through the media server. */
+    mode: 'p2p' | 'sfu';
+    /** This device's microphone and camera, while it is in the call. */
+    local: MediaStream | null;
+    microphone: boolean;
+    camera: boolean;
+    /** The others in the call. */
+    remote: RemoteParticipant[];
+    /** Why it ended for this device: the call's end_reason, `left` (this person left a group that goes on), `declined`, `missed`, `answered_elsewhere`. */
+    endReason: string | null;
+    /** The last thing that went wrong with this device's media (a camera refused, the media server not reached). */
+    error: Error | null;
+}
+export interface StartCallOptions {
+    /** A video call; a voice call unless true (pb.calls.video and pb.calls.voice say it). */
+    video?: boolean;
+    /** Ring the people asked (true by default); false: a group call they join (a huddle). */
+    ring?: boolean;
+    /** A group call even with one person asked: others may be asked later. */
+    group?: boolean;
+    /** The conversation it is made from: its members alone may be called, and it keeps the call as a message. */
+    conversationId?: string;
+    /** The app's own words about the call, shown to those rung (32 strings, 2 KiB at most). */
+    metadata?: Record<string, string>;
+    /** The name and picture shown to those rung; else the caller's messaging profile's. */
+    callerName?: string;
+    callerImageUrl?: string;
+    /** This call's media through the relay alone (CallsOptions.forceRelay, for one call). */
+    forceRelay?: boolean;
+    /** A microphone (and camera) stream the app opened already; left open when the call ends. */
+    media?: MediaStream;
+}
+export interface AnswerOptions {
+    /** Send video (the call's own kind unless said): a video call answered by voice, or a voice call with the camera on. */
+    video?: boolean;
+    forceRelay?: boolean;
+    media?: MediaStream;
+}
+export interface HistoryOptions {
+    /** 1 to 100; 20 when absent. */
+    limit?: number;
+    /** The page after the one that handed out this cursor (next_cursor). */
+    cursor?: string;
+    /** Only the calls the person missed (or was busy for). */
+    missed?: boolean;
+    state?: 'ringing' | 'active' | 'ended';
+}
+/** The browser's media, as calls uses it: a test's or a runtime's own. */
+export interface CallsRTC {
+    RTCPeerConnection: typeof RTCPeerConnection;
+    MediaStream: typeof MediaStream;
+    getUserMedia(constraints: MediaStreamConstraints): Promise<MediaStream>;
+}
+export interface CallsOptions {
+    /**
+     * Every call's media through the relay (iceTransportPolicy relay), never straight between the devices: neither
+     * learns the other's address, at the price of a hop. The project's relay_all setting says it for every app.
+     */
+    forceRelay?: boolean;
+    /** The others' voices play by themselves (true by default): false leaves each RemoteParticipant's stream to the app. */
+    playAudio?: boolean;
+}
+/**
+ * One call as this device has it: its state to draw (subscribe), and what the person does in it. Made by
+ * pb.calls.start/voice/video/join, or heard (pb.calls.onIncoming).
+ */
+export declare class CallSession {
+    readonly id: string;
+    private c;
+    private call;
+    private snapshot;
+    private readonly listeners;
+    /** This tab acts in the call: it made, answered or joined it here. */
+    private owned;
+    /** This tab is answering or joining it: what the module says meanwhile does not end it. */
+    private entering;
+    private phase;
+    private endReason;
+    private error;
+    private relay;
+    private local;
+    private tracks;
+    /** The tracks this device opened, stopped when the call is done with them; an app's own stream is left open. */
+    private readonly opened;
+    private mic;
+    private facing;
+    private link;
+    private linking;
+    private linkState;
+    private sdpSent;
+    private answered;
+    private answer;
+    private inbox;
+    private lastSeq;
+    private readonly seen;
+    private readonly sentSeqs;
+    private room;
+    private joiningRoom;
+    private roomState;
+    private readonly streams;
+    private readonly via;
+    private readonly mutedInRoom;
+    private readonly players;
+    private sink;
+    private quieted;
+    private heartbeat;
+    private poll;
+    private done;
+    get state(): CallState;
+    /** Listens to every change of state; returns the unsubscribe. */
+    subscribe(listener: Listener): () => void;
+    /** Answers the call on this device (the first of the person's devices to answer has it). */
+    accept(o?: AnswerOptions): Promise<void>;
+    /** Comes into a group call this person was asked to (or was in before). */
+    join(o?: AnswerOptions): Promise<void>;
+    /** Turns the call down on every device of this person's: a direct call ends; a group goes on, and may still be joined. */
+    decline(): Promise<void>;
+    /** Hangs up (or, while it rings, cancels): a direct call ends for both; a group goes on for the others. */
+    leave(): Promise<void>;
+    /** Asks more people in (ringing them unless ring is false): a direct call becomes a group, going on. */
+    invite(userIds: string | string[], o?: {
+        ring?: boolean;
+    }): Promise<void>;
+    /** The microphone heard (true) or muted. */
+    setMicrophone(on: boolean): Promise<void>;
+    /** The camera on or off: off, it is closed (its light goes out); on, opened again — a voice call's too. */
+    setCamera(on: boolean): Promise<void>;
+    /** Another camera: the one named (a videoinput's deviceId), or the other facing one (front, back). */
+    switchCamera(deviceId?: string): Promise<void>;
+    /** Where the others' voices play: an audiooutput's deviceId (a browser that can choose one: setSinkId). */
+    setAudioOutput(deviceId: string): Promise<void>;
+    /** Reads the call as it is now. */
+    refresh(): Promise<void>;
+    private me;
+    /** What the call now means for this device, and the media that follows. */
+    private derive;
+    private mediaPhase;
+    private enter;
+    /** This device's microphone (and camera): the app's stream, or opened here. */
+    private open;
+    private camera;
+    /** The camera's track now (null: off), wherever the media flows. */
+    private putVideo;
+    private toPeer;
+    /** Sends a signal once the call is answered (nothing leaves before): an offer or answer in order, candidates after it. */
+    private signal;
+    private take;
+    /** A signal between the last one handled and this one that is neither handled nor this device's own: missed. */
+    private gapBefore;
+    private fetchSignals;
+    private handle;
+    /** The connection between the devices is gone: what came through it goes too. */
+    private unlink;
+    private toRoom;
+    private streamOf;
+    private heard;
+    private gone;
+    private play;
+    private beat;
+    private stillHere;
+    private end;
+    /** The tracks this device opened are closed: the camera's light goes out. */
+    private release;
+    private stopIfOpened;
+    /** Its notification goes, once: the call no longer rings here. */
+    private quiet;
+    private failed;
+    private refusal;
+    private refused;
+    private changed;
+    private remoteOf;
+}
+/** pb.calls: the signed-in person's calls. */
+export declare class Calls {
+    /** This install's device id: the one its pushes are registered with (web-<installation id>). */
+    readonly deviceId: string;
+    private readonly transportFor;
+    private readonly session;
+    private readonly socket;
+    private readonly ref;
+    private readonly opts;
+    private readonly beacon;
+    private user;
+    private api;
+    private channel;
+    private off;
+    private readonly sessions;
+    private readonly incoming;
+    private readonly entered;
+    private workerHeard;
+    /** The call this page is in (made, answered or joined here), or null. */
+    get current(): CallSession | null;
+    /**
+     * Calls one person (a direct call: their devices ring) or several (a group call), from this device — its
+     * microphone (and camera) asked for first: a refusal rings no one. A call to someone calling this person this moment
+     * is that call, answered. Refused with a PalbaseError: `not_allowed` (403), `in_another_call` (409),
+     * `too_many_calls` or `quota_exceeded` (429), `invalid_user_ids` or `call_full` (400).
+     */
+    start(userIds: string | string[], o?: StartCallOptions): Promise<CallSession>;
+    /** A voice call. */
+    voice(userIds: string | string[], o?: Omit<StartCallOptions, 'video'>): Promise<CallSession>;
+    /** A video call. */
+    video(userIds: string | string[], o?: Omit<StartCallOptions, 'video'>): Promise<CallSession>;
+    /** Comes into a group call this person was asked to — a huddle, one they declined or left — on this device. */
+    join(callId: string, o?: AnswerOptions): Promise<CallSession>;
+    /**
+     * Listens for calls that ring this person (and group calls they are asked to: phase `invited`), while the page is
+     * open — and those ringing as it opens (a tap on the call's notification). Returns the unsubscribe.
+     */
+    onIncoming(listener: (call: CallSession) => void): () => void;
+    /** Listens for each call this page comes into — made, answered or joined here (a call UI follows them). Returns the unsubscribe. */
+    onCall(listener: (call: CallSession) => void): () => void;
+    /** This person's calls, newest first, with how each went for them (their participant's state: `missed` among them). */
+    history(o?: HistoryOptions): Promise<CallPage>;
+    /** A call of this person's, as it is now. */
+    get(callId: string): Promise<Call>;
+    /**
+     * Follows the signed-in person's calls (start, join and onIncoming do it themselves): their channel, and the calls
+     * ringing them now. Rejects when no one is signed in.
+     */
+    ready(): Promise<void>;
+    private stop;
+    private unfollow;
+    private follow;
+    /** The calls ringing this person now: a page opened by the call's notification, or a channel that was down. */
+    private ringing;
+    /** A tap on a call's notification, told by the service worker (palbase/web/push-sw.js). */
+    private listenToWorker;
+    private heardCall;
+    private tell;
+    /** The session of a call: the one kept, or a new one (entering: this device is about to answer or join it). */
+    private sessionOf;
+    private rtc;
+}
+export {};

package/types/web/src/client.d.ts

@@ -11,6 +11,7 @@ import { Purchases } from './purchases.js';
 import { type ChatToolCall } from './chat.js';
 import { Flags } from './flags.js';
 import { Messaging, type MessagingOptions } from './messaging.js';
+import { Calls, type CallsOptions } from './calls.js';
 export interface ClientOptions {
     /** The project's address: https://<ref>.<domain> */
     url: string;
@@ -71,6 +72,8 @@ export interface ClientOptions {
     language?: string | readonly string[];
     /** What the device keeps of the signed-in person's conversations (pb.messaging): dropped on sign-out unless keepOnSignOut. */
     messaging?: MessagingOptions;
+    /** How the signed-in person's calls go (pb.calls): every call through the relay (forceRelay), voices played by themselves (playAudio). */
+    calls?: CallsOptions;
 }
 /**
  * The app's client. A backend's generated Palbe module (palbase apps:sync)
@@ -98,6 +101,8 @@ export interface PalbaseClient {
     flags: Flags;
     /** The signed-in person's conversations — direct ones and groups — kept up to date, on the device and live. */
     messaging: Messaging;
+    /** The signed-in person's voice and video calls: made, rung, answered — one to one or in a group. */
+    calls: Calls;
     /** The language every request says from now on (ClientOptions.language); null for the browser's own. */
     setLanguage(language: string | readonly string[] | null): void;
     /**

package/types/web/src/index.d.ts

@@ -11,6 +11,7 @@ export { Purchases, redemptionToken, type CheckoutSource, type CustomerInfo, typ
 export { Notify, WebPush, type PushPermission, type PushSubscribeOptions } from './notify.js';
 export { Flags, type FlagSource, type FlagsListener } from './flags.js';
 export { ConversationList, ConversationView, DeletedGroupList, indexedDBKeyValue, Messaging, ScheduledList, ThreadView, type Conversation, type ConversationMatch, type ConversationViewState, type ConversationListState, type DeletedGroup, type DeletedGroupListState, type Entry, type Hit, type Member, type Message, type MessagingOptions, type MyProfile, type Observed, type OpenedFile, type OutboxItem, type OutgoingFile, type Profile, type ScheduledMessage, type SearchHit, type SearchMatch, type SearchOptions, type SearchResults, type SendOptions, type ThreadState, type ThreadViewState, } from './messaging.js';
+export { Calls, CallSession, type AnswerOptions, type Call, type CallPage, type CallParticipant, type CallPhase, type CallsOptions, type CallState, type HistoryOptions, type RemoteParticipant, type StartCallOptions, } from './calls.js';
 export { Inbox, type InboxItem, type InboxListOptions, type InboxPage, type InboxView, type InboxViewOptions } from './inbox.js';
 export { InApp, SESSION_START, type InAppOptions } from './inapp.js';
 export type { Paywall, PaywallRenderOptions } from './paywall/placement.js';