feat(#81,#91,#95,#97): mark sunset/EOL providers as deprecated

drift, sendbird, userlike, zendesk-classic each get a JSDoc @deprecated
header and a one-shot console.warn on first load() so callers learn the
underlying vendor SDK is sunset, discontinued, or on a deprecation timeline
before they invest further. Behavior is otherwise unchanged.

- drift: Clari + Salesloft sunset announced 2026-03-06
- sendbird: AI Chatbot Widget repo archived 2025-07-09
- userlike: v1 CDN EOL 2026-08-01, vendor rebranded to Lime Connect
- zendesk-classic: Web Widget Classic limited to pre-2023-06-05 accounts;
  underlying Chat SDK in active removal

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: productdevbook

src/providers/drift.ts

@@ -1,3 +1,9 @@
+/**
+ * @deprecated Drift is being sunset by Clari + Salesloft (announced 2026-03-06,
+ * ~60–90 day customer wind-down). Drift was taken offline in Sept 2025 after the
+ * Salesloft OAuth breach. New integrations should pick a different provider.
+ * See https://github.com/productdevbook/ahize/issues/81 for migration notes.
+ */
 import { waitForDefer } from "../_defer.ts"
 import { createIdentityStore } from "../_identity.ts"
 import { createLifecycle, hashConfig } from "../_lifecycle.ts"
@@ -36,6 +42,7 @@ const store = createIdentityStore()
 const lifecycle = createLifecycle()
 let readyPromise: Promise<void> | undefined
 let readyResolve: (() => void) | undefined
+let sunsetWarned = false
 
 export interface DriftLoadOptions extends LoadOptions {
   embedId: string
@@ -45,6 +52,14 @@ export interface DriftLoadOptions extends LoadOptions {
 export async function load(options: DriftLoadOptions): Promise<void> {
   if (!isBrowser()) return
   if (options.consent === false) return
+  if (!sunsetWarned) {
+    sunsetWarned = true
+    console.warn(
+      "[ahize/drift] Drift is being sunset by Clari + Salesloft (announced 2026-03-06). " +
+        "New integrations should pick a different provider. " +
+        "See https://github.com/productdevbook/ahize/issues/81",
+    )
+  }
   const h = hashConfig({ embedId: options.embedId })
   if (lifecycle.state() === "ready" && lifecycle.configHash() === h) return
   if (lifecycle.configHash() && lifecycle.configHash() !== h) await destroy()

src/providers/sendbird.ts

@@ -2,6 +2,14 @@
 // awkwardly: track() throws, identify() is part of boot options, show()/hide()
 // are CSS-level. Use Sendbird Desk if you want full support semantics.
 
+/**
+ * @deprecated The Sendbird AI Chatbot Widget product targeted by this wrapper
+ * was discontinued by Sendbird. The source repo `sendbird/chat-ai-widget` was
+ * archived 2025-07-09 at v1.9.7 and the AI Chatbot docs were removed from
+ * sendbird.com. The successor "AI Agent" has a different API surface; Sendbird
+ * Desk is recommended for support semantics.
+ * See https://github.com/productdevbook/ahize/issues/91 for migration notes.
+ */
 import { waitForDefer } from "../_defer.ts"
 import { createIdentityStore } from "../_identity.ts"
 import { createLifecycle, hashConfig } from "../_lifecycle.ts"
@@ -34,6 +42,7 @@ const store = createIdentityStore()
 const lifecycle = createLifecycle()
 let currentSettings: SendbirdWidgetSettings | undefined
 let trackForwarder: ((event: string, metadata?: EventMetadata) => void) | undefined
+let sunsetWarned = false
 
 export class SendbirdUnsupportedError extends AhizeError {
   override name = "SendbirdUnsupportedError"
@@ -51,6 +60,14 @@ export interface SendbirdLoadOptions extends LoadOptions {
 export async function load(options: SendbirdLoadOptions): Promise<void> {
   if (!isBrowser()) return
   if (options.consent === false) return
+  if (!sunsetWarned) {
+    sunsetWarned = true
+    console.warn(
+      "[ahize/sendbird] The Sendbird AI Chatbot Widget product is discontinued " +
+        "(repo archived 2025-07-09 at v1.9.7). Consider Sendbird Desk or another provider. " +
+        "See https://github.com/productdevbook/ahize/issues/91",
+    )
+  }
   const h = hashConfig({
     appId: options.applicationId,
     botId: options.botId,

src/providers/userlike.ts

@@ -1,3 +1,10 @@
+/**
+ * @deprecated The Userlike v1 CDN bundle (`userlike-cdn-widgets.s3-eu-west-1...`)
+ * loaded by this wrapper reaches EOL on 2026-08-01. Userlike has rebranded to
+ * Lime Connect; the v2 SDK (`@userlike/messenger`, `createMessenger({ version: 2 })`)
+ * has a different surface and is the recommended migration target.
+ * See https://github.com/productdevbook/ahize/issues/95 for migration notes.
+ */
 import { waitForDefer } from "../_defer.ts"
 import { createIdentityStore } from "../_identity.ts"
 import { createLifecycle, hashConfig } from "../_lifecycle.ts"
@@ -41,6 +48,7 @@ function w(): UserlikeWindow {
 const queue = createQueue<UserlikeMessenger>()
 const store = createIdentityStore()
 const lifecycle = createLifecycle()
+let sunsetWarned = false
 
 function unwrap<T>(r: UserlikeResult<T>): T {
   if (!r.ok) throw new ProviderNotLoadedError(`Userlike error: ${r.error}`)
@@ -54,6 +62,14 @@ export interface UserlikeLoadOptions extends LoadOptions {
 export async function load(options: UserlikeLoadOptions): Promise<void> {
   if (!isBrowser()) return
   if (options.consent === false) return
+  if (!sunsetWarned) {
+    sunsetWarned = true
+    console.warn(
+      "[ahize/userlike] Userlike v1 CDN reaches EOL on 2026-08-01. " +
+        "Vendor rebranded to Lime Connect; migrate to @userlike/messenger v2. " +
+        "See https://github.com/productdevbook/ahize/issues/95",
+    )
+  }
   const h = hashConfig({ messengerId: options.messengerId })
   if (lifecycle.state() === "ready" && lifecycle.configHash() === h) return
   if (lifecycle.configHash() && lifecycle.configHash() !== h) await destroy()

src/providers/zendesk-classic.ts

@@ -2,6 +2,13 @@
 // API surface (zE('webWidget', '...')). Kept separate from ahize/zendesk so
 // types don't pretend cross-compatibility.
 
+/**
+ * @deprecated Web Widget (Classic) is only available on Zendesk accounts created
+ * before 2023-06-05. The underlying Chat Web SDK / Chat Conversation APIs entered
+ * active removal on 2025-04-30. New integrations should use `ahize/zendesk`
+ * (Messenger).
+ * See https://github.com/productdevbook/ahize/issues/97 for migration notes.
+ */
 import { waitForDefer } from "../_defer.ts"
 import { createIdentityStore } from "../_identity.ts"
 import { createLifecycle, hashConfig } from "../_lifecycle.ts"
@@ -29,6 +36,7 @@ function w(): ZendeskWindow {
 const queue = createQueue<ZendeskFn>()
 const store = createIdentityStore()
 const lifecycle = createLifecycle()
+let sunsetWarned = false
 
 export interface ZendeskClassicLoadOptions extends LoadOptions {
   key: string
@@ -37,6 +45,15 @@ export interface ZendeskClassicLoadOptions extends LoadOptions {
 export async function load(options: ZendeskClassicLoadOptions): Promise<void> {
   if (!isBrowser()) return
   if (options.consent === false) return
+  if (!sunsetWarned) {
+    sunsetWarned = true
+    console.warn(
+      "[ahize/zendesk-classic] Web Widget (Classic) is only available on Zendesk " +
+        "accounts created before 2023-06-05; underlying Chat SDK is being removed. " +
+        "Use ahize/zendesk (Messenger) for new integrations. " +
+        "See https://github.com/productdevbook/ahize/issues/97",
+    )
+  }
   const h = hashConfig({ key: options.key })
   if (lifecycle.state() === "ready" && lifecycle.configHash() === h) return
   if (lifecycle.configHash() && lifecycle.configHash() !== h) await destroy()