@robono/server 0.9.1 → 0.13.0

package/dist/messaging-media.d.ts

@@ -0,0 +1,78 @@
+import type { RobonoMessagingBackend } from './messaging.js';
+export interface MessagingStoredMedia {
+    assetId: string;
+    mimeType: string;
+    fileName: string;
+    byteSize: number;
+    durationMs?: number;
+}
+export interface MessagingUploadFile {
+    mimeType: string;
+    fileName: string;
+    byteSize: number;
+    durationMs?: number;
+}
+export type MessagingMediaKind = 'voice' | 'image' | 'video' | 'document';
+export interface MessagingStorageContext {
+    actorId: string;
+    uploadId: string;
+    conversationId: string;
+}
+export interface MessagingPrivateStorage {
+    /** Optional combined operation for managed storage. MUST check current membership,
+     * blocks, message visibility/expiry and asset ownership before issuing a URL.
+     * Return authoritative metadata; never trust a phone-supplied asset ID. */
+    authorizeDownload?(input: {
+        actorId: string;
+        conversationId: string;
+        messageId: string;
+    }): Promise<{
+        url: string;
+        headers?: Record<string, string>;
+        media: MessagingStoredMedia;
+    }>;
+    /** Persist actor/conversation/kind/file against uploadId before returning a short-lived PUT URL. Repeated prepare must return the same upload. */
+    prepare(input: MessagingStorageContext & {
+        kind: MessagingMediaKind;
+        file: MessagingUploadFile;
+    }): Promise<{
+        url: string;
+        headers?: Record<string, string>;
+    } | {
+        media: MessagingStoredMedia;
+    }>;
+    /** Verify OWNERSHIP and ACTUAL stored bytes/type/duration; return the original persisted kind, not a phone-supplied value. Idempotent. */
+    complete(input: MessagingStorageContext): Promise<{
+        kind: MessagingMediaKind;
+        media: MessagingStoredMedia;
+    }>;
+    /** Resolve only this authorized message's asset to a short-lived private download URL. */
+    download(input: {
+        actorId: string;
+        conversationId: string;
+        messageId: string;
+        media: MessagingStoredMedia;
+    }): Promise<{
+        url: string;
+        headers?: Record<string, string>;
+    }>;
+    /** Only discard this actor's uncommitted/unreferenced upload. Must tolerate racing or repeated requests. */
+    discard(input: {
+        actorId: string;
+        uploadId: string;
+    }): Promise<void>;
+}
+/** Mount on YOUR backend. No native code or storage-provider credentials are supplied by the phone. */
+export declare function createMessagingMediaBackendAdapter(options: {
+    robono: RobonoMessagingBackend;
+    authenticate: (request: Request) => Promise<string | null>;
+    authorize: (input: {
+        actorId: string;
+        operation: string;
+        conversationId?: string;
+        uploadId?: string;
+        request: Request;
+    }) => Promise<boolean>;
+    storage: MessagingPrivateStorage;
+}): (request: Request) => Promise<Response>;
+//# sourceMappingURL=messaging-media.d.ts.map

package/dist/messaging-media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging-media.d.ts","sourceRoot":"","sources":["../src/messaging-media.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,gBAAgB,CAAC;AAE3D,MAAM,WAAW,oBAAoB;IAAE,OAAO,EAAC,MAAM,CAAC;IAAA,QAAQ,EAAC,MAAM,CAAC;IAAA,QAAQ,EAAC,MAAM,CAAC;IAAA,QAAQ,EAAC,MAAM,CAAC;IAAA,UAAU,CAAC,EAAC,MAAM,CAAA;CAAC;AACzH,MAAM,WAAW,mBAAmB;IAAE,QAAQ,EAAC,MAAM,CAAC;IAAA,QAAQ,EAAC,MAAM,CAAC;IAAA,QAAQ,EAAC,MAAM,CAAC;IAAA,UAAU,CAAC,EAAC,MAAM,CAAA;CAAC;AACzG,MAAM,MAAM,kBAAkB,GAAC,OAAO,GAAC,OAAO,GAAC,OAAO,GAAC,UAAU,CAAC;AAClE,MAAM,WAAW,uBAAuB;IAAE,OAAO,EAAC,MAAM,CAAC;IAAA,QAAQ,EAAC,MAAM,CAAC;IAAA,cAAc,EAAC,MAAM,CAAA;CAAC;AAC/F,MAAM,WAAW,uBAAuB;IACtC;;+EAE2E;IAC3E,iBAAiB,CAAC,CAAC,KAAK,EAAC;QAAC,OAAO,EAAC,MAAM,CAAC;QAAA,cAAc,EAAC,MAAM,CAAC;QAAA,SAAS,EAAC,MAAM,CAAA;KAAC,GAAE,OAAO,CAAC;QAAC,GAAG,EAAC,MAAM,CAAC;QAAA,OAAO,CAAC,EAAC,MAAM,CAAC,MAAM,EAAC,MAAM,CAAC,CAAC;QAAA,KAAK,EAAC,oBAAoB,CAAA;KAAC,CAAC,CAAC;IAClK,kJAAkJ;IAClJ,OAAO,CAAC,KAAK,EAAC,uBAAuB,GAAC;QAAC,IAAI,EAAC,kBAAkB,CAAC;QAAA,IAAI,EAAC,mBAAmB,CAAA;KAAC,GAAE,OAAO,CAAC;QAAC,GAAG,EAAC,MAAM,CAAC;QAAA,OAAO,CAAC,EAAC,MAAM,CAAC,MAAM,EAAC,MAAM,CAAC,CAAA;KAAC,GAAC;QAAC,KAAK,EAAC,oBAAoB,CAAA;KAAC,CAAC,CAAC;IAC5K,0IAA0I;IAC1I,QAAQ,CAAC,KAAK,EAAC,uBAAuB,GAAE,OAAO,CAAC;QAAC,IAAI,EAAC,kBAAkB,CAAC;QAAA,KAAK,EAAC,oBAAoB,CAAA;KAAC,CAAC,CAAC;IACtG,0FAA0F;IAC1F,QAAQ,CAAC,KAAK,EAAC;QAAC,OAAO,EAAC,MAAM,CAAC;QAAA,cAAc,EAAC,MAAM,CAAC;QAAA,SAAS,EAAC,MAAM,CAAC;QAAA,KAAK,EAAC,oBAAoB,CAAA;KAAC,GAAE,OAAO,CAAC;QAAC,GAAG,EAAC,MAAM,CAAC;QAAA,OAAO,CAAC,EAAC,MAAM,CAAC,MAAM,EAAC,MAAM,CAAC,CAAA;KAAC,CAAC,CAAC;IACxJ,4GAA4G;IAC5G,OAAO,CAAC,KAAK,EAAC;QAAC,OAAO,EAAC,MAAM,CAAC;QAAA,QAAQ,EAAC,MAAM,CAAA;KAAC,GAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/D;AAgBD,uGAAuG;AACvG,wBAAgB,kCAAkC,CAAC,OAAO,EAAC;IAC1D,MAAM,EAAC,sBAAsB,CAAC;IAC9B,YAAY,EAAC,CAAC,OAAO,EAAC,OAAO,KAAG,OAAO,CAAC,MAAM,GAAC,IAAI,CAAC,CAAC;IACrD,SAAS,EAAC,CAAC,KAAK,EAAC;QAAC,OAAO,EAAC,MAAM,CAAC;QAAA,SAAS,EAAC,MAAM,CAAC;QAAA,cAAc,CAAC,EAAC,MAAM,CAAC;QAAA,QAAQ,CAAC,EAAC,MAAM,CAAC;QAAA,OAAO,EAAC,OAAO,CAAA;KAAC,KAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9H,OAAO,EAAC,uBAAuB,CAAC;CAChC,IACa,SAAQ,OAAO,uBA0C5B"}

package/dist/messaging-media.js

@@ -0,0 +1,110 @@
+import { RobonoError } from './errors.js';
+function object(value) { if (!value || typeof value !== 'object' || Array.isArray(value))
+    throw new RobonoError('Invalid media request.', { status: 422, code: 'invalid_media_request' }); return value; }
+function id(value) { if (typeof value !== 'string' || !value.trim() || value.length > 200 || value.trim() !== value || /[\u0000-\u001f\u007f]/.test(value))
+    throw new RobonoError('Invalid identifier.', { status: 422, code: 'invalid_media_request' }); return value; }
+function policy(settings, kind, media) {
+    const mime = media.mimeType;
+    if (!settings?.enabled || !settings.features?.[kind])
+        throw new RobonoError('This attachment type is unavailable.', { status: 403, code: 'message_kind_disabled' });
+    if (typeof mime !== 'string' || !/^[a-z0-9!#$&^_.+-]+\/[a-z0-9!#$&^_.+-]+$/.test(mime) ||
+        (kind === 'document' ? /^(audio|image|video)\//.test(mime) : !mime.startsWith(kind === 'voice' ? 'audio/' : kind + '/')))
+        throw new RobonoError('The file format is not allowed.', { status: 422, code: 'attachment_format_not_allowed' });
+    const limit = settings.attachments?.[kind];
+    if (kind !== 'voice' && (!limit || !Array.isArray(limit.allowedMimeTypes) || !limit.allowedMimeTypes.includes(mime)))
+        throw new RobonoError('The file format is not allowed.', { status: 422, code: 'attachment_format_not_allowed' });
+    if (!Number.isSafeInteger(media.byteSize) || media.byteSize < 1 || media.byteSize > Math.min(104857600, limit?.maxFileBytes ?? 104857600))
+        throw new RobonoError('The file is too large or empty.', { status: 422, code: 'attachment_size_exceeded' });
+    if (typeof media.fileName !== 'string' || !media.fileName.trim() || media.fileName.length > 240 || /[\u0000-\u001f\u007f]/.test(media.fileName))
+        throw new RobonoError('Invalid file name.', { status: 422, code: 'invalid_media_request' });
+    const max = kind === 'voice' ? settings.voice?.maxDurationSeconds ?? 60 : kind === 'video' ? limit.maxDurationSeconds : null;
+    if (max !== null && (!Number.isSafeInteger(media.durationMs) || media.durationMs < 1 || media.durationMs > max * 1000))
+        throw new RobonoError(`The recording can be up to ${max} seconds.`, { status: 422, code: kind === 'voice' ? 'voice_duration_exceeded' : 'video_duration_exceeded' });
+}
+function planUrl(plan) { const url = new URL(plan.url); if (url.protocol !== 'https:' || url.username || url.password)
+    throw Error('Storage must return a private HTTPS transfer URL.'); return plan; }
+/** Mount on YOUR backend. No native code or storage-provider credentials are supplied by the phone. */
+export function createMessagingMediaBackendAdapter(options) {
+    return async (request) => {
+        const respond = (data, status = 200) => new Response(JSON.stringify(data), { status, headers: { 'content-type': 'application/json', 'cache-control': 'no-store' } });
+        if (request.method !== 'POST')
+            return respond({ error: { code: 'method_not_allowed' } }, 405);
+        try {
+            const actorId = await options.authenticate(request);
+            if (!actorId)
+                return respond({ error: { code: 'authentication_required' } }, 401);
+            const raw = await request.text();
+            if (raw.length > 20000)
+                return respond({ error: { code: 'request_too_large' } }, 413);
+            let input;
+            try {
+                input = object(JSON.parse(raw));
+            }
+            catch {
+                return respond({ error: { code: 'invalid_media_request' } }, 422);
+            }
+            const operation = input.operation;
+            if (!['prepare', 'complete', 'download', 'discard'].includes(operation))
+                return respond({ error: { code: 'operation_not_allowed' } }, 403);
+            const uploadId = operation !== 'download' ? id(input.uploadId) : undefined;
+            const conversationId = operation !== 'discard' ? id(input.conversationId) : undefined;
+            if (!await options.authorize({ actorId, operation, ...(uploadId ? { uploadId } : {}), ...(conversationId ? { conversationId } : {}), request }))
+                return respond({ error: { code: 'operation_not_allowed' } }, 403);
+            if (operation === 'discard') {
+                await options.storage.discard({ actorId, uploadId: uploadId });
+                return respond({ ok: true });
+            }
+            let messageId;
+            if (operation === 'download') {
+                messageId = id(input.messageId);
+                if (!/^\d{1,19}$/.test(messageId) || BigInt(messageId) < 1n || BigInt(messageId) >= 9223372036854775807n)
+                    return respond({ error: { code: 'invalid_media_request' } }, 422);
+                // Managed storage performs the authoritative checks in the same request that
+                // resolves the asset. Custom storage retains the list-before-download path.
+                if (options.storage.authorizeDownload) {
+                    const plan = await options.storage.authorizeDownload({ actorId, conversationId: conversationId, messageId });
+                    id(plan.media.assetId);
+                    return respond(planUrl(plan));
+                }
+            }
+            // Authoritative membership/block checks and the latest policy, before touching storage.
+            const page = await options.robono.request('list', { actorId, conversationId, limit: 1, ...(messageId ? { before: (BigInt(messageId) + 1n).toString() } : {}) });
+            const context = { actorId, uploadId: uploadId, conversationId: conversationId };
+            if (operation === 'prepare') {
+                if (!['voice', 'image', 'video', 'document'].includes(input.kind))
+                    return respond({ error: { code: 'invalid_media_request' } }, 422);
+                const file = object(input.file);
+                policy(page.settings, input.kind, file);
+                const plan = await options.storage.prepare({ ...context, kind: input.kind, file });
+                if ('media' in plan) {
+                    id(plan.media.assetId);
+                    policy(page.settings, input.kind, plan.media);
+                    return respond({ media: plan.media });
+                }
+                return respond(planUrl(plan));
+            }
+            if (operation === 'complete') {
+                const result = await options.storage.complete(context);
+                try {
+                    id(result.media.assetId);
+                    policy(page.settings, result.kind, result.media);
+                }
+                catch (e) {
+                    await options.storage.discard({ actorId, uploadId: uploadId });
+                    throw e;
+                }
+                return respond({ media: result.media });
+            }
+            const message = page.messages?.find((m) => m.id === messageId);
+            if (!message?.media)
+                return respond({ error: { code: 'message_not_found' } }, 404);
+            return respond({ ...planUrl(await options.storage.download({ actorId, conversationId: conversationId, messageId: messageId, media: message.media })), media: message.media });
+        }
+        catch (e) {
+            if (e instanceof RobonoError)
+                return respond({ error: { code: e.code, message: e.message } }, e.status ?? 503);
+            return respond({ error: { code: 'media_unavailable', message: 'Media is temporarily unavailable. Try again.' } }, 503);
+        }
+    };
+}
+//# sourceMappingURL=messaging-media.js.map

package/dist/messaging-media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging-media.js","sourceRoot":"","sources":["../src/messaging-media.ts"],"names":[],"mappings":"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"}

package/dist/messaging-transforms.d.ts

@@ -0,0 +1,18 @@
+import type { RobonoMessagingBackend } from './messaging.js';
+import type { MessagingPrivateStorage } from './messaging-media.js';
+import type { RobonoServer } from './client.js';
+/** On-demand language tools. A client sends only a message ID, never arbitrary source URLs or text. */
+export declare function createMessagingTransformBackendAdapter(options: {
+    robono: RobonoMessagingBackend;
+    speech: Pick<RobonoServer['transforms'], 'speech'>;
+    storage: Pick<MessagingPrivateStorage, 'download'>;
+    authenticate(request: Request): Promise<string | null>;
+    authorize(input: {
+        actorId: string;
+        conversationId: string;
+        messageId: string;
+        operation: 'transcript' | 'translation';
+        request: Request;
+    }): Promise<boolean>;
+}): (request: Request) => Promise<Response>;
+//# sourceMappingURL=messaging-transforms.d.ts.map

package/dist/messaging-transforms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging-transforms.d.ts","sourceRoot":"","sources":["../src/messaging-transforms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAC,uBAAuB,EAAC,MAAM,sBAAsB,CAAC;AAClE,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,aAAa,CAAC;AAG9C,uGAAuG;AACvG,wBAAgB,sCAAsC,CAAC,OAAO,EAAC;IAC9D,MAAM,EAAC,sBAAsB,CAAC;IAAA,MAAM,EAAC,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,EAAC,QAAQ,CAAC,CAAC;IAC/E,OAAO,EAAC,IAAI,CAAC,uBAAuB,EAAC,UAAU,CAAC,CAAC;IACjD,YAAY,CAAC,OAAO,EAAC,OAAO,GAAE,OAAO,CAAC,MAAM,GAAC,IAAI,CAAC,CAAC;IACnD,SAAS,CAAC,KAAK,EAAC;QAAC,OAAO,EAAC,MAAM,CAAC;QAAA,cAAc,EAAC,MAAM,CAAC;QAAA,SAAS,EAAC,MAAM,CAAC;QAAA,SAAS,EAAC,YAAY,GAAC,aAAa,CAAC;QAAA,OAAO,EAAC,OAAO,CAAA;KAAC,GAAE,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/I,IACa,SAAQ,OAAO,uBA6B5B"}

package/dist/messaging-transforms.js

@@ -0,0 +1,58 @@
+import { RobonoError } from './errors.js';
+/** On-demand language tools. A client sends only a message ID, never arbitrary source URLs or text. */
+export function createMessagingTransformBackendAdapter(options) {
+    return async (request) => {
+        const reply = (body, status = 200, headers = {}) => new Response(JSON.stringify(body), { status, headers: { 'content-type': 'application/json', 'cache-control': 'no-store', ...headers } });
+        if (request.method !== 'POST')
+            return reply({ error: { code: 'method_not_allowed' } }, 405);
+        try {
+            const actorId = await options.authenticate(request);
+            if (!actorId)
+                return reply({ error: { code: 'authentication_required' } }, 401);
+            const raw = await request.text();
+            if (raw.length > 2000)
+                return reply({ error: { code: 'request_too_large' } }, 413);
+            let input;
+            try {
+                input = JSON.parse(raw);
+            }
+            catch {
+                return reply({ error: { code: 'invalid_transform' } }, 422);
+            }
+            if (!input || !['transcript', 'translation'].includes(input.operation) || typeof input.conversationId !== 'string' || !/^[0-9a-f-]{36}$/i.test(input.conversationId) || typeof input.messageId !== 'string' || !/^\d{1,19}$/.test(input.messageId) || BigInt(input.messageId) < 1n || BigInt(input.messageId) > 9223372036854775807n || input.operation === 'translation' && (typeof input.language !== 'string' || !/^[a-z]{2,3}(?:-[a-z0-9]{2,8}){0,2}$/i.test(input.language)))
+                return reply({ error: { code: 'invalid_transform' } }, 422);
+            const context = { actorId, conversationId: input.conversationId, messageId: input.messageId, operation: input.operation, request };
+            if (!await options.authorize(context))
+                return reply({ error: { code: 'operation_not_allowed' } }, 403);
+            const read = () => options.robono.request('list', { actorId, conversationId: input.conversationId, limit: 1, messageIds: [input.messageId] });
+            const page = await read(), message = page.messages?.find((m) => m.id === input.messageId), flag = input.operation === 'transcript' ? 'transcription' : 'translation';
+            const permitted = (p) => p.settings?.enabled && p.settings.features?.[flag] === true;
+            if (!permitted(page) || !message || message.deleted || input.operation === 'transcript' && message.kind !== 'voice' || !['voice', 'text'].includes(message.kind))
+                return reply({ error: { code: 'transform_unavailable' } }, 403);
+            const source = message.kind === 'text' ? { type: 'text', text: message.text } : await (async () => {
+                const plan = await options.storage.download({ actorId, conversationId: input.conversationId, messageId: message.id, media: message.media });
+                const url = new URL(plan.url);
+                if (url.protocol !== 'https:' || url.username || url.password || Object.keys(plan.headers ?? {}).length)
+                    throw Error('Provide a short-lived signed HTTPS audio URL for speech processing.');
+                return { type: 'audio', source_url: plan.url, mime_type: message.media.mimeType };
+            })();
+            const language = input.operation === 'translation' ? input.language : undefined;
+            const key = `messaging:${input.conversationId}:${message.id}:${input.operation}:${language ?? 'auto'}`;
+            const result = await options.speech.speech({ external_request_id: key, input: source, outputs: [input.operation === 'transcript' ? 'transcript' : 'translated_text'], ...(language ? { target_language: language } : {}) }, { idempotencyKey: key });
+            // A block, removal or retention change during processing must not reveal text.
+            const current = await read();
+            if (!permitted(current) || !current.messages?.some((m) => m.id === message.id && !m.deleted) || !await options.authorize(context))
+                return reply({ error: { code: 'transform_unavailable' } }, 403);
+            const artifact = input.operation === 'transcript' ? result.artifacts.transcript : result.artifacts.translated_text;
+            if (!artifact || typeof artifact.text !== 'string')
+                throw Error('Speech result unavailable');
+            return reply({ messageId: message.id, text: artifact.text, language: artifact.target_language ?? artifact.language, kind: input.operation });
+        }
+        catch (e) {
+            if (e instanceof RobonoError)
+                return reply({ error: { code: e.code, message: e.message } }, e.status ?? 503, e.retryAfterMs ? { 'retry-after': String(Math.ceil(e.retryAfterMs / 1000)) } : {});
+            return reply({ error: { code: 'transform_unavailable', message: 'This message could not be converted. Try again.' } }, 503);
+        }
+    };
+}
+//# sourceMappingURL=messaging-transforms.js.map

package/dist/messaging-transforms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging-transforms.js","sourceRoot":"","sources":["../src/messaging-transforms.ts"],"names":[],"mappings":"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"}

package/dist/messaging.d.ts

@@ -0,0 +1,83 @@
+import type { MessagingStoredMedia } from "./messaging-media.js";
+export interface MessagingBackendOptions {
+    apiKey: string;
+    baseUrl?: string;
+    fetch?: typeof fetch;
+}
+export interface UnansweredCallRecord {
+    callId: string;
+    conversationId: string;
+    callerId: string;
+    kind: 'voice' | 'video';
+    state: 'ended';
+    reason: string;
+    answeredAt: number | null;
+    connectedAt: number | null;
+    permissions: {
+        voiceCalling: boolean;
+        videoCalling: boolean;
+        voiceMessages: boolean;
+        videoMessages: boolean;
+    };
+}
+/** Server-only messaging API. User identity must come from your authenticated session. */
+export declare class RobonoMessagingBackend {
+    private options;
+    private url;
+    constructor(options: MessagingBackendOptions);
+    request(operation: string, input?: Record<string, unknown>): Promise<any>;
+    setRelationship(input: {
+        externalUserIds: [string, string];
+        allowed: boolean;
+        revision: number;
+    }): Promise<any>;
+    /** Synchronize a complete group membership snapshot from your authenticated backend. */
+    setGroup(input: {
+        externalGroupId: string;
+        name: string;
+        revision: number;
+        allowed: boolean;
+        members: {
+            userId: string;
+            canSend: boolean;
+            features?: Partial<Record<'text' | 'voice' | 'image' | 'video' | 'document' | 'poll' | 'reactions', boolean>>;
+        }[];
+    }): Promise<any>;
+    /** Server-only moderation API. Never expose these operations through the end-user adapter. */
+    restoreUser(userId: string): Promise<any>;
+    reports(status?: 'open' | 'resolved'): Promise<any>;
+    resolveReport(input: {
+        reportId: string;
+        resolution: 'no_action' | 'remove_content' | 'suspend_user';
+        reason: string;
+        reviewerId: string;
+    }): Promise<any>;
+    settings(): Promise<any>;
+    /** Erases this user's hosted conversations. Delete the corresponding private media in your own store too. */
+    eraseUser(userId: string): Promise<any>;
+}
+/** Mount behind your app's authentication. Keys and relationship management stay on the backend. */
+export declare function createMessagingBackendAdapter(options: {
+    robono: RobonoMessagingBackend;
+    authenticate: (request: Request) => Promise<string | null>;
+    /** Resolve verified metadata from YOUR private store; never trust a phone's size/type/duration. */
+    resolveMedia?: (input: {
+        actorId: string;
+        conversationId: string;
+        assetId: string;
+    }) => Promise<MessagingStoredMedia | null>;
+    /** Read finalized calling records and CURRENT permissions on your server. Never return client-supplied claims. */
+    resolveUnansweredCall?: (input: {
+        actorId: string;
+        conversationId: string;
+        callId: string;
+    }) => Promise<UnansweredCallRecord | null>;
+    /** Check conversation membership, blocks and ownership of any media asset before approving. Verify voice duration against the actual stored recording, not client-supplied metadata. */
+    authorize: (input: {
+        actorId: string;
+        operation: string;
+        input: Record<string, unknown>;
+        request: Request;
+    }) => Promise<boolean>;
+}): (request: Request) => Promise<Response>;
+//# sourceMappingURL=messaging.d.ts.map

package/dist/messaging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging.d.ts","sourceRoot":"","sources":["../src/messaging.ts"],"names":[],"mappings":"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"}

package/dist/messaging.js

@@ -0,0 +1,142 @@
+import { RobonoError } from "./errors.js";
+/** Server-only messaging API. User identity must come from your authenticated session. */
+export class RobonoMessagingBackend {
+    options;
+    url;
+    constructor(options) {
+        this.options = options;
+        const url = new URL(options.baseUrl ?? "https://api.robono.com/v1/messaging");
+        if (url.protocol !== "https:" || url.username || url.password ||
+            !options.apiKey.trim())
+            throw Error("Use an HTTPS endpoint and a server API key.");
+        this.url = url.href;
+    }
+    async request(operation, input = {}) {
+        const result = await (this.options.fetch ?? fetch)(this.url, {
+            method: "POST",
+            redirect: "error",
+            signal: AbortSignal.timeout(15000),
+            headers: {
+                authorization: `Bearer ${this.options.apiKey}`,
+                "content-type": "application/json",
+            },
+            body: JSON.stringify({ ...input, operation }),
+        });
+        const data = await result.json().catch(() => null);
+        if (!result.ok) {
+            const retry = result.headers.get("retry-after");
+            const ms = retry === null
+                ? 0
+                : /^\d+(\.\d+)?$/.test(retry)
+                    ? Number(retry) * 1000
+                    : Math.max(0, Date.parse(retry) - Date.now());
+            throw new RobonoError(data?.error?.message ?? "Messaging request failed.", {
+                status: result.status,
+                code: data?.error?.code ?? "messaging_request_failed",
+                retryable: result.status === 429 || result.status >= 500,
+                ...(Number.isFinite(ms) ? { retryAfterMs: ms } : {}),
+            });
+        }
+        return data;
+    }
+    setRelationship(input) {
+        return this.request("relationship", input);
+    }
+    /** Synchronize a complete group membership snapshot from your authenticated backend. */
+    setGroup(input) {
+        return this.request('group', input);
+    }
+    /** Server-only moderation API. Never expose these operations through the end-user adapter. */
+    restoreUser(userId) { return this.request('restore-user', { userId }); }
+    reports(status) { return this.request('report-list', status ? { status } : {}); }
+    resolveReport(input) { return this.request('report-resolve', input); }
+    settings() {
+        return this.request("settings");
+    }
+    /** Erases this user's hosted conversations. Delete the corresponding private media in your own store too. */
+    eraseUser(userId) {
+        return this.request("erase-user", { userId });
+    }
+}
+/** Mount behind your app's authentication. Keys and relationship management stay on the backend. */
+export function createMessagingBackendAdapter(options) {
+    return async (request) => {
+        const respond = (data, status = 200, headers = {}) => new Response(JSON.stringify(data), {
+            status,
+            headers: {
+                "content-type": "application/json",
+                "cache-control": "no-store",
+                ...headers,
+            },
+        });
+        if (request.method !== "POST") {
+            return respond({ error: { code: "method_not_allowed" } }, 405);
+        }
+        try {
+            const actorId = await options.authenticate(request);
+            if (!actorId) {
+                return respond({ error: { code: "authentication_required" } }, 401);
+            }
+            const raw = await request.text();
+            if (raw.length > 20000) {
+                return respond({ error: { code: "request_too_large" } }, 413);
+            }
+            let body;
+            try {
+                body = JSON.parse(raw);
+                if (!body || typeof body !== "object" || Array.isArray(body)) {
+                    throw Error();
+                }
+            }
+            catch {
+                return respond({ error: { code: "invalid_request" } }, 422);
+            }
+            const operation = String(body.operation ?? "");
+            if (!["settings", "send", "send-call-message", "call-message-options", "list", "read", "react", "vote", "close-poll", "inventory", "safety", "block", "unblock", "report"].includes(operation))
+                return respond({ error: { code: "operation_not_allowed" } }, 403);
+            const input = { ...body, actorId };
+            delete input.operation;
+            if (!await options.authorize({ actorId, operation, input, request })) {
+                return respond({ error: { code: "operation_not_allowed" } }, 403);
+            }
+            const callMessage = operation === 'send-call-message' || operation === 'call-message-options';
+            if (callMessage) {
+                const callId = operation === 'send-call-message' ? input.unansweredCallId : input.callId;
+                if (typeof callId !== 'string' || !callId || callId.length > 200 || typeof input.conversationId !== 'string' || !options.resolveUnansweredCall)
+                    return respond({ error: { code: 'call_message_unavailable' } }, 403);
+                const call = await options.resolveUnansweredCall({ actorId, conversationId: input.conversationId, callId });
+                const saved = await options.robono.settings(), s = saved.settings;
+                const kind = call && s?.unansweredCalls?.[call.kind], p = call?.permissions;
+                const allowed = call && p && call.callId === callId && call.conversationId === input.conversationId && call.callerId === actorId && call.state === 'ended' && call.reason === 'no_answer' && call.answeredAt === null && call.connectedAt === null &&
+                    s?.enabled === true && (call.kind === 'voice' ? p.voiceCalling === true : call.kind === 'video' && p.videoCalling === true) &&
+                    (kind === 'voice' ? s.features?.voice === true && p.voiceMessages === true : kind === 'video' && call.kind === 'video' && s.features?.video === true && p.videoMessages === true);
+                if (!allowed)
+                    return operation === 'call-message-options' ? respond({ option: null }) : respond({ error: { code: 'call_message_unavailable' } }, 403);
+                const seconds = kind === 'voice' ? s.voice?.maxDurationSeconds ?? 60 : s.attachments?.video?.maxDurationSeconds ?? 3600;
+                if (operation === 'call-message-options')
+                    return respond({ option: { kind, maxDurationMs: seconds * 1000 } });
+                if (input.kind !== kind || !options.resolveMedia)
+                    return respond({ error: { code: 'call_message_unavailable' } }, 403);
+            }
+            delete input.unansweredCallId;
+            if ((operation === "send" || operation === 'send-call-message') && input.kind !== "text" && input.kind !== "poll" && options.resolveMedia) {
+                const candidate = input.media;
+                if (typeof candidate?.assetId !== "string" || typeof input.conversationId !== "string")
+                    return respond({ error: { code: "invalid_media_request" } }, 422);
+                const stored = await options.resolveMedia({ actorId, conversationId: input.conversationId, assetId: candidate.assetId });
+                if (!stored || stored.assetId !== candidate.assetId)
+                    return respond({ error: { code: "attachment_unavailable" } }, 403);
+                input.media = stored;
+            }
+            return respond(await options.robono.request(operation === 'send-call-message' ? 'send' : operation, input));
+        }
+        catch (e) {
+            if (e instanceof RobonoError) {
+                const retry = e.retryAfterMs;
+                return respond({ error: { code: e.code, message: e.message } }, e.status ?? 503, retry ? { "retry-after": String(Math.ceil(retry / 1000)) } : {});
+            }
+            return respond({ error: { code: "messaging_temporarily_unavailable" } }, 503);
+        }
+    };
+}
+//# sourceMappingURL=messaging.js.map

package/dist/messaging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging.js","sourceRoot":"","sources":["../src/messaging.ts"],"names":[],"mappings":"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"}

package/dist/push.d.ts

@@ -1,4 +1,4 @@
-import type { RobonoClientPushPayload, RobonoWebhookEvent } from "./types.js";
+import type { RobonoClientPushPayload, CallingWebhookEvent, CallingPushPayload, RobonoWebhookEvent } from "./types.js";
 /**
  * Converts a verified Robono webhook into the provider-neutral data expected
  * by @robono/react-native and @robono/web.
@@ -9,4 +9,6 @@ import type { RobonoClientPushPayload, RobonoWebhookEvent } from "./types.js";
  * state through the child-app adapter.
  */
 export declare function toClientPushPayload(event: RobonoWebhookEvent): RobonoClientPushPayload;
+/** Route only to the recipient's devices. The calling client rechecks live state. */
+export declare function toCallingPushPayload(event: CallingWebhookEvent): CallingPushPayload;
 //# sourceMappingURL=push.d.ts.map

package/dist/push.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../src/push.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EAEvB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAGpB;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,kBAAkB,GACxB,uBAAuB,CAsEzB"}
+{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../src/push.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAElB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAGpB;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,kBAAkB,GACxB,uBAAuB,CA0FzB;AAED,qFAAqF;AACrF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,mBAAmB,GAAG,kBAAkB,CAInF"}

package/dist/push.js

@@ -11,6 +11,13 @@ import { RobonoWebhookError } from "./errors.js";
 export function toClientPushPayload(event) {
     const event_id = event.event_id;
     switch (event.event) {
+        case "calling.group_incoming":
+        case "calling.group_dismissed":
+        case "calling.group_incoming":
+        case "calling.group_dismissed":
+        case "calling.incoming":
+        case "calling.dismissed":
+            throw new RobonoWebhookError("Use toCallingPushPayload for calling notifications.", "unsupported_client_push_event");
         case "connection.status_changed":
         case "connection.profile_updated":
             return { event: event.event, event_id, connection_id: event.connection_id };
@@ -76,6 +83,19 @@ export function toClientPushPayload(event) {
         case "data.deletion_failed":
         case "data.deletion_rejected":
             throw new RobonoWebhookError("Data-rights webhooks are server events and must not be forwarded as client push payloads.", "unsupported_client_push_event");
+        case "pricing.updated":
+            throw new RobonoWebhookError("Pricing webhooks are server events and must not be forwarded as client push payloads.", "unsupported_client_push_event");
+        case "messaging.report_created":
+            throw new RobonoWebhookError("Reports are moderator-only server events and must not be forwarded as client notifications.", "unsupported_client_push_event");
+        case "messaging.message_removed":
+        case "messaging.message_created":
+            throw new RobonoWebhookError("Use the messaging conversation and message IDs to route this event through your own messaging notification handler.", "unsupported_client_push_event");
     }
 }
+/** Route only to the recipient's devices. The calling client rechecks live state. */
+export function toCallingPushPayload(event) {
+    return { event: event.event, event_id: event.event_id, call_id: event.call.id,
+        ...(event.call.kind ? { kind: event.call.kind } : {}), connection_id: event.call.connection_id, ring_expires_at: event.call.ring_expires_at,
+        sequence: event.call.sequence };
+}
 //# sourceMappingURL=push.js.map