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

package/package.json

@@ -1,59 +1,78 @@
 {
   "name": "@relaymessenger/chat-sdk-adapter",
-  "version": "0.2.1",
-  "description": "Relay adapter for the Vercel Chat SDK. Receive signed Relay webhooks and post replies as one canonical message.",
-  "homepage": "https://docs.relayapp.im/integrations/chat-sdk",
-  "bugs": {
-    "url": "https://github.com/relaymessenger/Relay-SDK/issues"
-  },
-  "license": "MIT",
+  "version": "0.3.0-staging.0",
+  "description": "Vendor-official Relay adapter for Vercel Chat SDK.",
   "keywords": [
     "relay",
     "chat-sdk",
     "adapter",
     "messaging",
-    "agent",
     "webhook"
   ],
-  "engines": {
-    "node": ">=22.18"
+  "homepage": "https://docs.relayapp.im/integrations/chat-sdk",
+  "bugs": {
+    "url": "https://github.com/RelayMessenger/Relay-Chat-SDK/issues"
   },
-  "publishConfig": {
-    "access": "public"
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/RelayMessenger/Relay-Chat-SDK.git"
   },
+  "license": "MIT",
   "type": "module",
-  "main": "./dist/src/index.js",
-  "types": "./dist/src/index.d.ts",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/src/index.d.ts",
-      "default": "./dist/src/index.js"
-    }
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
   },
   "files": [
+    "dist/",
     "README.md",
-    "LICENSE",
-    "dist/**/*.js",
-    "dist/**/*.d.ts"
+    "LICENSE"
   ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/",
+    "tag": "staging",
+    "provenance": true
+  },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
     "check": "tsc --noEmit",
-    "test": "vitest run",
-    "prepack": "npm run build"
+    "test": "npm run test:unit && npm run test:workerd",
+    "test:unit": "vitest run --config vitest.config.ts",
+    "test:workerd": "vitest run --config vitest.workerd.config.ts",
+    "test:installed": "node scripts/test-installed-package.mjs",
+    "test:all": "npm run check && npm run build && npm run test && npm run test:installed",
+    "example:check": "RELAY_EXAMPLE_CHECK=1 node examples/server.mjs",
+    "prepack": "npm run check && npm run test && npm run build",
+    "wrangler:types": "wrangler types",
+    "wrangler:types:check": "wrangler types --check"
   },
   "peerDependencies": {
-    "chat": "^4.38.0"
+    "chat": "^4.39.0"
   },
-  "devDependencies": {
-    "@types/node": "^26.2.0",
-    "chat": "^4.38.1",
-    "typescript": "^7.0.2",
-    "vitest": "^4.1.10"
+  "dependencies": {
+    "@chat-adapter/shared": "4.39.0"
   },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/relaymessenger/Relay-SDK.git",
-    "directory": "integrations/chat-sdk"
+  "devDependencies": {
+    "@chat-adapter/state-memory": "4.39.0",
+    "@chat-adapter/tests": "4.39.0",
+    "@cloudflare/vitest-plugin": "1.1.2",
+    "@types/node": "26.4.0",
+    "@vitest/coverage-v8": "4.1.11",
+    "chat": "4.39.0",
+    "typescript": "7.0.2",
+    "vitest": "4.1.11",
+    "wrangler": "4.127.1",
+    "yaml": "2.9.0"
   }
 }

package/dist/src/adapter.d.ts

@@ -1,125 +0,0 @@
-import { Message } from "chat";
-import type { Adapter, AdapterPostableMessage, ChatInstance, EmojiValue, FetchOptions, FetchResult, FormattedContent, RawMessage, StreamChunk, ThreadInfo, UserInfo, WebhookOptions } from "chat";
-import { RelayClient } from "./client.js";
-import type { RelayClientOptions } from "./client.js";
-import type { RelayMessage, RelayRawMessage, RelayThreadId } from "./types.js";
-export declare const RELAY_ADAPTER_NAME = "relay";
-export interface RelayAdapterOptions extends Omit<RelayClientOptions, "token"> {
-    /** Agent Token. Defaults to `RELAY_AGENT_TOKEN`. */
-    token?: string;
-    /** Webhook signing secret. Defaults to `RELAY_WEBHOOK_SECRET`. */
-    webhookSecret?: string;
-    /** Display name for the agent. Defaults to `Relay Agent`. */
-    userName?: string;
-    /** This agent's `agt_` id, when the caller knows it. */
-    agentId?: string;
-    /** Clock tolerance for signature verification, in seconds. */
-    toleranceSeconds?: number;
-    /** How many handled `event_id` values to remember. */
-    dedupeWindow?: number;
-    /** Override the client, mainly for tests. */
-    client?: RelayClient;
-}
-/**
- * A group turn tried to commit a second message. Relay's invocation is single
- * use, so there is nothing valid for the second message to cite and the server
- * would answer 403.
- */
-export declare class RelayInvocationSpentError extends Error {
-    constructor(message: string);
-}
-/**
- * Relay adapter for the Vercel Chat SDK.
- *
- * Relay is a consumer messenger where people talk to agents as contacts, so
- * this adapter maps the Chat SDK's thread model onto Relay conversations one
- * to one: a Relay conversation has no enclosing channel, and a thread id is
- * `relay:{conversation_id}`.
- *
- * Two Relay rules shape the surface. A streamed turn commits exactly one
- * canonical message, so `stream` buffers and posts once rather than editing a
- * draft bubble into place. And a group reply is scoped to the single-use
- * invocation that produced the inbound event, so the first send of a turn
- * carries it and a second cannot.
- */
-export declare class RelayAdapter implements Adapter<RelayThreadId, RelayRawMessage> {
-    readonly name = "relay";
-    readonly userName: string;
-    readonly botUserId?: string;
-    readonly lockScope: "thread";
-    /** Relay serves history from `GET /v1/conversations/{id}/messages`. */
-    readonly persistThreadHistory = false;
-    private readonly client;
-    private readonly webhookSecret?;
-    private readonly toleranceSeconds?;
-    private readonly dedupe;
-    private chat?;
-    constructor(options?: RelayAdapterOptions);
-    initialize(chat: ChatInstance): Promise<void>;
-    encodeThreadId(platformData: RelayThreadId): string;
-    decodeThreadId(threadId: string): RelayThreadId;
-    channelIdFromThreadId(threadId: string): string;
-    renderFormatted(content: FormattedContent): string;
-    parseMessage(raw: RelayRawMessage): Message<RelayRawMessage>;
-    postMessage(threadId: string, message: AdapterPostableMessage): Promise<RawMessage<RelayRawMessage>>;
-    editMessage(threadId: string, messageId: string, message: AdapterPostableMessage): Promise<RawMessage<RelayRawMessage>>;
-    deleteMessage(threadId: string, messageId: string): Promise<void>;
-    addReaction(threadId: string, messageId: string, emoji: EmojiValue | string): Promise<void>;
-    removeReaction(threadId: string, messageId: string, emoji: EmojiValue | string): Promise<void>;
-    /**
-     * Relay's typing indicator is ephemeral and carries an optional label of up
-     * to 80 characters. The invocation is peeked rather than consumed: typing is
-     * not the group reply the invocation is spent on.
-     *
-     * Failures are swallowed. Group typing without a live pending invocation is a
-     * 403 (`Relay-Server/server/src/domain/typing.ts:70-73`), which is exactly
-     * what typing after the first send of a group turn looks like. The Chat SDK
-     * treats this call as best effort and has no `stopTyping` to strand, so a
-     * hint that cannot be shown must never take the reply down with it.
-     */
-    startTyping(threadId: string, status?: string): Promise<void>;
-    markAsRead(threadId: string, messageId: string): Promise<void>;
-    getUser(userId: string): Promise<UserInfo | null>;
-    /**
-     * Relay pages history backwards with `before_sequence` and returns newest
-     * first; the Chat SDK wants each page in chronological order. There is no
-     * forward cursor on the route, so `direction: "forward"` has nothing to call.
-     */
-    fetchMessages(threadId: string, options?: FetchOptions): Promise<FetchResult<RelayRawMessage>>;
-    fetchThread(threadId: string): Promise<ThreadInfo>;
-    /**
-     * Relay commits one canonical message per turn and has no draft bubble to
-     * edit, so the stream is buffered and posted once. Nothing partial ever
-     * reaches a recipient, and no cleanup is needed if the stream fails midway.
-     */
-    stream(threadId: string, textStream: AsyncIterable<string | StreamChunk>): Promise<RawMessage<RelayRawMessage> | null>;
-    /**
-     * Verify the Standard Webhooks signature over the exact raw body, refuse a
-     * replay by `event_id`, and hand the event to the Chat SDK. Relay redelivers
-     * on 5xx, so a dispatch failure must not answer 2xx.
-     */
-    handleWebhook(request: Request, options?: WebhookOptions): Promise<Response>;
-    private dispatch;
-    private buildParts;
-    private textParts;
-    /**
-     * Relay has no card surface: interactive components were removed from the
-     * app, so buttons cannot render and a human cannot answer one in Relay. The
-     * card's words are still delivered, as text, rather than dropped.
-     */
-    private cardToText;
-    private attachmentPart;
-    private filePart;
-    /**
-     * Send the parts in one call when they fit, and as follow-up calls when
-     * they do not. The server splits each call at ingest into one or more
-     * messages, and the one call that carries the invocation owns every message
-     * it commits. A group turn cannot overflow, and cannot POST twice: Relay's
-     * invocation is single use per call, so a second POST has nothing valid to
-     * cite and the server answers 403.
-     */
-    private sendParts;
-}
-/** Build a Relay adapter for the Vercel Chat SDK. */
-export declare function createRelayAdapter(options?: RelayAdapterOptions): RelayAdapter;
-export type { RelayMessage };