@feelflow/ffid-sdk 4.2.0 → 5.0.0

package/README.md

@@ -322,6 +322,41 @@ if (error || !access?.hasAccess) {
 - `gracePeriodEndsAt`: `past_due_grace` が `blocked` に変わる時刻。表示・警告用であり、アクセス判定の source of truth にしない。
 - `failPolicy`: 現在は `failClosed` 固定。FFID に到達できない、または canonical decision を取得できない場合は `result.error` ではなく `data.hasAccess=false` / `denialReason='ffid_unreachable'` / `data.error` を返す。呼び出し側は `result.error` だけで通過判定しない。
 
+### Organization member management
+
+`organization:read` / `organization:write` scope を持つ service-key または token で、組織メンバーの参照・追加・ロール変更・削除ができます。
+
+```ts
+import { createFFIDClient } from '@feelflow/ffid-sdk/server'
+
+const ffid = createFFIDClient({
+  serviceCode: 'flow-board-ai',
+  scope: '',
+  authMode: 'service-key',
+  serviceApiKey: process.env.FFID_SERVICE_API_KEY!,
+})
+
+const addResult = await ffid.addMember({
+  organizationId,
+  email: 'new-member@example.com',
+  role: 'member',
+})
+
+if (addResult.error) {
+  throw new Error(addResult.error.message)
+}
+
+await ffid.updateMemberRole({
+  organizationId,
+  userId: addResult.data.member.userId,
+  role: 'admin',
+})
+```
+
+- `addMember` は既存 FFID ユーザーを active member として追加します。招待メール送信や token 発行は行いません。
+- `role` は `admin` / `member` / `viewer` のみ指定可能です。`owner` は追加・昇格 API では扱いません。
+- agency client と同じ呼び味が必要な場合は `ffid.addMember(organizationId, { email, role })` も使えます。
+
 ### getProfile() / updateProfile()
 
 ログイン中ユーザー自身のプロフィールを取得・更新するメソッド（`createFFIDClient` から呼び出し）。