@segmentstream-cloud/app 0.17.1 → 0.17.2

package/README.md

@@ -347,16 +347,19 @@ export const { POST } = segmentstream.agent.connectHandler();
 
 `segmentstream.agent` holds:
 
-| Call                   | Does                                                                            |
-| ---------------------- | ------------------------------------------------------------------------------- |
-| `pairing(code)`        | `{ provider, display, expiresAt }`; throws `not_found` or `expired`             |
-| `approvePairing(code)` | Links the account to the signed-in member; returns the `AgentIdentity`          |
-| `identities()`         | The member's own: `{ id, provider, externalId, display, createdAt, revokedAt }` |
-| `revokeIdentity(id)`   | Revokes one of them at once                                                     |
-| `connectHandler()`     | `{ POST }` for the page's form: same-origin only, takes `code`, answers `303`   |
+| Call                   | Does                                                                                   |
+| ---------------------- | -------------------------------------------------------------------------------------- |
+| `pairing(code)`        | `{ provider, display, expiresAt }`; throws `not_found` or `expired`                    |
+| `approvePairing(code)` | Links the account to the signed-in member; returns the `AgentIdentity`                 |
+| `identities()`         | The member's own: `{ id, provider, externalId, display, createdAt, revokedAt }`        |
+| `revokeIdentity(id)`   | Revokes one of them at once                                                            |
+| `connectHandler()`     | `{ POST }` for the page's form: same-origin only; `303` on success; throws on conflict |
 
 The handler sends the browser back to `/agent/connect?connected=<provider>`, or to
-`/agent/connect?expired=1` when the code was used or is older than ten minutes. Other
+`/agent/connect?expired=1` when the code was used or is older than ten minutes. An account already
+connected to another member throws `SegmentStreamApiError` with status `409` and
+`code === "identity_in_use"` through the app's existing error mechanism. The app owns conflict copy.
+Same-member pairing is idempotent, and replacing your own previous account on a provider is supported. Other
 refusals, such as `forbidden` for a member the ontology does not admit, throw
 `SegmentStreamApiError`. All calls are server-only and run as the signed-in member;
 the ontology decides every one. The workspace starter renders the page with Tailwind CSS

package/dist/agent.d.ts

@@ -34,7 +34,8 @@ export interface AgentIdentities {
     readonly pairing: (code: string) => Promise<AgentPairing>;
     /**
      * Links the pairing's chat account to the signed-in member. The ontology decides: it refuses a
-     * used or expired code (`not_found`, `expired`) and a member it does not admit (`forbidden`).
+     * used or expired code (`not_found`, `expired`), a member it does not admit (`forbidden`), or an
+     * account linked to another member (`identity_in_use`, HTTP 409).
      * Server-only.
      */
     readonly approvePairing: (code: string) => Promise<AgentIdentity>;

package/dist/agent.js

@@ -9,6 +9,7 @@ const GONE_CODES = new Set(["not_found", "expired"]);
 const STATUS_CODES = {
     403: "forbidden",
     404: "not_found",
+    409: "identity_in_use",
     410: "expired",
 };
 function pairingPath(code, approve) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@segmentstream-cloud/app",
-  "version": "0.17.1",
+  "version": "0.17.2",
   "description": "Sign-in, users, permissions, the ontology client and warehouse data access for SegmentStream workspace apps built with Next.js.",
   "license": "Apache-2.0",
   "author": "SegmentStream",