add TeamsLite demo for chat sdk

sdk/webpubsub-chat-client/.gitignore

@@ -0,0 +1,7 @@
+node_modules
+dist
+types
+tsconfig.tsbuildinfo
+.env
+.yarn
+*.tgz

sdk/webpubsub-chat-client/.yarnrc.yml

@@ -0,0 +1,7 @@
+nodeLinker: node-modules
+
+# Temporary: Use MyGet feed for @azure scoped packages during preview.
+# This will be removed once the package is published to npm.
+npmScopes:
+  azure:
+    npmRegistryServer: "https://www.myget.org/F/azure-signalr-dev/npm/"

sdk/webpubsub-chat-client/README.md

@@ -0,0 +1,121 @@
+# Azure Web PubSub Chat Client SDK
+
+A client SDK for building chat applications with Azure Web PubSub.
+
+> ⚠️ **Internal Preview**: This package is currently for internal use only and is not ready for production.
+
+## Installation
+
+```bash
+npm install @azure/web-pubsub-chat-client
+```
+
+## Quick Start
+
+For a complete example, see [examples/quickstart](./examples/quickstart).
+
+```javascript
+import { ChatClient } from '@azure/web-pubsub-chat-client';
+
+// Get client access URL from your server
+const url = await fetch('/negotiate?userId=alice').then(r => r.json()).then(d => d.url);
+
+// Option 1: Login with an existing WebPubSubClient
+const wpsClient = new WebPubSubClient(url);
+const client = await ChatClient.login(wpsClient);
+
+// Option 2: Login directly with URL
+// const client = await new ChatClient(url).login();
+
+console.log(`Logged in as: ${client.userId}`);
+
+// Listen for events
+client.addListenerForNewMessage((notification) => {
+  const msg = notification.message;
+  console.log(`${msg.createdBy}: ${msg.content.text}`);
+});
+
+client.addListenerForNewRoom((room) => {
+  console.log(`Joined room: ${room.title}`);
+});
+
+// Create a room and send messages
+const room = await client.createRoom('My Room', ['bob']);
+await client.sendToRoom(room.roomId, 'Hello!');
+
+// Get message history
+const history = await client.listRoomMessage(room.roomId, null, null);
+
+// Manage room members
+await client.addUserToRoom(room.roomId, 'charlie');
+await client.removeUserFromRoom(room.roomId, 'charlie');
+
+// Cleanup
+client.stop();
+```
+
+## API
+
+### ChatClient
+
+#### Constructor
+
+```typescript
+// With existing WebPubSubClient
+new ChatClient(wpsClient: WebPubSubClient)
+
+// With client access URL
+new ChatClient(clientAccessUrl: string, options?: WebPubSubClientOptions)
+
+// With credential
+new ChatClient(credential: WebPubSubClientCredential, options?: WebPubSubClientOptions)
+```
+
+#### Static Methods
+
+| Method | Description |
+|--------|-------------|
+| `ChatClient.login(wpsClient)` | Create and login using an existing WebPubSubClient |
+
+#### Properties
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `userId` | `string` | Current user's ID (throws if not logged in) |
+| `rooms` | `RoomInfo[]` | List of joined rooms |
+| `connection` | `WebPubSubClient` | Underlying WebPubSub connection |
+
+#### Methods
+
+| Method | Description |
+|--------|-------------|
+| `login()` | Connect and authenticate, returns `ChatClient` |
+| `stop()` | Disconnect |
+| `createRoom(title, members, roomId?)` | Create a new room with initial members |
+| `getRoom(roomId, withMembers)` | Get room info |
+| `addUserToRoom(roomId, userId)` | Add user to room (admin operation) |
+| `removeUserFromRoom(roomId, userId)` | Remove user from room (admin operation) |
+| `sendToRoom(roomId, message)` | Send text message to room, returns message ID |
+| `listRoomMessage(roomId, startId, endId, maxCount?)` | Get room message history |
+| `getUserInfo(userId)` | Get user profile |
+
+#### Event Listeners
+
+| Method | Callback Parameter | Description |
+|--------|-------------------|-------------|
+| `addListenerForNewMessage(callback)` | `NewMessageNotificationBody` | New message received |
+| `addListenerForNewRoom(callback)` | `RoomInfo` | Joined a new room |
+| `addListenerForMemberJoined(callback)` | `MemberJoinedNotificationBody` | Member joined a room |
+| `addListenerForMemberLeft(callback)` | `MemberLeftNotificationBody` | Member left a room |
+| `addListenerForRoomLeft(callback)` | `RoomLeftNotificationBody` | Self left a room |
+| `onConnected(callback)` | `OnConnectedArgs` | Connection established |
+| `onDisconnected(callback)` | `OnDisconnectedArgs` | Connection lost |
+| `onStopped(callback)` | `OnStoppedArgs` | Connection stopped |
+
+## Examples
+
+See the [examples](./examples) directory for complete working examples.
+
+## License
+
+MIT

sdk/webpubsub-chat-client/examples/live-auction/.yarnrc.yml

@@ -0,0 +1,5 @@
+nodeLinker: node-modules
+
+npmScopes:
+  azure:
+    npmRegistryServer: "https://www.myget.org/F/azure-signalr-dev/npm/"

sdk/webpubsub-chat-client/examples/live-auction/README.md

@@ -0,0 +1,48 @@
+# Live Auction Example
+
+A real-time auction app built with the **Web PubSub Chat SDK**. Bids appear instantly across all participants — every millisecond counts.
+
+## How it works
+
+| Action | SDK API used |
+|---|---|
+| User login | `new ChatClient(url)` → `login()` |
+| Create an auction (invite bidders) | `createRoom(itemName, bidders)` |
+| Broadcast starting price | `sendToRoom(roomId, configJson)` |
+| Receive auction invitation | `addListenerForNewRoom` |
+| Place a bid | `sendToRoom(roomId, bidJson)` — returns message ID as ACK |
+| Real-time bid updates | `addListenerForNewMessage` |
+| Load bid history | `listRoomMessage` |
+| See who joined | `addListenerForMemberJoined` |
+
+## Prerequisites
+
+1. An Azure Web PubSub resource (**PPE portal**, region `CentralUSEUAP` or `EastUS2EUAP`)
+2. Enable **Persistent Storage** (Table) and create a **Chat Hub** with chat feature enabled on the resource
+3. Copy the connection string
+
+## Quick Start
+
+```bash
+# Install dependencies
+yarn install
+
+# Start the server (pass your connection string)
+export WebPubSubConnectionString="<your-connection-string>"
+yarn start
+```
+
+Open `http://localhost:3000` in multiple browser tabs.
+
+## Walkthrough
+
+1. Open **two or more** browser tabs and log in with different usernames (e.g. `alice`, `bob`)
+2. In Alice's tab, create an auction:
+   - Item: `Vintage Watch`
+   - Starting price: `100`
+   - Bidders: `bob`
+3. Bob's tab will instantly show the new auction in "Active Auctions"
+4. Click the auction — the highest bid panel shows the starting price
+5. Bob places a bid of `$150` → Alice sees it update **instantly** (green flash)
+6. Alice outbids with `$200` → Bob sees it in real time
+7. The bid history shows every bid with timestamps, newest first

sdk/webpubsub-chat-client/examples/live-auction/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "live-auction-example",
+  "version": "1.0.0",
+  "description": "Real-time live auction example using Web PubSub Chat SDK",
+  "type": "module",
+  "scripts": {
+    "start": "node server.js"
+  },
+  "author": "Microsoft",
+  "license": "MIT",
+  "dependencies": {
+    "@azure/web-pubsub": "^1.2.0",
+    "@azure/web-pubsub-chat-client": "1.0.0-beta.1",
+    "express": "^5.2.1"
+  }
+}