@relaymessenger/chat-sdk-adapter 0.2.0 → 0.3.0-staging.0

package/dist/client.d.ts

@@ -0,0 +1,64 @@
+import { AdapterError } from "@chat-adapter/shared";
+import type { RelayCredential } from "./credentials.js";
+import type { RelayAttachmentAllocation, RelayChat, RelayGetMessagesResult, RelayMessage, RelayOutgoingPart, RelayReactionType, RelaySendMessageResponse } from "./types.js";
+export declare const RELAY_DEFAULT_BASE_URL = "https://api.relayapp.im";
+export interface RelayClientOptions {
+    /** Relay Agent Token or a resolver evaluated for every Relay API call. */
+    token?: RelayCredential;
+    baseUrl?: string;
+    fetch?: typeof fetch;
+}
+export interface RelayUploadOptions {
+    body: Uint8Array<ArrayBuffer>;
+    contentType: string;
+    durationMs?: number;
+    filename: string;
+    height?: number;
+    width?: number;
+}
+export declare class RelayApiError extends AdapterError {
+    readonly status: number;
+    readonly relayCode: string;
+    readonly responseBody?: unknown;
+    constructor(status: number, relayCode: string, message: string, responseBody?: unknown);
+}
+/**
+ * Minimal client for only the locked Relay v1 operations used by the adapter.
+ */
+export declare class RelayClient {
+    readonly baseUrl: string;
+    private readonly fetchImpl;
+    private readonly token;
+    constructor(options?: RelayClientOptions);
+    private request;
+    sendMessage(options: {
+        chatId: string;
+        idempotencyKey: string;
+        parts: RelayOutgoingPart[];
+        replyTo?: {
+            messageId: string;
+            partIndex?: number;
+        };
+    }): Promise<RelaySendMessageResponse>;
+    react(options: {
+        customEmoji?: string;
+        messageId: string;
+        operation: "add" | "remove";
+        partIndex?: number;
+        type: RelayReactionType;
+    }): Promise<void>;
+    setTyping(chatId: string, active: boolean): Promise<void>;
+    markChatRead(chatId: string): Promise<void>;
+    getChat(chatId: string): Promise<RelayChat>;
+    getMessages(options: {
+        chatId: string;
+        cursor?: string;
+        limit?: number;
+    }): Promise<RelayGetMessagesResult>;
+    getMessage(messageId: string): Promise<RelayMessage>;
+    allocateAttachment(options: Omit<RelayUploadOptions, "body"> & {
+        sizeBytes: number;
+    }): Promise<RelayAttachmentAllocation>;
+    uploadAttachment(options: RelayUploadOptions): Promise<RelayAttachmentAllocation>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,230 @@
+import { AdapterError, NetworkError, ValidationError, } from "@chat-adapter/shared";
+import { resolveRelayCredential, validateStaticCredential, } from "./credentials.js";
+import { assertRelayUuid } from "./thread-id.js";
+export const RELAY_DEFAULT_BASE_URL = "https://api.relayapp.im";
+export class RelayApiError extends AdapterError {
+    status;
+    relayCode;
+    responseBody;
+    constructor(status, relayCode, message, responseBody) {
+        super(message, "relay", relayCode);
+        this.status = status;
+        this.relayCode = relayCode;
+        this.responseBody = responseBody;
+        this.name = "RelayApiError";
+    }
+}
+function trimTrailingSlash(value) {
+    return value.replace(/\/+$/, "");
+}
+async function parseResponseBody(response) {
+    const text = await response.text();
+    if (!text)
+        return undefined;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+function errorDetails(body, status) {
+    if (typeof body === "object" && body !== null) {
+        const record = body;
+        const error = typeof record.error === "object" && record.error !== null
+            ? record.error
+            : record;
+        const code = typeof error.code === "string"
+            ? error.code
+            : `http_${status}`;
+        const message = typeof error.message === "string"
+            ? error.message
+            : `Relay API request failed with HTTP ${status}`;
+        return { code, message };
+    }
+    return {
+        code: `http_${status}`,
+        message: typeof body === "string" && body
+            ? body
+            : `Relay API request failed with HTTP ${status}`,
+    };
+}
+/**
+ * Minimal client for only the locked Relay v1 operations used by the adapter.
+ */
+export class RelayClient {
+    baseUrl;
+    fetchImpl;
+    token;
+    constructor(options = {}) {
+        validateStaticCredential(options.token, "Relay Agent Token");
+        this.token = options.token;
+        this.baseUrl = trimTrailingSlash(options.baseUrl ?? RELAY_DEFAULT_BASE_URL);
+        const parsed = new URL(this.baseUrl);
+        if (parsed.protocol !== "https:" && parsed.hostname !== "localhost") {
+            throw new ValidationError("relay", "Relay baseUrl must use HTTPS (localhost is allowed for tests)");
+        }
+        const selected = options.fetch ?? globalThis.fetch;
+        if (!selected) {
+            throw new ValidationError("relay", "A Web Fetch API implementation is required");
+        }
+        // workerd's host fetch requires its global receiver.
+        this.fetchImpl = selected.bind(globalThis);
+    }
+    async request(path, init) {
+        const token = await resolveRelayCredential(this.token, "Relay Agent Token");
+        let response;
+        try {
+            response = await this.fetchImpl(`${this.baseUrl}${path}`, {
+                ...init,
+                headers: {
+                    Authorization: `Bearer ${token}`,
+                    ...Object.fromEntries(new Headers(init.headers).entries()),
+                },
+            });
+        }
+        catch (error) {
+            throw new NetworkError("relay", "Network error calling the Relay API", error instanceof Error ? error : undefined);
+        }
+        const body = await parseResponseBody(response);
+        if (!response.ok) {
+            const details = errorDetails(body, response.status);
+            throw new RelayApiError(response.status, details.code, details.message, body);
+        }
+        return body;
+    }
+    async sendMessage(options) {
+        assertRelayUuid(options.chatId, "chatId");
+        if (options.parts.length < 1 || options.parts.length > 100) {
+            throw new ValidationError("relay", "A Relay message requires 1–100 parts");
+        }
+        if (options.idempotencyKey.length < 1 ||
+            options.idempotencyKey.length > 255) {
+            throw new ValidationError("relay", "Relay idempotency keys must contain 1–255 characters");
+        }
+        if (options.replyTo) {
+            assertRelayUuid(options.replyTo.messageId, "reply message ID");
+        }
+        return this.request(`/v1/chats/${encodeURIComponent(options.chatId)}/messages`, {
+            body: JSON.stringify({
+                message: {
+                    parts: options.parts,
+                    ...(options.replyTo
+                        ? {
+                            reply_to: {
+                                message_id: options.replyTo.messageId,
+                                ...(options.replyTo.partIndex !== undefined
+                                    ? { part_index: options.replyTo.partIndex }
+                                    : {}),
+                            },
+                        }
+                        : {}),
+                },
+            }),
+            headers: {
+                "Content-Type": "application/json",
+                "Idempotency-Key": options.idempotencyKey,
+            },
+            method: "POST",
+        });
+    }
+    async react(options) {
+        assertRelayUuid(options.messageId, "messageId");
+        await this.request(`/v1/messages/${encodeURIComponent(options.messageId)}/reactions`, {
+            body: JSON.stringify({
+                operation: options.operation,
+                type: options.type,
+                ...(options.customEmoji
+                    ? { custom_emoji: options.customEmoji }
+                    : {}),
+                ...(options.partIndex !== undefined
+                    ? { part_index: options.partIndex }
+                    : {}),
+            }),
+            headers: { "Content-Type": "application/json" },
+            method: "POST",
+        });
+    }
+    async setTyping(chatId, active) {
+        assertRelayUuid(chatId, "chatId");
+        await this.request(`/v1/chats/${encodeURIComponent(chatId)}/typing`, { method: active ? "POST" : "DELETE" });
+    }
+    async markChatRead(chatId) {
+        assertRelayUuid(chatId, "chatId");
+        await this.request(`/v1/chats/${encodeURIComponent(chatId)}/read`, { method: "POST" });
+    }
+    async getChat(chatId) {
+        assertRelayUuid(chatId, "chatId");
+        return this.request(`/v1/chats/${encodeURIComponent(chatId)}`, { method: "GET" });
+    }
+    async getMessages(options) {
+        assertRelayUuid(options.chatId, "chatId");
+        const query = new URLSearchParams();
+        if (options.cursor)
+            query.set("cursor", options.cursor);
+        if (options.limit !== undefined) {
+            const limit = Math.trunc(options.limit);
+            if (limit < 1 || limit > 100) {
+                throw new ValidationError("relay", "Relay message history limit must be between 1 and 100");
+            }
+            query.set("limit", String(limit));
+        }
+        const suffix = query.size ? `?${query.toString()}` : "";
+        return this.request(`/v1/chats/${encodeURIComponent(options.chatId)}/messages${suffix}`, { method: "GET" });
+    }
+    async getMessage(messageId) {
+        assertRelayUuid(messageId, "messageId");
+        return this.request(`/v1/messages/${encodeURIComponent(messageId)}`, { method: "GET" });
+    }
+    async allocateAttachment(options) {
+        return this.request("/v1/attachments", {
+            body: JSON.stringify({
+                filename: options.filename,
+                content_type: options.contentType,
+                size_bytes: options.sizeBytes,
+                ...(options.durationMs !== undefined
+                    ? { duration_ms: options.durationMs }
+                    : {}),
+                ...(options.width !== undefined &&
+                    options.height !== undefined
+                    ? { width: options.width, height: options.height }
+                    : {}),
+            }),
+            headers: { "Content-Type": "application/json" },
+            method: "POST",
+        });
+    }
+    async uploadAttachment(options) {
+        if (options.body.byteLength < 1 || options.body.byteLength > 104_857_600) {
+            throw new ValidationError("relay", "Relay attachments must contain 1–104857600 bytes");
+        }
+        const allocation = await this.allocateAttachment({
+            contentType: options.contentType,
+            ...(options.durationMs !== undefined
+                ? { durationMs: options.durationMs }
+                : {}),
+            filename: options.filename,
+            ...(options.height !== undefined ? { height: options.height } : {}),
+            sizeBytes: options.body.byteLength,
+            ...(options.width !== undefined ? { width: options.width } : {}),
+        });
+        let response;
+        try {
+            response = await this.fetchImpl(allocation.upload_url, {
+                body: options.body,
+                headers: allocation.required_headers,
+                method: allocation.http_method,
+            });
+        }
+        catch (error) {
+            throw new NetworkError("relay", "Network error uploading bytes to Relay attachment storage", error instanceof Error ? error : undefined);
+        }
+        if (!response.ok) {
+            const body = await parseResponseBody(response);
+            const details = errorDetails(body, response.status);
+            throw new RelayApiError(response.status, details.code, details.message, body);
+        }
+        return allocation;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/content.d.ts

@@ -0,0 +1,11 @@
+import { type AdapterPostableMessage } from "chat";
+import type { RelayOutgoingPart } from "./types.js";
+export declare const RELAY_MAX_TEXT_PART_LENGTH = 10000;
+export declare const RELAY_MAX_MESSAGE_PARTS = 100;
+export declare const RELAY_MAX_ATTACHMENT_BYTES = 104857600;
+export declare function contentTypeFor(filename: string, declared?: string): string;
+export declare function postableText(message: AdapterPostableMessage): string;
+export declare function hasPostableContent(message: AdapterPostableMessage): boolean;
+export declare function textParts(value: string): RelayOutgoingPart[];
+export declare function buildRelayParts(message: AdapterPostableMessage): Promise<RelayOutgoingPart[]>;
+//# sourceMappingURL=content.d.ts.map

package/dist/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../src/content.ts"],"names":[],"mappings":"AAOA,OAAO,EAGL,KAAK,sBAAsB,EAE5B,MAAM,MAAM,CAAC;AACd,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,eAAO,MAAM,0BAA0B,QAAS,CAAC;AACjD,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,0BAA0B,YAAc,CAAC;AAkGtD,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAcR;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,CA0BpE;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAMT;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAmB5D;AAiBD,wBAAsB,eAAe,CACnC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAoB9B"}

package/dist/content.js

@@ -0,0 +1,172 @@
+import { cardToFallbackText, extractCard, extractFiles, extractPostableAttachments, ValidationError, } from "@chat-adapter/shared";
+import { markdownToPlainText, toPlainText, } from "chat";
+export const RELAY_MAX_TEXT_PART_LENGTH = 10_000;
+export const RELAY_MAX_MESSAGE_PARTS = 100;
+export const RELAY_MAX_ATTACHMENT_BYTES = 104_857_600;
+const SUPPORTED_CONTENT_TYPES = new Set([
+    "image/jpeg",
+    "image/png",
+    "image/gif",
+    "image/heic",
+    "image/heif",
+    "image/tiff",
+    "image/bmp",
+    "image/webp",
+    "image/x-icon",
+    "video/mp4",
+    "video/quicktime",
+    "video/mpeg",
+    "video/mpeg2",
+    "video/x-m4v",
+    "video/x-msvideo",
+    "video/3gpp",
+    "audio/mpeg",
+    "audio/mp3",
+    "audio/x-m4a",
+    "audio/mp4",
+    "audio/x-caf",
+    "audio/x-wav",
+    "audio/x-aiff",
+    "audio/aiff",
+    "audio/aac",
+    "audio/midi",
+    "audio/amr",
+    "application/pdf",
+    "application/vnd.apple.pkpass",
+    "text/plain",
+    "text/markdown",
+    "text/vcard",
+    "text/rtf",
+    "text/csv",
+    "text/html",
+    "text/calendar",
+    "application/msword",
+    "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+    "application/vnd.ms-excel",
+    "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    "application/vnd.ms-powerpoint",
+    "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+    "application/x-iwork-pages-sffpages",
+    "application/x-iwork-numbers-sffnumbers",
+    "application/x-iwork-keynote-sffkey",
+    "application/epub+zip",
+    "text/xml",
+    "application/json",
+    "application/zip",
+    "application/x-gzip",
+]);
+const MIME_BY_EXTENSION = {
+    aac: "audio/aac",
+    aiff: "audio/aiff",
+    avi: "video/x-msvideo",
+    bmp: "image/bmp",
+    csv: "text/csv",
+    doc: "application/msword",
+    docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+    epub: "application/epub+zip",
+    gif: "image/gif",
+    gz: "application/x-gzip",
+    heic: "image/heic",
+    heif: "image/heif",
+    html: "text/html",
+    ico: "image/x-icon",
+    jpeg: "image/jpeg",
+    jpg: "image/jpeg",
+    json: "application/json",
+    m4a: "audio/x-m4a",
+    md: "text/markdown",
+    midi: "audio/midi",
+    mov: "video/quicktime",
+    mp3: "audio/mpeg",
+    mp4: "video/mp4",
+    pdf: "application/pdf",
+    png: "image/png",
+    ppt: "application/vnd.ms-powerpoint",
+    pptx: "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+    rtf: "text/rtf",
+    tif: "image/tiff",
+    tiff: "image/tiff",
+    txt: "text/plain",
+    vcf: "text/vcard",
+    webp: "image/webp",
+    xls: "application/vnd.ms-excel",
+    xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    xml: "text/xml",
+    zip: "application/zip",
+};
+export function contentTypeFor(filename, declared) {
+    const normalized = declared?.split(";", 1)[0]?.trim().toLowerCase();
+    const extension = filename.split(".").at(-1)?.toLowerCase();
+    const contentType = normalized || (extension ? MIME_BY_EXTENSION[extension] : undefined);
+    if (!contentType || !SUPPORTED_CONTENT_TYPES.has(contentType)) {
+        throw new ValidationError("relay", `Relay does not accept the content type for ${JSON.stringify(filename)}; pass one of the content types in the v1 SupportedContentType contract`);
+    }
+    return contentType;
+}
+export function postableText(message) {
+    if (typeof message === "string")
+        return message;
+    const card = extractCard(message);
+    if (card) {
+        const explicit = "fallbackText" in message ? message.fallbackText : undefined;
+        const rendered = explicit?.trim()
+            ? explicit
+            : cardToFallbackText(card, { lineBreak: "\n\n" });
+        if (!rendered.trim()) {
+            throw new ValidationError("relay", "Relay has no interactive card surface; provide fallbackText");
+        }
+        return markdownToPlainText(rendered);
+    }
+    if ("raw" in message)
+        return message.raw;
+    if ("markdown" in message) {
+        return markdownToPlainText(message.markdown);
+    }
+    if ("ast" in message)
+        return toPlainText(message.ast);
+    throw new ValidationError("relay", "Unsupported Chat SDK postable message shape");
+}
+export function hasPostableContent(message) {
+    return (postableText(message).length > 0 ||
+        extractPostableAttachments(message).length > 0 ||
+        extractFiles(message).length > 0);
+}
+export function textParts(value) {
+    if (!value)
+        return [];
+    const result = [];
+    let offset = 0;
+    while (offset < value.length) {
+        let end = Math.min(offset + RELAY_MAX_TEXT_PART_LENGTH, value.length);
+        if (end < value.length &&
+            /[\uD800-\uDBFF]/.test(value.charAt(end - 1))) {
+            end -= 1;
+        }
+        result.push({ type: "text", value: value.slice(offset, end) });
+        offset = end;
+    }
+    return result;
+}
+async function attachmentPart(attachment) {
+    if (attachment.url?.startsWith("https://")) {
+        return { type: "media", url: attachment.url };
+    }
+    throw new ValidationError("relay", `Attachment ${JSON.stringify(attachment.name ?? "(unnamed)")} needs a public HTTPS URL. Allocate and upload retryable bytes with `
+        + "@relaymessenger/sdk before posting through Chat SDK.");
+}
+export async function buildRelayParts(message) {
+    const parts = textParts(postableText(message));
+    for (const attachment of extractPostableAttachments(message)) {
+        parts.push(await attachmentPart(attachment));
+    }
+    for (const file of extractFiles(message)) {
+        throw new ValidationError("relay", `File ${JSON.stringify(file.filename)} needs a public HTTPS URL. `
+            + "Allocate and upload retryable bytes with @relaymessenger/sdk before "
+            + "posting through Chat SDK.");
+    }
+    if (parts.length > RELAY_MAX_MESSAGE_PARTS) {
+        throw new ValidationError("relay", `A Relay message supports at most ${RELAY_MAX_MESSAGE_PARTS} parts`);
+    }
+    return parts;
+}
+//# sourceMappingURL=content.js.map

package/dist/content.js.map

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

package/dist/credentials.d.ts

@@ -0,0 +1,13 @@
+export type RelayCredentialResolver = () => string | Promise<string>;
+/**
+ * Vendor-official credential shape required by Vercel Chat SDK.
+ *
+ * Resolver functions are intentionally invoked at the point of use, not at
+ * construction, so Vercel Connect and other short-lived credential providers
+ * can rotate values.
+ */
+export type RelayCredential = string | RelayCredentialResolver;
+export declare function relayEnv(name: string): string | undefined;
+export declare function resolveRelayCredential(credential: RelayCredential | undefined, label: string): Promise<string>;
+export declare function validateStaticCredential(credential: RelayCredential | undefined, label: string): void;
+//# sourceMappingURL=credentials.d.ts.map

package/dist/credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../src/credentials.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,uBAAuB,GAAG,MAClC,MAAM,GACN,OAAO,CAAC,MAAM,CAAC,CAAC;AAEpB;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,uBAAuB,CAAC;AAE/D,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGzD;AAED,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,eAAe,GAAG,SAAS,EACvC,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CAsBjB;AAED,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,eAAe,GAAG,SAAS,EACvC,KAAK,EAAE,MAAM,GACZ,IAAI,CAIN"}

package/dist/credentials.js

@@ -0,0 +1,28 @@
+import { AuthenticationError, ValidationError, } from "@chat-adapter/shared";
+export function relayEnv(name) {
+    if (typeof process === "undefined")
+        return undefined;
+    return process.env[name];
+}
+export async function resolveRelayCredential(credential, label) {
+    let value;
+    try {
+        value =
+            typeof credential === "function"
+                ? await credential()
+                : credential;
+    }
+    catch (error) {
+        throw new AuthenticationError("relay", `${label} resolver failed${error instanceof Error ? `: ${error.message}` : ""}`);
+    }
+    if (!value?.trim()) {
+        throw new AuthenticationError("relay", `${label} is required and its resolver must return a non-empty string`);
+    }
+    return value;
+}
+export function validateStaticCredential(credential, label) {
+    if (typeof credential === "string" && !credential.trim()) {
+        throw new ValidationError("relay", `${label} must not be empty`);
+    }
+}
+//# sourceMappingURL=credentials.js.map

package/dist/credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../src/credentials.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAe9B,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,IAAI,OAAO,OAAO,KAAK,WAAW;QAAE,OAAO,SAAS,CAAC;IACrD,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,UAAuC,EACvC,KAAa;IAEb,IAAI,KAAyB,CAAC;IAC9B,IAAI,CAAC;QACH,KAAK;YACH,OAAO,UAAU,KAAK,UAAU;gBAC9B,CAAC,CAAC,MAAM,UAAU,EAAE;gBACpB,CAAC,CAAC,UAAU,CAAC;IACnB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,mBAAmB,CAC3B,OAAO,EACP,GAAG,KAAK,mBACN,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAClD,EAAE,CACH,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC;QACnB,MAAM,IAAI,mBAAmB,CAC3B,OAAO,EACP,GAAG,KAAK,8DAA8D,CACvE,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,UAAuC,EACvC,KAAa;IAEb,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC;QACzD,MAAM,IAAI,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,oBAAoB,CAAC,CAAC;IACnE,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export { createRelayAdapter, RELAY_ADAPTER_NAME, RelayAdapter, } from "./adapter.js";
+export type { RelayAdapterOptions } from "./adapter.js";
+export type { RelayIdempotencyKeyContext, RelayIdempotencyKeyResolver, } from "./adapter.js";
+export { RELAY_DEFAULT_BASE_URL, RelayApiError, RelayClient, } from "./client.js";
+export type { RelayClientOptions, RelayUploadOptions, } from "./client.js";
+export { relayEnv, resolveRelayCredential, validateStaticCredential, } from "./credentials.js";
+export type { RelayCredential, RelayCredentialResolver, } from "./credentials.js";
+export { RELAY_MAX_ATTACHMENT_BYTES, RELAY_MAX_MESSAGE_PARTS, RELAY_MAX_TEXT_PART_LENGTH, } from "./content.js";
+export { fromRelayReaction, toRelayReaction, } from "./reactions.js";
+export type { RelayReactionInput } from "./reactions.js";
+export { decodeWebhookSecret, verifyWebhookSignature, WebhookSecretError, WebhookVerificationError, } from "./signature.js";
+export type { VerifyWebhookSignatureOptions } from "./signature.js";
+export { assertRelayUuid, decodeRelayThreadId, encodeRelayThreadId, isRelayUuid, relayChannelIdFromThreadId, RELAY_THREAD_PREFIX, } from "./thread-id.js";
+export { inboundIdempotencyKey } from "./turn.js";
+export { RELAY_API_VERSION, RELAY_WEBHOOK_EVENT_TYPES, RELAY_WEBHOOK_VERSION, } from "./types.js";
+export type * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,GACb,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,YAAY,EACV,0BAA0B,EAC1B,2BAA2B,GAC5B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,sBAAsB,EACtB,aAAa,EACb,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,QAAQ,EACR,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,eAAe,EACf,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iBAAiB,EACjB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AACpB,mBAAmB,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+export { createRelayAdapter, RELAY_ADAPTER_NAME, RelayAdapter, } from "./adapter.js";
+export { RELAY_DEFAULT_BASE_URL, RelayApiError, RelayClient, } from "./client.js";
+export { relayEnv, resolveRelayCredential, validateStaticCredential, } from "./credentials.js";
+export { RELAY_MAX_ATTACHMENT_BYTES, RELAY_MAX_MESSAGE_PARTS, RELAY_MAX_TEXT_PART_LENGTH, } from "./content.js";
+export { fromRelayReaction, toRelayReaction, } from "./reactions.js";
+export { decodeWebhookSecret, verifyWebhookSignature, WebhookSecretError, WebhookVerificationError, } from "./signature.js";
+export { assertRelayUuid, decodeRelayThreadId, encodeRelayThreadId, isRelayUuid, relayChannelIdFromThreadId, RELAY_THREAD_PREFIX, } from "./thread-id.js";
+export { inboundIdempotencyKey } from "./turn.js";
+export { RELAY_API_VERSION, RELAY_WEBHOOK_EVENT_TYPES, RELAY_WEBHOOK_VERSION, } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,GACb,MAAM,cAAc,CAAC;AAMtB,OAAO,EACL,sBAAsB,EACtB,aAAa,EACb,WAAW,GACZ,MAAM,aAAa,CAAC;AAKrB,OAAO,EACL,QAAQ,EACR,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC;AAK1B,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iBAAiB,EACjB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,YAAY,CAAC"}

package/dist/reactions.d.ts

@@ -0,0 +1,15 @@
+import { type EmojiValue } from "chat";
+import type { RelayReactionType } from "./types.js";
+export interface RelayReactionInput {
+    customEmoji?: string;
+    type: RelayReactionType;
+}
+export declare function toRelayReaction(input: EmojiValue | string): RelayReactionInput;
+export declare function fromRelayReaction(input: {
+    customEmoji?: string | null;
+    type: RelayReactionType;
+}): {
+    emoji: EmojiValue;
+    rawEmoji: string;
+};
+//# sourceMappingURL=reactions.d.ts.map

package/dist/reactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactions.d.ts","sourceRoot":"","sources":["../src/reactions.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,UAAU,EAChB,MAAM,MAAM,CAAC;AACd,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAoCD,wBAAgB,eAAe,CAC7B,KAAK,EAAE,UAAU,GAAG,MAAM,GACzB,kBAAkB,CAkBpB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,EAAE,iBAAiB,CAAC;CACzB,GAAG;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAkB1C"}