SDK API อ้างอิง

                      
                      interface VerifyOptions {
  secret?: string;        // คีย์ลับ HS256 (per-app หรือแบบร่วม) จำเป็นเมื่อตรวจสอบ HS256
  publicKey?: string;     // กุญแจสาธารณะ RS256 PEM จำเป็นเมื่อตรวจสอบ RS256 (แผนงาน)
  audience: string;       // host ของแอปส่วนขยาย ต้องเท่ากับ aud ในโทเค็น (จำเป็น)
  issuer?: string;        // ค่าเริ่มต้น 'gptbots-workspace'
  leewaySeconds?: number; // ผ่อนผันการคลาดเคลื่อนของนาฬิกา (วินาที) ค่าเริ่มต้น 30
  algorithms?: ('HS256' | 'RS256')[]; // ค่าเริ่มต้น ['HS256']
}

interface WorkspaceIdentity {
  accountId: string;                  // = JWT sub
  role: 'OWNER' | 'ADMIN' | 'MEMBER'; // ค่าที่ไม่รู้จักจะถูกทำให้เป็น MEMBER
  workspaceId: string;                // = JWT workspace_id
  username?: string; email?: string; avatar?: string; appName?: string;
  issuedAt?: number;   // = iat (วินาที)
  expiresAt?: number;  // = exp (วินาที)
}

                    

                      
                      interface ExchangeWorkspaceCodeOptions {
  tokenUrl: string;      // endpoint /token ของแพลตฟอร์ม (absolute URL)
  code: string;          // authorization code ใช้ครั้งเดียวที่ได้จาก callback
  codeVerifier: string;  // PKCE verifier ที่ตรงกับ code_challenge
  fetch?: typeof fetch;  // inject fetch ได้ (ทดสอบ/รันไทม์เก่า); ค่าเริ่มต้น fetch ส่วนกลาง
  timeoutMs?: number;    // timeout ของคำขอ ค่าเริ่มต้น 10000; ส่ง 0 เพื่อปิด
}

interface WorkspaceCodeExchangeResult {
  wsa: string;           // wsa ที่ลงลายเซ็นแล้ว ส่งให้ verifyWsa
  tokenType?: string;    // 'Bearer'
  expiresIn?: number;    // อายุ wsa (วินาที)
}

                    

                      
                      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;   // อินเทอร์เฟซตรวจสอบของแบ็กเอนด์แอปส่วนขยาย
  fetch?: typeof fetch;  // inject ได้
  search?: string;       // ค่าเริ่มต้น location.search
  paramName?: string;    // ค่าเริ่มต้น 'wsa'
  strip?: boolean;       // ค่าเริ่มต้น true (ลบเฉพาะเมื่อสำเร็จ)
}

                    

                      
                      interface StartWorkspaceLoginOptions {
  authorizeUrl: string;  // endpoint /authorize ของแพลตฟอร์ม (absolute URL)
  clientId: string;      // app home URL ของแอปส่วนขยาย
  redirectUri: string;   // ที่อยู่ callback, host ต้องอยู่โดเมนเดียวกับ clientId
  state?: string;        // ค่าเริ่มต้นสร้าง CSRF state สุ่ม 16 ไบต์อัตโนมัติ
  workspaceId?: string;  // เลือกพื้นที่ทำงานล่วงหน้า ข้ามหน้าเลือกองค์กร
  storage?: StorageLike; // ค่าเริ่มต้น sessionStorage
  redirect?: (url: string) => void; // ค่าเริ่มต้น location.assign
  navigate?: boolean;    // false = แค่สร้าง URL ไม่เปลี่ยนเส้นทาง (popup/ทดสอบ)
}
interface WorkspaceLoginRequest { url: string; state: string; codeVerifier: string; }

                    

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

                    

                      
                      interface CompleteWorkspaceLoginOptions {
  exchangeUrl: string;   // อินเทอร์เฟซแลกของแบ็กเอนด์คุณเอง
  fetch?: typeof fetch;
  search?: string;       // ค่าเริ่มต้น location.search
  storage?: StorageLike; // ค่าเริ่มต้น sessionStorage
  strip?: boolean;       // ค่าเริ่มต้น true
}

                    

                      
                      unzip workspace-extension-sdk-0.1.0.zip
# ทั้งสองแพ็กเกจ pre-build dist มาแล้ว (main=dist/index.js, types=dist/index.d.ts)
npm i ./workspace-extension-sdk/packages/verify   # แบ็กเอนด์
npm i ./workspace-extension-sdk/packages/browser  # ฟรอนต์เอนด์

                    

                      
                      cd workspace-extension-sdk
npm install
npm run build       # tsc → dist ของแต่ละแพ็กเกจ
npm test            # node --test (ไม่มี dependency ทดสอบภายนอก, ต้อง Node ≥ 22.6 เพื่อรัน .ts ตรง ๆ)
npm run type-check  # tsc --noEmit