v4.0.0

artu-widget

Mar 23, 2026 · 160.2 KB · eeb0282

Replaces Supabase Realtime with AWS AppSync Events and migrates the entire API surface from v2 to v3.

Patch notes

Replaces @supabase/realtime-js with a native WebSocket transport that connects directly to AWS AppSync Events using the aws-appsync-event-ws subprotocol.
Migrates all API calls from /api/webchat/v2/{appId}/* to /api/webchat/v3/{appId}/* endpoints.
Session response now provides realtimeUrl and httpHost from the backend, eliminating all client-side Supabase configuration.
Removes VITE_SUPABASE_URL and VITE_SUPABASE_PUBLISHABLE_KEY environment variables — the only required env var is VITE_WEBCHAT_API_URL.
Topic format changes from conv:{appId}:{senderId} to webchat/{senderId}-{appId} to match the AppSync channel namespace.
Adds automatic exponential-backoff reconnection (1s–30s) on WebSocket disconnects.

Requires backend v3 endpoints deployed with AppSync configuration (APPSYNC_REALTIME_URL, APPSYNC_HTTP_HOST, WEBCHAT_JWT_SECRET).
Removes all Supabase dependencies and environment variables — v2 backend is no longer supported.
Session response shape now includes realtimeUrl and httpHost fields; older v2 responses will be rejected.

This embed requires both data-app-id and data-publishable-key.

Download .min.js

<script
  src="../artu-widget-4.0.0.min.js"
  data-app-id="app_xxx"
  data-publishable-key="webchat_pk_xxx"
></script>