Référence de l'API SDK

                      
                      interface VerifyOptions {
  secret?: string;        // clé HS256 (per-app ou partagée). Obligatoire pour vérifier en HS256
  publicKey?: string;     // clé publique PEM RS256. Obligatoire pour vérifier en RS256 (feuille de route)
  audience: string;       // host de l'application d'extension, doit être égal au aud du jeton (obligatoire)
  issuer?: string;        // par défaut 'gptbots-workspace'
  leewaySeconds?: number; // tolérance de dérive d'horloge (secondes), 30 par défaut
  algorithms?: ('HS256' | 'RS256')[]; // par défaut ['HS256']
}

interface WorkspaceIdentity {
  accountId: string;                  // = JWT sub
  role: 'OWNER' | 'ADMIN' | 'MEMBER'; // valeur inconnue normalisée en MEMBER
  workspaceId: string;                // = JWT workspace_id
  username?: string; email?: string; avatar?: string; appName?: string;
  issuedAt?: number;   // = iat (secondes)
  expiresAt?: number;  // = exp (secondes)
}

                    

                      
                      interface ExchangeWorkspaceCodeOptions {
  tokenUrl: string;      // endpoint /token de la plateforme (URL absolue)
  code: string;          // code d'autorisation à usage unique obtenu au callback
  codeVerifier: string;  // verifier PKCE correspondant au code_challenge
  fetch?: typeof fetch;  // fetch injectable (tests/anciens runtimes) ; fetch global par défaut
  timeoutMs?: number;    // timeout de requête, 10000 par défaut ; passez 0 pour désactiver
}

interface WorkspaceCodeExchangeResult {
  wsa: string;           // le wsa signé, à passer à verifyWsa
  tokenType?: string;    // 'Bearer'
  expiresIn?: number;    // durée de validité du wsa (secondes)
}

                    

                      
                      import { verifyWsa, WsaVerificationError } from '@gptbots/workspace-extension-verify';

export function requireWorkspaceIdentity(secret: string, audience: string) {
  return (req, res, next) => {
    try {
      req.identity = verifyWsa(req.body.wsa, { secret, audience });
      next();
    } catch (e) {
      const code = e instanceof WsaVerificationError ? e.code : 'Error';
      res.status(401).json({ code });
    }
  };
}

                    

                      
                      interface ConsumeHandoffOptions {
  exchangeUrl: string;   // l'interface de vérification backend de l'application d'extension
  fetch?: typeof fetch;  // injectable
  search?: string;       // par défaut location.search
  paramName?: string;    // par défaut 'wsa'
  strip?: boolean;       // par défaut true (efface uniquement en cas de succès)
}

                    

                      
                      interface StartWorkspaceLoginOptions {
  authorizeUrl: string;  // endpoint /authorize de la plateforme (URL absolue)
  clientId: string;      // l'app home URL de l'application d'extension
  redirectUri: string;   // adresse de callback, le host doit être du même domaine que clientId
  state?: string;        // par défaut, génère automatiquement un state CSRF aléatoire de 16 octets
  workspaceId?: string;  // espace de travail présélectionné, saute la page de sélection d'organisation
  storage?: StorageLike; // par défaut sessionStorage
  redirect?: (url: string) => void; // par défaut location.assign
  navigate?: boolean;    // false = construit seulement l'URL sans rediriger (popup/tests)
}
interface WorkspaceLoginRequest { url: string; state: string; codeVerifier: string; }

                    

                      
                      interface AuthorizeCallback { code: string; state: string | null; codeVerifier: string; }

                    

                      
                      interface CompleteWorkspaceLoginOptions {
  exchangeUrl: string;   // votre propre interface d'échange backend
  fetch?: typeof fetch;
  search?: string;       // par défaut location.search
  storage?: StorageLike; // par défaut sessionStorage
  strip?: boolean;       // par défaut true
}

                    

                      
                      unzip workspace-extension-sdk-0.1.0.zip
# Les deux paquets ont un dist pré-compilé (main=dist/index.js, types=dist/index.d.ts)
npm i ./workspace-extension-sdk/packages/verify   # backend
npm i ./workspace-extension-sdk/packages/browser  # frontend

                    

                      
                      cd workspace-extension-sdk
npm install
npm run build       # tsc → dist de chaque paquet
npm test            # node --test (aucune dépendance de test externe, nécessite Node ≥ 22.6 pour exécuter directement les .ts)
npm run type-check  # tsc --noEmit