@relaymessenger/chat-sdk-adapter 0.2.1 → 0.3.0-staging.1

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"}

package/dist/reactions.js

@@ -0,0 +1,58 @@
+import { ValidationError } from "@chat-adapter/shared";
+import { defaultEmojiResolver, getEmoji, } from "chat";
+const STANDARD_BY_NAME = {
+    exclamation: "emphasize",
+    heart: "love",
+    laugh: "laugh",
+    question: "question",
+    thumbs_down: "dislike",
+    thumbs_up: "like",
+};
+const NAME_BY_STANDARD = {
+    dislike: "thumbs_down",
+    emphasize: "exclamation",
+    laugh: "laugh",
+    like: "thumbs_up",
+    love: "heart",
+    question: "question",
+};
+function normalizeName(input) {
+    const placeholder = /^\{\{emoji:([^}]+)\}\}$/.exec(input.trim());
+    const shortcode = /^:([^:]+):$/.exec(input.trim());
+    return (placeholder?.[1] ?? shortcode?.[1] ?? input.trim()).toLowerCase();
+}
+function looksLikeUnicodeEmoji(value) {
+    return (/\p{Extended_Pictographic}/u.test(value) ||
+        /\p{Regional_Indicator}{2}/u.test(value));
+}
+export function toRelayReaction(input) {
+    const raw = typeof input === "string" ? input.trim() : input.name;
+    const normalized = normalizeName(raw);
+    const standard = STANDARD_BY_NAME[normalized];
+    if (standard)
+        return { type: standard };
+    const literal = looksLikeUnicodeEmoji(raw)
+        ? raw
+        : defaultEmojiResolver.toGChat(normalized);
+    if (!looksLikeUnicodeEmoji(literal)) {
+        throw new ValidationError("relay", `Relay custom reactions require a Unicode emoji; received ${JSON.stringify(raw)}`);
+    }
+    return { customEmoji: literal, type: "custom" };
+}
+export function fromRelayReaction(input) {
+    if (input.type === "custom") {
+        if (!input.customEmoji) {
+            throw new ValidationError("relay", "A custom Relay reaction event is missing custom_emoji");
+        }
+        return {
+            emoji: defaultEmojiResolver.fromGChat(input.customEmoji),
+            rawEmoji: input.customEmoji,
+        };
+    }
+    const name = NAME_BY_STANDARD[input.type];
+    return {
+        emoji: getEmoji(name),
+        rawEmoji: defaultEmojiResolver.toGChat(name),
+    };
+}
+//# sourceMappingURL=reactions.js.map

package/dist/reactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactions.js","sourceRoot":"","sources":["../src/reactions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EACL,oBAAoB,EACpB,QAAQ,GAET,MAAM,MAAM,CAAC;AAQd,MAAM,gBAAgB,GAAsC;IAC1D,WAAW,EAAE,WAAW;IACxB,KAAK,EAAE,MAAM;IACb,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;IACpB,WAAW,EAAE,SAAS;IACtB,SAAS,EAAE,MAAM;CAClB,CAAC;AAEF,MAAM,gBAAgB,GAGlB;IACF,OAAO,EAAE,aAAa;IACtB,SAAS,EAAE,aAAa;IACxB,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,OAAO;IACb,QAAQ,EAAE,UAAU;CACrB,CAAC;AAEF,SAAS,aAAa,CAAC,KAAa;IAClC,MAAM,WAAW,GAAG,yBAAyB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACjE,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACnD,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AAC5E,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAa;IAC1C,OAAO,CACL,4BAA4B,CAAC,IAAI,CAAC,KAAK,CAAC;QACxC,4BAA4B,CAAC,IAAI,CAAC,KAAK,CAAC,CACzC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,KAA0B;IAE1B,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;IAClE,MAAM,UAAU,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAC9C,IAAI,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAExC,MAAM,OAAO,GAAG,qBAAqB,CAAC,GAAG,CAAC;QACxC,CAAC,CAAC,GAAG;QACL,CAAC,CAAC,oBAAoB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC7C,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,eAAe,CACvB,OAAO,EACP,4DAA4D,IAAI,CAAC,SAAS,CACxE,GAAG,CACJ,EAAE,CACJ,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAGjC;IACC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;YACvB,MAAM,IAAI,eAAe,CACvB,OAAO,EACP,uDAAuD,CACxD,CAAC;QACJ,CAAC;QACD,OAAO;YACL,KAAK,EAAE,oBAAoB,CAAC,SAAS,CAAC,KAAK,CAAC,WAAW,CAAC;YACxD,QAAQ,EAAE,KAAK,CAAC,WAAW;SAC5B,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1C,OAAO;QACL,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC;QACrB,QAAQ,EAAE,oBAAoB,CAAC,OAAO,CAAC,IAAI,CAAC;KAC7C,CAAC;AACJ,CAAC"}

package/dist/signature.d.ts

@@ -0,0 +1,22 @@
+import type { RelayCredential } from "./credentials.js";
+export interface VerifyWebhookSignatureOptions {
+    nowSeconds?: number;
+    toleranceSeconds?: number;
+}
+export declare class WebhookSecretError extends Error {
+    constructor(message: string);
+}
+export declare class WebhookVerificationError extends Error {
+    constructor(message: string);
+}
+export declare function decodeWebhookSecret(secret: string): Uint8Array<ArrayBuffer>;
+/**
+ * Verify Relay's current Standard Webhooks v1 signature over the exact body.
+ */
+export declare function verifyWebhookSignature(input: {
+    headers: Pick<Headers, "get">;
+    payload: string;
+    secret: RelayCredential;
+    options?: VerifyWebhookSignatureOptions;
+}): Promise<void>;
+//# sourceMappingURL=signature.d.ts.map

package/dist/signature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signature.d.ts","sourceRoot":"","sources":["../src/signature.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGxD,MAAM,WAAW,6BAA6B;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AA0BD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,GACb,UAAU,CAAC,WAAW,CAAC,CAWzB;AAWD;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,KAAK,EAAE;IAClD,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,CAAC,EAAE,6BAA6B,CAAC;CACzC,GAAG,OAAO,CAAC,IAAI,CAAC,CA+DhB"}

package/dist/signature.js

@@ -0,0 +1,98 @@
+import { resolveRelayCredential } from "./credentials.js";
+export class WebhookSecretError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "WebhookSecretError";
+    }
+}
+export class WebhookVerificationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "WebhookVerificationError";
+    }
+}
+const DEFAULT_TOLERANCE_SECONDS = 5 * 60;
+function decodeBase64(value) {
+    const normalized = value.trim();
+    if (!normalized ||
+        normalized.length % 4 === 1 ||
+        !/^[A-Za-z0-9+/]*={0,2}$/.test(normalized)) {
+        throw new WebhookSecretError("value is not valid base64");
+    }
+    try {
+        const binary = atob(normalized);
+        if (!binary)
+            throw new Error("empty");
+        const bytes = new Uint8Array(binary.length);
+        for (let index = 0; index < binary.length; index += 1) {
+            bytes[index] = binary.charCodeAt(index);
+        }
+        return bytes;
+    }
+    catch {
+        throw new WebhookSecretError("value is not valid base64");
+    }
+}
+export function decodeWebhookSecret(secret) {
+    const encoded = secret.startsWith("whsec_")
+        ? secret.slice("whsec_".length)
+        : secret;
+    try {
+        return decodeBase64(encoded);
+    }
+    catch {
+        throw new WebhookSecretError("Relay webhookSecret must be the base64 whsec_ value Relay issued");
+    }
+}
+function constantTimeEqual(left, right) {
+    if (left.length !== right.length)
+        return false;
+    let difference = 0;
+    for (let index = 0; index < left.length; index += 1) {
+        difference |= left[index] ^ right[index];
+    }
+    return difference === 0;
+}
+/**
+ * Verify Relay's current Standard Webhooks v1 signature over the exact body.
+ */
+export async function verifyWebhookSignature(input) {
+    const id = input.headers.get("webhook-id");
+    const timestamp = input.headers.get("webhook-timestamp");
+    const signatures = input.headers.get("webhook-signature");
+    if (!id || !timestamp || !signatures) {
+        throw new WebhookVerificationError("missing Standard Webhooks signature headers");
+    }
+    const parsedTimestamp = Number(timestamp);
+    if (!Number.isSafeInteger(parsedTimestamp) ||
+        parsedTimestamp < 0) {
+        throw new WebhookVerificationError("invalid webhook-timestamp");
+    }
+    const now = input.options?.nowSeconds ?? Math.floor(Date.now() / 1_000);
+    const tolerance = input.options?.toleranceSeconds ?? DEFAULT_TOLERANCE_SECONDS;
+    if (!Number.isFinite(tolerance) ||
+        tolerance < 0 ||
+        Math.abs(now - parsedTimestamp) > tolerance) {
+        throw new WebhookVerificationError("webhook-timestamp outside tolerance");
+    }
+    const secret = await resolveRelayCredential(input.secret, "Relay webhook signing secret");
+    const key = await crypto.subtle.importKey("raw", decodeWebhookSecret(secret), { hash: "SHA-256", name: "HMAC" }, false, ["sign"]);
+    const content = `${id}.${timestamp}.${input.payload}`;
+    const expected = new Uint8Array(await crypto.subtle.sign("HMAC", key, new TextEncoder().encode(content)));
+    for (const candidate of signatures.split(/\s+/)) {
+        const [version, encoded] = candidate.split(",", 2);
+        if (version !== "v1" || !encoded)
+            continue;
+        let provided;
+        try {
+            provided = decodeBase64(encoded);
+        }
+        catch {
+            continue;
+        }
+        if (constantTimeEqual(expected, provided))
+            return;
+    }
+    throw new WebhookVerificationError("no matching v1 signature");
+}
+//# sourceMappingURL=signature.js.map

package/dist/signature.js.map

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

package/dist/thread-id.d.ts

@@ -0,0 +1,8 @@
+import type { RelayThreadId } from "./types.js";
+export declare const RELAY_THREAD_PREFIX = "relay:";
+export declare function isRelayUuid(value: string): boolean;
+export declare function assertRelayUuid(value: string, label: string): void;
+export declare function encodeRelayThreadId(data: RelayThreadId): string;
+export declare function decodeRelayThreadId(threadId: string): RelayThreadId;
+export declare function relayChannelIdFromThreadId(threadId: string): string;
+//# sourceMappingURL=thread-id.d.ts.map

package/dist/thread-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-id.d.ts","sourceRoot":"","sources":["../src/thread-id.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,eAAO,MAAM,mBAAmB,WAAW,CAAC;AAK5C,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAElD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAOlE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAG/D;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAUnE;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnE"}

package/dist/thread-id.js

@@ -0,0 +1,27 @@
+import { ValidationError } from "@chat-adapter/shared";
+export const RELAY_THREAD_PREFIX = "relay:";
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+export function isRelayUuid(value) {
+    return UUID.test(value);
+}
+export function assertRelayUuid(value, label) {
+    if (!isRelayUuid(value)) {
+        throw new ValidationError("relay", `${label} must be a Relay UUID; received ${JSON.stringify(value)}`);
+    }
+}
+export function encodeRelayThreadId(data) {
+    assertRelayUuid(data.chatId, "chatId");
+    return `${RELAY_THREAD_PREFIX}${data.chatId}`;
+}
+export function decodeRelayThreadId(threadId) {
+    if (!threadId.startsWith(RELAY_THREAD_PREFIX)) {
+        throw new ValidationError("relay", `not a Relay thread ID: ${JSON.stringify(threadId)}`);
+    }
+    const chatId = threadId.slice(RELAY_THREAD_PREFIX.length);
+    assertRelayUuid(chatId, "Relay thread chat ID");
+    return { chatId };
+}
+export function relayChannelIdFromThreadId(threadId) {
+    return encodeRelayThreadId(decodeRelayThreadId(threadId));
+}
+//# sourceMappingURL=thread-id.js.map

package/dist/thread-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-id.js","sourceRoot":"","sources":["../src/thread-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,MAAM,CAAC,MAAM,mBAAmB,GAAG,QAAQ,CAAC;AAE5C,MAAM,IAAI,GACR,iEAAiE,CAAC;AAEpE,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,KAAa;IAC1D,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,eAAe,CACvB,OAAO,EACP,GAAG,KAAK,mCAAmC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CACnE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAmB;IACrD,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACvC,OAAO,GAAG,mBAAmB,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,eAAe,CACvB,OAAO,EACP,0BAA0B,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CACrD,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC1D,eAAe,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IAChD,OAAO,EAAE,MAAM,EAAE,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,QAAgB;IACzD,OAAO,mBAAmB,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC5D,CAAC"}

package/dist/turn.d.ts

@@ -0,0 +1,16 @@
+export interface RelayTurn {
+    readonly eventId: string;
+    sent: number;
+    tail: Promise<void>;
+}
+/**
+ * Request-local transport context. It is never persisted and owns no delivery
+ * record; it only makes Relay's Idempotency-Key stable for a redelivered event.
+ */
+export declare class RelayTurnContext {
+    private readonly storage;
+    run<T>(eventId: string, callback: () => T): T;
+    active(): RelayTurn | undefined;
+}
+export declare function inboundIdempotencyKey(eventId: string, ordinal: number): string;
+//# sourceMappingURL=turn.d.ts.map

package/dist/turn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn.d.ts","sourceRoot":"","sources":["../src/turn.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CACrB;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;IAE9D,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAS5C;IAED,MAAM,IAAI,SAAS,GAAG,SAAS,CAE9B;CACF;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,MAAM,CAER"}

package/dist/turn.js

@@ -0,0 +1,22 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+/**
+ * Request-local transport context. It is never persisted and owns no delivery
+ * record; it only makes Relay's Idempotency-Key stable for a redelivered event.
+ */
+export class RelayTurnContext {
+    storage = new AsyncLocalStorage();
+    run(eventId, callback) {
+        return this.storage.run({
+            eventId,
+            sent: 0,
+            tail: Promise.resolve(),
+        }, callback);
+    }
+    active() {
+        return this.storage.getStore();
+    }
+}
+export function inboundIdempotencyKey(eventId, ordinal) {
+    return `relay-chat-sdk:${eventId}:${ordinal}`;
+}
+//# sourceMappingURL=turn.js.map

package/dist/turn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn.js","sourceRoot":"","sources":["../src/turn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAQrD;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IACV,OAAO,GAAG,IAAI,iBAAiB,EAAa,CAAC;IAE9D,GAAG,CAAI,OAAe,EAAE,QAAiB;QACvC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CACrB;YACE,OAAO;YACP,IAAI,EAAE,CAAC;YACP,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE;SACxB,EACD,QAAQ,CACT,CAAC;IACJ,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;IACjC,CAAC;CACF;AAED,MAAM,UAAU,qBAAqB,CACnC,OAAe,EACf,OAAe;IAEf,OAAO,kBAAkB,OAAO,IAAI,OAAO,EAAE,CAAC;AAChD,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,193 @@
+/**
+ * Relay v1 wire types used by this adapter.
+ *
+ * Contract source:
+ * Relay Server 9b4d5bb32cc749c6fd271969948c385300d404d6
+ * OpenAPI f62f431fc0daa48500926bf87753f81c3fdda25ab463b130ca97f2896367e0a5
+ */
+export declare const RELAY_API_VERSION: "v1";
+export declare const RELAY_WEBHOOK_VERSION: "2026-08-30";
+export declare const RELAY_WEBHOOK_EVENT_TYPES: readonly ["message.sent", "message.received", "message.read", "message.delivered", "reaction.added", "reaction.removed", "participant.added", "participant.removed", "chat.created", "chat.group_name_updated", "chat.group_icon_updated", "chat.typing_indicator.started", "chat.typing_indicator.stopped", "contact.added", "contact.removed"];
+export type RelayWebhookEventType = (typeof RELAY_WEBHOOK_EVENT_TYPES)[number];
+export interface RelayWebhookEnvelope<TData = Record<string, unknown>> {
+    agent_id: string;
+    api_version: typeof RELAY_API_VERSION;
+    created_at: string;
+    data: TData;
+    event_id: string;
+    event_type: RelayWebhookEventType;
+    trace_id: string;
+    webhook_version: typeof RELAY_WEBHOOK_VERSION;
+}
+export interface RelayChatHandle {
+    avatar_url: string | null;
+    display_name: string | null;
+    handle: string;
+    id: string;
+    is_me?: boolean | null;
+    joined_at: string;
+    kind: "user" | "agent";
+    left_at?: string | null;
+    status?: "active" | "left" | "removed" | null;
+    tagline: string | null;
+    verified: boolean;
+}
+export type RelayReactionType = "love" | "like" | "dislike" | "laugh" | "emphasize" | "question" | "custom";
+export interface RelayReaction {
+    custom_emoji?: string | null;
+    handle: RelayChatHandle;
+    is_me: boolean;
+    type: RelayReactionType;
+}
+export interface RelayTextPart {
+    mention?: string | null;
+    mention_range?: [number, number] | null;
+    type: "text";
+    value: string;
+}
+export interface RelayMediaPart {
+    attachment_id?: string;
+    type: "media";
+    url?: string;
+}
+export interface RelayLinkPart {
+    type: "link";
+    value: string;
+}
+export type RelayOutgoingPart = RelayTextPart | RelayMediaPart | RelayLinkPart;
+export interface RelayTextPartResponse extends RelayTextPart {
+    reactions?: RelayReaction[] | null;
+}
+export interface RelayMediaPartResponse {
+    duration_ms?: number | null;
+    filename: string;
+    height?: number | null;
+    id: string;
+    mime_type: string;
+    reactions?: RelayReaction[] | null;
+    size_bytes: number;
+    type: "media";
+    url: string;
+    width?: number | null;
+}
+export interface RelayLinkPartResponse extends RelayLinkPart {
+    reactions?: RelayReaction[] | null;
+}
+export interface RelaySystemPartResponse {
+    reactions?: RelayReaction[] | null;
+    type: "system";
+    value: string;
+}
+export type RelayMessagePartResponse = RelayTextPartResponse | RelayMediaPartResponse | RelayLinkPartResponse | RelaySystemPartResponse;
+export interface RelayReplyTo {
+    message_id: string;
+    part_index?: number;
+}
+export interface RelayMessage {
+    chat_id: string;
+    created_at: string;
+    delivered_at?: string | null;
+    delivery_status: "sent" | "delivered" | "read";
+    from?: string | null;
+    from_handle?: RelayChatHandle | null;
+    id: string;
+    is_from_me: boolean;
+    is_system_message: boolean;
+    parts?: RelayMessagePartResponse[] | null;
+    read_at?: string | null;
+    reply_to?: RelayReplyTo | null;
+    sent_at?: string | null;
+    system_event?: Record<string, unknown> | null;
+    updated_at: string;
+}
+export interface RelayWebhookMessageEvent {
+    chat: {
+        id: string;
+        is_group?: boolean | null;
+        owner_handle?: RelayChatHandle | null;
+    };
+    delivered_at?: string | null;
+    direction: "inbound" | "outbound";
+    id: string;
+    idempotency_key?: string | null;
+    parts: Array<RelayTextPartResponse | RelayMediaPartResponse | RelayLinkPartResponse>;
+    read_at?: string | null;
+    reply_to?: RelayReplyTo | null;
+    sender_handle: RelayChatHandle;
+    sent_at?: string | null;
+}
+export interface RelaySentMessage {
+    created_at: string;
+    delivered_at?: string | null;
+    delivery_status: "sent" | "delivered" | "read";
+    from_handle?: RelayChatHandle | null;
+    id: string;
+    parts: Array<RelayTextPartResponse | RelayMediaPartResponse | RelayLinkPartResponse>;
+    reply_to?: RelayReplyTo | null;
+    sent_at: string | null;
+}
+export interface RelaySendMessageResponse {
+    chat_id: string;
+    message: RelaySentMessage;
+}
+export interface RelayGetMessagesResult {
+    messages: RelayMessage[];
+    next_cursor?: string | null;
+}
+export interface RelayChat {
+    created_at: string;
+    display_name: string | null;
+    group_chat_icon?: string | null;
+    handles: RelayChatHandle[];
+    id: string;
+    is_group: boolean;
+    updated_at: string;
+}
+export interface RelayReactionEvent {
+    chat_id: string;
+    custom_emoji?: string | null;
+    from_handle: RelayChatHandle;
+    is_from_me: boolean;
+    message_id: string;
+    part_index: number;
+    reacted_at: string;
+    reaction_type: RelayReactionType;
+}
+/**
+ * `GET /v1/attachments/{attachmentId}` metadata. `download_url` is optional in
+ * the locked v1 contract, so a caller must handle its absence.
+ */
+export interface RelayAttachment {
+    content_type: string;
+    created_at: string;
+    download_url?: string;
+    duration_ms?: number | null;
+    filename: string;
+    height?: number | null;
+    id: string;
+    size_bytes: number;
+    status: "pending" | "complete" | "failed";
+    width?: number | null;
+}
+export interface RelayAttachmentAllocation {
+    attachment_id: string;
+    download_url: string;
+    expires_at: string;
+    http_method: "PUT";
+    required_headers: Record<string, string>;
+    upload_url: string;
+}
+export interface RelayRawMessage {
+    chatId: string;
+    createdAt?: string;
+    eventId?: string;
+    eventType?: RelayWebhookEventType;
+    message: RelayMessage | RelaySentMessage | RelayWebhookMessageEvent | null;
+    /** Synthetic Chat SDK result for an intentionally empty no-op post. */
+    noop?: true;
+}
+/** Platform data encoded by `relay:<chat UUID>`. */
+export interface RelayThreadId {
+    chatId: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,27 @@
+/**
+ * Relay v1 wire types used by this adapter.
+ *
+ * Contract source:
+ * Relay Server 9b4d5bb32cc749c6fd271969948c385300d404d6
+ * OpenAPI f62f431fc0daa48500926bf87753f81c3fdda25ab463b130ca97f2896367e0a5
+ */
+export const RELAY_API_VERSION = "v1";
+export const RELAY_WEBHOOK_VERSION = "2026-08-30";
+export const RELAY_WEBHOOK_EVENT_TYPES = [
+    "message.sent",
+    "message.received",
+    "message.read",
+    "message.delivered",
+    "reaction.added",
+    "reaction.removed",
+    "participant.added",
+    "participant.removed",
+    "chat.created",
+    "chat.group_name_updated",
+    "chat.group_icon_updated",
+    "chat.typing_indicator.started",
+    "chat.typing_indicator.stopped",
+    "contact.added",
+    "contact.removed",
+];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAa,CAAC;AAC/C,MAAM,CAAC,MAAM,qBAAqB,GAAG,YAAqB,CAAC;AAE3D,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,cAAc;IACd,kBAAkB;IAClB,cAAc;IACd,mBAAmB;IACnB,gBAAgB;IAChB,kBAAkB;IAClB,mBAAmB;IACnB,qBAAqB;IACrB,cAAc;IACd,yBAAyB;IACzB,yBAAyB;IACzB,+BAA+B;IAC/B,+BAA+B;IAC/B,eAAe;IACf,iBAAiB;CACT,CAAC"}

package/dist/webhook.d.ts

@@ -0,0 +1,9 @@
+import type { RelayReactionEvent, RelayWebhookEnvelope, RelayWebhookEventType, RelayWebhookMessageEvent } from "./types.js";
+export declare const MAX_WEBHOOK_BODY_BYTES: number;
+export declare function parseWebhookEnvelope(value: unknown): RelayWebhookEnvelope;
+export declare function parseWebhookMessageEvent(data: Record<string, unknown>): RelayWebhookMessageEvent;
+export declare function parseReactionEvent(data: Record<string, unknown>): RelayReactionEvent;
+export declare function assertExhaustiveEvent(eventType: never): never;
+export declare function readWebhookBody(request: Request): Promise<string>;
+export declare function isMessageEventType(value: RelayWebhookEventType): value is "message.sent" | "message.received" | "message.read" | "message.delivered";
+//# sourceMappingURL=webhook.d.ts.map

package/dist/webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../src/webhook.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACzB,MAAM,YAAY,CAAC;AAYpB,eAAO,MAAM,sBAAsB,QAAgB,CAAC;AAiBpD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,GACb,oBAAoB,CA2BtB;AAYD,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,wBAAwB,CAkB1B;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,kBAAkB,CA4BpB;AAED,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,KAAK,GACf,KAAK,CAEP;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAsBvE;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,qBAAqB,GAC3B,KAAK,IACJ,cAAc,GACd,kBAAkB,GAClB,cAAc,GACd,mBAAmB,CAEtB"}