クイックスタート

                      
                      // Node / Express の例
import express from 'express';
import { verifyWsa, WsaVerificationError } from '@gptbots/workspace-extension-verify';

const app = express();
app.use(express.json());

app.post('/session/exchange', (req, res) => {
  try {
    const identity = verifyWsa(req.body.wsa, {
      secret: process.env.EXTENSION_APP_SECRET, // あなたのシークレット（バックエンドのみ）
      audience: 'app.example.com',              // あなたのアプリの host。トークンの aud と一致する必要がある
    });
    // identity = { accountId, role, workspaceId, username?, email?, avatar?, appName?, issuedAt?, expiresAt? }

    const sid = createYourSession(identity);    // 自前の session に置き換える
    res.cookie('sid', sid, { httpOnly: true, secure: true, sameSite: 'lax' });
    res.json(identity);
  } catch (e) {
    const code = e instanceof WsaVerificationError ? e.code : 'Error';
    res.status(401).json({ code });             // 検証失敗は一律拒否
  }
});

                    

                      
                      // あなたのランディングページ
import { consumeHandoff } from '@gptbots/workspace-extension-sdk';

const identity = await consumeHandoff({ exchangeUrl: '/session/exchange' });
// consumeHandoff は順に次を行います：
// 1) 現在の URL の ?wsa= を読み取る
// 2) { wsa } を /session/exchange に POST する（あなたのバックエンドがここで verifyWsa する）
// 3) 成功後、history.replaceState で URL 内の ?wsa= を消去する
// 4) あなたのバックエンドが返した identity を返す

console.log('現在のワークスペースユーザー：', identity.username, identity.role);
if (identity.role === 'MEMBER') hideAdminUI();

                    

                      
                      ワークスペース「拡張」ページ                 GPTBots プラットフォーム       あなたのアプリ
────────────────                         ───────────                ────────
ユーザーがアプリアイコンをクリック ─────────▶ クリックした人がそのワークスペースのメンバーか検証
                                          シークレットで 5 分間有効な wsa (JWT) に署名
https://app.example.com/?wsa=<JWT> を開く ───────────────────────────▶ ランディングページ
                                                                     consumeHandoff()
                                          ◀── POST /session/exchange { wsa } ──
                                                                     あなたのバックエンドが verifyWsa() → identity
                                                                     自前の session を確立
                                                                     URL 内の ?wsa= を消去

                    

                      
                      # 解凍後、2 つのパッケージにはビルド済みの dist が同梱されており、そのままローカル依存として使えます：
unzip workspace-extension-sdk-0.1.0.zip
npm i ./workspace-extension-sdk/packages/verify   # バックエンド
npm i ./workspace-extension-sdk/packages/browser  # フロントエンド