@feelflow/ffid-sdk 12.0.0 → 12.1.0

package/README.md

@@ -888,6 +888,9 @@ import { createFFIDAnnouncementsClient } from '@feelflow/ffid-sdk/announcements'
 
 // Webhook 署名検証・ハンドラー（※ Node.js crypto が必要）
 import { createFFIDWebhookHandler, verifyWebhookSignature } from '@feelflow/ffid-sdk/webhooks'
+
+// 製品側 DB 用の短命トークン（ES256）
+import { createDbTokenMinter } from '@feelflow/ffid-sdk/server'
 ```
 
 > **Note**: `webhooks` モジュールは Node.js の `crypto` モジュールと `Buffer` を使用します。Cloudflare Workers で利用する場合は [`nodejs_compat` 互換フラグ](https://developers.cloudflare.com/workers/runtime-apis/nodejs/)を有効にしてください。
@@ -940,6 +943,36 @@ module.exports = {
 
 > **Note**: サーバーサイドで bundler を使わずに実行する場合、**subpath exports（`@feelflow/ffid-sdk/legal` 等）を使用すれば** external 設定なしで React がインストールされていなくても動作します。メインエントリ（`@feelflow/ffid-sdk`）を ESM で import する場合は、モジュールグラフが静的に解決されるため React が必要です。
 
+### 製品側 DB 用トークン（createDbTokenMinter）
+
+FFID でログインする製品が、自分の Supabase に supabase-js でアクセスするときの短命トークン（ES256）を作ります（12.1.0 以降）。サーバー専用で、React には依存しません。製品のサーバーが FFID のセッションを確認した後に呼び、RLS は `private.current_ffid_user_id()` から利用者を読みます。
+
+```typescript
+import { createDbTokenMinter } from '@feelflow/ffid-sdk/server'
+
+// プロセスで 1 回
+const minter = createDbTokenMinter({
+  signingKey: process.env.SUPABASE_JWT_SIGNING_KEY?.trim() ?? '', // 私有 JWK（JSON 文字列）
+})
+
+// リクエストごと
+const { token, expiresAt } = await minter.mint({
+  userId: session.user.id,                  // sub（UUID）
+  organizationId: session.organization?.id, // 任意。organization_id claim
+})
+// createClient(url, key, { global: { headers: { Authorization: `Bearer ${token}` } } })
+```
+
+- 設定: `signingKey`（必須。私有 P-256 JWK で `kid` が必要）/ `kid`（任意の上書き）/ `ttlSeconds`（既定 300、上限 900）/ `issuer`（任意）
+- 入力: `userId`、`organizationId`、`claims`（製品固有。`sub` / `role` / `aud` / `iss` / `iat` / `exp` / `nbf` / `jti` / `organization_id` は予約済み）
+- エラー: `FFIDDbTokenError`。`code` は `INVALID_SIGNING_KEY` / `INVALID_TTL` / `INVALID_USER_ID` / `INVALID_ORGANIZATION_ID` / `RESERVED_CLAIM` / `INVALID_CLOCK`。取り込み失敗は message に原因、`cause` に元のエラー（鍵材料は含まれません）
+- `supabase gen signing-key --algorithm ES256` の出力（`use` / `key_ops` / `ext` 付き）をそのまま渡せます。SDK が EC パラメータだけを取り込みます
+- 環境変数は読みません。鍵は設定として渡します。追加の依存はありません
+
+> **Warning**: 私有鍵とトークンは **ブラウザに渡さず、ログにも出さないでください**。鍵が無いときは 503 で止め、service role に黙って切り替えないでください。
+
+鍵の登録手順、RLS の SQL、確認項目は [DB_USER_IDENTITY_STANDARD.md](../../docs/06-reference/DB_USER_IDENTITY_STANDARD.md) を参照してください。
+
 ### `peerDependencies` は optional です
 
 SDK の `package.json` で `react` / `react-dom` は `optional: true` に設定済みです（利用者側での設定は不要）。React をインストールしなくても `npm install` 時に warning は発生しません。

package/dist/agency/index.d.cts

@@ -28,6 +28,13 @@ interface FFIDAgencyLogger {
     error: (...args: unknown[]) => void;
 }
 type FFIDAgencyStatus = 'active' | 'suspended' | 'inactive';
+/**
+ * 代理店の課金方式。
+ *
+ * `'markup'` は非推奨（FFID #6507）。既存データの値として残している。`updateBilling()` は
+ * 互換のため今も `'markup'` を受け付けるが、新しく設定しないこと。受け取った値を網羅的に
+ * 扱う箇所では引き続き `'markup'` を扱うこと。
+ */
 type FFIDAgencyBillingType = 'direct' | 'consolidated' | 'markup';
 type FFIDAgencyMemberRole = 'owner' | 'admin' | 'sales' | 'support';
 type FFIDAgencyMemberStatus = 'active' | 'invited' | 'suspended';
@@ -99,7 +106,9 @@ interface FFIDAgencyOrganization {
     organizationSlug: string;
     billingOverride: FFIDAgencyBillingOverride;
     commissionRate: number | null;
+    /** @deprecated markup 課金方式は非推奨（FFID #6507）。帳票用の既存値を読むだけで、更新する API は無い。 */
     markupRate: number | null;
+    /** @deprecated markup 課金方式は非推奨（FFID #6507）。帳票用の既存値を読むだけで、更新する API は無い。 */
     markupFixed: number | null;
     /** 組織単位の卸割引率 override（%、0〜100）。null = 代理店デフォルトに従う。 */
     wholesaleDiscountRate: number | null;
@@ -192,7 +201,9 @@ interface FFIDAgencyBillingConfig {
     stripeCustomerId: string | null;
     invoiceEmail: string | null;
     paymentTerms: number | null;
+    /** @deprecated markup 課金方式は非推奨（FFID #6507）。帳票用の既存値を読むだけで、更新する API は無い。 */
     defaultMarkupRate: number | null;
+    /** @deprecated markup 課金方式は非推奨（FFID #6507）。帳票用の既存値を読むだけで、更新する API は無い。 */
     defaultMarkupFixed: number | null;
     /** 代理店デフォルト卸割引率（%、0〜100）。null = 未設定（定価請求）。 */
     wholesaleDiscountRate: number | null;
@@ -201,7 +212,15 @@ interface FFIDUpdateAgencyBillingRequest {
     billingType?: FFIDAgencyBillingType;
     invoiceEmail?: string;
     paymentTerms?: number;
+    /**
+     * @deprecated FFID はこの項目を受け付けず、送っても黙って捨てる（FFID #6507）。
+     * markup 課金方式は非推奨で、値を更新する手段は無い。
+     */
     defaultMarkupRate?: number;
+    /**
+     * @deprecated FFID はこの項目を受け付けず、送っても黙って捨てる（FFID #6507）。
+     * markup 課金方式は非推奨で、値を更新する手段は無い。
+     */
     defaultMarkupFixed?: number;
     /** 代理店デフォルト卸割引率（%、0〜100）。null で未設定に戻す。 */
     wholesaleDiscountRate?: number | null;

package/dist/agency/index.d.ts

@@ -28,6 +28,13 @@ interface FFIDAgencyLogger {
     error: (...args: unknown[]) => void;
 }
 type FFIDAgencyStatus = 'active' | 'suspended' | 'inactive';
+/**
+ * 代理店の課金方式。
+ *
+ * `'markup'` は非推奨（FFID #6507）。既存データの値として残している。`updateBilling()` は
+ * 互換のため今も `'markup'` を受け付けるが、新しく設定しないこと。受け取った値を網羅的に
+ * 扱う箇所では引き続き `'markup'` を扱うこと。
+ */
 type FFIDAgencyBillingType = 'direct' | 'consolidated' | 'markup';
 type FFIDAgencyMemberRole = 'owner' | 'admin' | 'sales' | 'support';
 type FFIDAgencyMemberStatus = 'active' | 'invited' | 'suspended';
@@ -99,7 +106,9 @@ interface FFIDAgencyOrganization {
     organizationSlug: string;
     billingOverride: FFIDAgencyBillingOverride;
     commissionRate: number | null;
+    /** @deprecated markup 課金方式は非推奨（FFID #6507）。帳票用の既存値を読むだけで、更新する API は無い。 */
     markupRate: number | null;
+    /** @deprecated markup 課金方式は非推奨（FFID #6507）。帳票用の既存値を読むだけで、更新する API は無い。 */
     markupFixed: number | null;
     /** 組織単位の卸割引率 override（%、0〜100）。null = 代理店デフォルトに従う。 */
     wholesaleDiscountRate: number | null;
@@ -192,7 +201,9 @@ interface FFIDAgencyBillingConfig {
     stripeCustomerId: string | null;
     invoiceEmail: string | null;
     paymentTerms: number | null;
+    /** @deprecated markup 課金方式は非推奨（FFID #6507）。帳票用の既存値を読むだけで、更新する API は無い。 */
     defaultMarkupRate: number | null;
+    /** @deprecated markup 課金方式は非推奨（FFID #6507）。帳票用の既存値を読むだけで、更新する API は無い。 */
     defaultMarkupFixed: number | null;
     /** 代理店デフォルト卸割引率（%、0〜100）。null = 未設定（定価請求）。 */
     wholesaleDiscountRate: number | null;
@@ -201,7 +212,15 @@ interface FFIDUpdateAgencyBillingRequest {
     billingType?: FFIDAgencyBillingType;
     invoiceEmail?: string;
     paymentTerms?: number;
+    /**
+     * @deprecated FFID はこの項目を受け付けず、送っても黙って捨てる（FFID #6507）。
+     * markup 課金方式は非推奨で、値を更新する手段は無い。
+     */
     defaultMarkupRate?: number;
+    /**
+     * @deprecated FFID はこの項目を受け付けず、送っても黙って捨てる（FFID #6507）。
+     * markup 課金方式は非推奨で、値を更新する手段は無い。
+     */
     defaultMarkupFixed?: number;
     /** 代理店デフォルト卸割引率（%、0〜100）。null で未設定に戻す。 */
     wholesaleDiscountRate?: number | null;

package/dist/{chunk-OL7KVPQ4.js → chunk-3MYUVPLD.js}

@@ -577,7 +577,8 @@ function createBillingMethods(deps) {
           subscriptionId: params.subscriptionId,
           successUrl: params.successUrl,
           cancelUrl: params.cancelUrl,
-          ...params.planId ? { planId: params.planId } : {}
+          ...params.planId ? { planId: params.planId } : {},
+          ...params.quantity !== void 0 ? { quantity: params.quantity } : {}
         })
       }
     );
@@ -1390,7 +1391,7 @@ var FFID_ORGANIZATION_PROFILE_ERROR_CODES = {
 };
 
 // src/client/version-check.ts
-var SDK_VERSION = "12.0.0";
+var SDK_VERSION = "12.1.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {
@@ -4077,7 +4078,9 @@ var FFID_SUBSCRIPTION_ERROR_CODES = {
   SUBSCRIPTION_NOT_CANCELABLE: "SUBSCRIPTION_NOT_CANCELABLE",
   SUBSCRIPTION_ALREADY_CANCELED: "SUBSCRIPTION_ALREADY_CANCELED",
   FREE_DOWNGRADE_NOT_ALLOWED: "FREE_DOWNGRADE_NOT_ALLOWED",
-  PAYMENT_METHOD_REQUIRED: "PAYMENT_METHOD_REQUIRED"
+  PAYMENT_METHOD_REQUIRED: "PAYMENT_METHOD_REQUIRED",
+  SEAT_ABOVE_MAX: "SEAT_ABOVE_MAX",
+  SEAT_BELOW_MIN: "SEAT_BELOW_MIN"
 };
 var FFID_CREDITS_ERROR_CODES = {
   CREDITS_INSUFFICIENT: "CREDITS_INSUFFICIENT",

package/dist/{chunk-XRWDTYA7.cjs → chunk-62MINYOA.cjs}

@@ -579,7 +579,8 @@ function createBillingMethods(deps) {
           subscriptionId: params.subscriptionId,
           successUrl: params.successUrl,
           cancelUrl: params.cancelUrl,
-          ...params.planId ? { planId: params.planId } : {}
+          ...params.planId ? { planId: params.planId } : {},
+          ...params.quantity !== void 0 ? { quantity: params.quantity } : {}
         })
       }
     );
@@ -1392,7 +1393,7 @@ var FFID_ORGANIZATION_PROFILE_ERROR_CODES = {
 };
 
 // src/client/version-check.ts
-var SDK_VERSION = "12.0.0";
+var SDK_VERSION = "12.1.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {
@@ -4079,7 +4080,9 @@ var FFID_SUBSCRIPTION_ERROR_CODES = {
   SUBSCRIPTION_NOT_CANCELABLE: "SUBSCRIPTION_NOT_CANCELABLE",
   SUBSCRIPTION_ALREADY_CANCELED: "SUBSCRIPTION_ALREADY_CANCELED",
   FREE_DOWNGRADE_NOT_ALLOWED: "FREE_DOWNGRADE_NOT_ALLOWED",
-  PAYMENT_METHOD_REQUIRED: "PAYMENT_METHOD_REQUIRED"
+  PAYMENT_METHOD_REQUIRED: "PAYMENT_METHOD_REQUIRED",
+  SEAT_ABOVE_MAX: "SEAT_ABOVE_MAX",
+  SEAT_BELOW_MIN: "SEAT_BELOW_MIN"
 };
 var FFID_CREDITS_ERROR_CODES = {
   CREDITS_INSUFFICIENT: "CREDITS_INSUFFICIENT",

package/dist/components/index.cjs

@@ -1,34 +1,34 @@
 'use strict';
 
-var chunkXRWDTYA7_cjs = require('../chunk-XRWDTYA7.cjs');
+var chunk62MINYOA_cjs = require('../chunk-62MINYOA.cjs');
 
 
 
 Object.defineProperty(exports, "FFIDAnnouncementBadge", {
   enumerable: true,
-  get: function () { return chunkXRWDTYA7_cjs.FFIDAnnouncementBadge; }
+  get: function () { return chunk62MINYOA_cjs.FFIDAnnouncementBadge; }
 });
 Object.defineProperty(exports, "FFIDAnnouncementList", {
   enumerable: true,
-  get: function () { return chunkXRWDTYA7_cjs.FFIDAnnouncementList; }
+  get: function () { return chunk62MINYOA_cjs.FFIDAnnouncementList; }
 });
 Object.defineProperty(exports, "FFIDInquiryForm", {
   enumerable: true,
-  get: function () { return chunkXRWDTYA7_cjs.FFIDInquiryForm; }
+  get: function () { return chunk62MINYOA_cjs.FFIDInquiryForm; }
 });
 Object.defineProperty(exports, "FFIDLoginButton", {
   enumerable: true,
-  get: function () { return chunkXRWDTYA7_cjs.FFIDLoginButton; }
+  get: function () { return chunk62MINYOA_cjs.FFIDLoginButton; }
 });
 Object.defineProperty(exports, "FFIDOrganizationSwitcher", {
   enumerable: true,
-  get: function () { return chunkXRWDTYA7_cjs.FFIDOrganizationSwitcher; }
+  get: function () { return chunk62MINYOA_cjs.FFIDOrganizationSwitcher; }
 });
 Object.defineProperty(exports, "FFIDSubscriptionBadge", {
   enumerable: true,
-  get: function () { return chunkXRWDTYA7_cjs.FFIDSubscriptionBadge; }
+  get: function () { return chunk62MINYOA_cjs.FFIDSubscriptionBadge; }
 });
 Object.defineProperty(exports, "FFIDUserMenu", {
   enumerable: true,
-  get: function () { return chunkXRWDTYA7_cjs.FFIDUserMenu; }
+  get: function () { return chunk62MINYOA_cjs.FFIDUserMenu; }
 });

package/dist/components/index.js

@@ -1 +1 @@
-export { FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDInquiryForm, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDSubscriptionBadge, FFIDUserMenu } from '../chunk-OL7KVPQ4.js';
+export { FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDInquiryForm, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDSubscriptionBadge, FFIDUserMenu } from '../chunk-3MYUVPLD.js';

package/dist/{ffid-client-ByfZA9sJ.d.ts → ffid-client-5dVFeHt8.d.ts}

@@ -1164,6 +1164,15 @@ interface FFIDCreateCheckoutParams {
     cancelUrl: string;
     /** Optional plan ID for upgrade or resubscription */
     planId?: string;
+    /**
+     * Seat count after the plan change (#5755). Use together with `planId` (a
+     * different plan); seat-only changes go through the seats API. Omit to carry
+     * over the current seat count. Must fit the target plan's seat range
+     * (fixed-seat plans need their fixed count) and, when decreasing, the seats in
+     * use — otherwise 422 `SEAT_QUANTITY_OUT_OF_RANGE`. Raising the plan while
+     * lowering seats (or vice versa) is 400 `INVALID_UPGRADE_PLAN`.
+     */
+    quantity?: number;
 }
 /**
  * Parameters for creating a billing portal session

package/dist/{ffid-client-DW8_m1_M.d.cts → ffid-client-aUNBn5SW.d.cts}

@@ -1164,6 +1164,15 @@ interface FFIDCreateCheckoutParams {
     cancelUrl: string;
     /** Optional plan ID for upgrade or resubscription */
     planId?: string;
+    /**
+     * Seat count after the plan change (#5755). Use together with `planId` (a
+     * different plan); seat-only changes go through the seats API. Omit to carry
+     * over the current seat count. Must fit the target plan's seat range
+     * (fixed-seat plans need their fixed count) and, when decreasing, the seats in
+     * use — otherwise 422 `SEAT_QUANTITY_OUT_OF_RANGE`. Raising the plan while
+     * lowering seats (or vice versa) is 400 `INVALID_UPGRADE_PLAN`.
+     */
+    quantity?: number;
 }
 /**
  * Parameters for creating a billing portal session