@feelflow/ffid-sdk 12.0.0 → 12.2.0

package/dist/server/index.d.ts

@@ -1,5 +1,5 @@
-import { F as FFIDError, a as FFIDLogger, b as FFIDCacheAdapter, c as FFIDVerifyAccessTokenOptions, d as FFIDApiResponse, e as FFIDOAuthUserInfo, f as FFIDCatalogEnvironment, g as FFIDBillingInterval, h as FFIDTaxBehavior, i as FFIDPublishedCatalog } from '../ffid-client-ByfZA9sJ.js';
-export { j as FFIDAddMemberParams, k as FFIDAddMemberRequest, l as FFIDAddMemberResponse, m as FFIDAllowedLogoMimeType, n as FFIDAssignableMemberRole, o as FFIDCacheConfig, p as FFIDCatalogPublication, q as FFIDCatalogPublicationStatus, r as FFIDClient, s as FFIDCompanySizeCode, t as FFIDConfig, u as FFIDIndustryCode, v as FFIDListMembersResponse, w as FFIDListingConsentInput, x as FFIDLogoWallEntry, y as FFIDLogoWallResponse, z as FFIDMemberRole, A as FFIDMemberSeatAssignmentResult, B as FFIDOrganization, C as FFIDOrganizationLogoUploadResponse, D as FFIDOrganizationMember, E as FFIDOrganizationProfile, G as FFIDOrganizationProfileErrorCode, H as FFIDOrganizationProfileResponse, I as FFIDOtpSendResponse, J as FFIDOtpVerifyResponse, K as FFIDPasswordResetConfirmResponse, L as FFIDPasswordResetResponse, M as FFIDPasswordResetVerifyResponse, N as FFIDProfileCallOptions, O as FFIDProvisionMemberPlan, P as FFIDProvisionMemberPlanStatus, Q as FFIDProvisionMemberResult, R as FFIDProvisionMemberStatus, S as FFIDProvisionOrganizationDryRun, T as FFIDProvisionOrganizationMemberInput, U as FFIDProvisionOrganizationOutcome, V as FFIDProvisionOrganizationParams, W as FFIDProvisionOrganizationResponse, X as FFIDProvisionUserDryRun, Y as FFIDProvisionUserOutcome, Z as FFIDProvisionUserParams, _ as FFIDProvisionUserProfileInput, $ as FFIDProvisionUserResponse, a0 as FFIDProvisionedOrganization, a1 as FFIDProvisionedUser, a2 as FFIDPublishedPlan, a3 as FFIDRemoveMemberResponse, a4 as FFIDResetSessionResponse, a5 as FFIDSubscription, a6 as FFIDUpdateMemberRoleResponse, a7 as FFIDUpdateUserProfileRequest, a8 as FFIDUploadOrganizationLogoParams, a9 as FFIDUpsertOrganizationProfileParams, aa as FFIDUpsertOrganizationProfileRequest, ab as FFIDUser, ac as FFIDUserProfile, ad as FFID_ALLOWED_ORGANIZATION_LOGO_MIME_TYPES, ae as FFID_CATALOG_ENVIRONMENTS, af as FFID_CATALOG_PUBLICATION_STATUSES, ag as FFID_COMPANY_SIZE_CODES, ah as FFID_INDUSTRY_CODES, ai as FFID_MAX_ORGANIZATION_LOGO_FILE_SIZE_BYTES, aj as FFID_MAX_ORGANIZATION_LOGO_FILE_SIZE_MB, ak as FFID_ORGANIZATION_PROFILE_ERROR_CODES, al as TokenData, am as TokenStore, an as createFFIDClient, ao as createTokenStore } from '../ffid-client-ByfZA9sJ.js';
+import { F as FFIDError, a as FFIDLogger, b as FFIDCacheAdapter, c as FFIDVerifyAccessTokenOptions, d as FFIDApiResponse, e as FFIDOAuthUserInfo, f as FFIDCatalogEnvironment, g as FFIDBillingInterval, h as FFIDTaxBehavior, i as FFIDPublishedCatalog } from '../ffid-client-Dr2KVlIZ.js';
+export { j as FFIDAddMemberParams, k as FFIDAddMemberRequest, l as FFIDAddMemberResponse, m as FFIDAllowedLogoMimeType, n as FFIDAssignableMemberRole, o as FFIDCacheConfig, p as FFIDCatalogPublication, q as FFIDCatalogPublicationStatus, r as FFIDClient, s as FFIDCompanySizeCode, t as FFIDConfig, u as FFIDIndustryCode, v as FFIDListMembersResponse, w as FFIDListingConsentInput, x as FFIDLogoWallEntry, y as FFIDLogoWallResponse, z as FFIDMemberRole, A as FFIDMemberSeatAssignmentResult, B as FFIDOrganization, C as FFIDOrganizationLogoUploadResponse, D as FFIDOrganizationMember, E as FFIDOrganizationProfile, G as FFIDOrganizationProfileErrorCode, H as FFIDOrganizationProfileResponse, I as FFIDOtpSendResponse, J as FFIDOtpVerifyResponse, K as FFIDPasswordResetConfirmResponse, L as FFIDPasswordResetResponse, M as FFIDPasswordResetVerifyResponse, N as FFIDProfileCallOptions, O as FFIDProvisionMemberPlan, P as FFIDProvisionMemberPlanStatus, Q as FFIDProvisionMemberResult, R as FFIDProvisionMemberStatus, S as FFIDProvisionOrganizationDryRun, T as FFIDProvisionOrganizationMemberInput, U as FFIDProvisionOrganizationOutcome, V as FFIDProvisionOrganizationParams, W as FFIDProvisionOrganizationResponse, X as FFIDProvisionUserDryRun, Y as FFIDProvisionUserOutcome, Z as FFIDProvisionUserParams, _ as FFIDProvisionUserProfileInput, $ as FFIDProvisionUserResponse, a0 as FFIDProvisionedOrganization, a1 as FFIDProvisionedUser, a2 as FFIDPublishedPlan, a3 as FFIDRemoveMemberResponse, a4 as FFIDResetSessionResponse, a5 as FFIDSubscription, a6 as FFIDUpdateMemberRoleResponse, a7 as FFIDUpdateUserProfileRequest, a8 as FFIDUploadOrganizationLogoParams, a9 as FFIDUpsertOrganizationProfileParams, aa as FFIDUpsertOrganizationProfileRequest, ab as FFIDUser, ac as FFIDUserProfile, ad as FFID_ALLOWED_ORGANIZATION_LOGO_MIME_TYPES, ae as FFID_CATALOG_ENVIRONMENTS, af as FFID_CATALOG_PUBLICATION_STATUSES, ag as FFID_COMPANY_SIZE_CODES, ah as FFID_INDUSTRY_CODES, ai as FFID_MAX_ORGANIZATION_LOGO_FILE_SIZE_BYTES, aj as FFID_MAX_ORGANIZATION_LOGO_FILE_SIZE_MB, ak as FFID_ORGANIZATION_PROFILE_ERROR_CODES, al as TokenData, am as TokenStore, an as createFFIDClient, ao as createTokenStore } from '../ffid-client-Dr2KVlIZ.js';
 export { D as DEFAULT_API_BASE_URL, a as DEFAULT_OAUTH_SCOPES } from '../constants-Ce2eXQtB.js';
 import { z } from 'zod';
 import '../types-Cjb9J0rL.js';
@@ -649,4 +649,147 @@ declare function computeScopeHash(input: FFIDScopeHashInput): Promise<string>;
  */
 declare function validatePublishedCatalog(catalog: unknown): asserts catalog is FFIDPublishedCatalog;
 
-export { ALL_DENIED_EXCEPT_NECESSARY, type BuildAuthorizeUrlOptions, type BuildAuthorizeUrlResult, CATALOG_HASH_PATTERN, CONSENT_COOKIE_NAME, COOKIE_VERSION, type CookieOptions, type FFIDAuthorizationError, type FFIDAuthorizationErrorDetails, FFIDCacheAdapter, type FFIDCanonicalJsonValue, FFIDCatalogEnvironment, FFIDCatalogHashError, type FFIDConsentCategories, type FFIDConsentCategoryCode, type FFIDCookieStoreLike, type FFIDErrorCode, type FFIDOAuthDenialReason, FFIDOAuthUserInfo, type FFIDPaymentConfiguration, FFIDPublishedCatalog, type FFIDScopeHashInput, type FFIDScopeHashPlan, FFIDTaxBehavior, type FFIDTaxConfiguration, FFIDVerifyAccessTokenOptions, FFID_ERROR_CODES, FFID_OAUTH_DENIAL_REASONS, FFID_SESSION_COOKIE_NAME, type HandleCallbackInput, type KVNamespaceLike, type ServerAuthClient, type ServerAuthConfig, type ServerSessionTokens, type ServerTokenResult, canonicalizeCatalogValue, computeFFIDCheckoutCopyHash, computeLegalDisclosureHash, computePaymentConfigurationHash, computePraxisCopyHash, computeScopeHash, computeTaxConfigurationHash, createKVCacheAdapter, createMemoryCacheAdapter, createServerAuthClient, createVerifyAccessToken, decodeConsentCookie, encodeConsentCookie, generateServerState, getFFIDAuthorizationError, getFFIDConsentFromCookieHeader, getFFIDConsentFromCookies, hashCanonicalJson, isFFIDOAuthDenialReason, sessionCookies, sha256Hex, validatePublishedCatalog };
+/**
+ * Constants for the product-side DB token minter (#6318).
+ *
+ * A product that reaches its own Supabase through supabase-js (PostgREST)
+ * mints a short-lived token for the FFID user on its server and sends it as
+ * the `Authorization: Bearer` header. Supabase validates it against the
+ * product's JWT Signing Keys and RLS reads the user from `auth.jwt()`.
+ */
+/** Only asymmetric signing is allowed; a shared secret (HS256) is rejected by policy. */
+declare const FFID_DB_TOKEN_ALGORITHM: "ES256";
+/** Supabase maps this claim to the Postgres role the request runs as. */
+declare const FFID_DB_TOKEN_ROLE: "authenticated";
+/** Same shape as the user tokens Supabase Auth issues (`aud` = `authenticated`). */
+declare const FFID_DB_TOKEN_AUDIENCE: "authenticated";
+/** Default lifetime: 5 minutes. The token is minted per request and never sent to the browser. */
+declare const DEFAULT_DB_TOKEN_TTL_SECONDS = 300;
+/** Hard ceiling: 15 minutes. Longer tokens defeat the "mint per request" model. */
+declare const MAX_DB_TOKEN_TTL_SECONDS = 900;
+/** Claim that carries the FFID organization id when the product scopes rows by organization. */
+declare const FFID_DB_TOKEN_ORGANIZATION_CLAIM: "organization_id";
+/**
+ * Claims the minter owns. Product-specific `claims` must not use these names,
+ * so a caller cannot forge a different user, role, or lifetime.
+ */
+declare const FFID_DB_TOKEN_RESERVED_CLAIMS: readonly ["sub", "role", "aud", "iss", "iat", "exp", "nbf", "jti", "organization_id"];
+
+/**
+ * Types for the product-side DB token minter (#6318).
+ */
+
+/**
+ * Private P-256 JWK used to sign DB tokens. Generate it with
+ * `supabase gen signing-key --algorithm ES256`, import that private JWK into the
+ * product's Supabase JWT Signing Keys (Supabase keeps it non-extractable and
+ * publishes only the public half via JWKS), and keep the same JWK in a server
+ * environment variable. Nothing else may hold it.
+ *
+ * The CLI output also carries `use`, `key_ops` and `ext`; the minter strips
+ * those before import (WebCrypto rejects an ECDSA private key whose `key_ops`
+ * includes `verify`).
+ */
+interface FFIDDbTokenSigningJwk {
+    kty: 'EC';
+    crv: 'P-256';
+    /** Private scalar. Its presence is what makes this a signing key. */
+    d: string;
+    x: string;
+    y: string;
+    /** Key id. Supabase matches the token header `kid` against the imported key. */
+    kid?: string;
+    alg?: string;
+    use?: string;
+    [parameter: string]: unknown;
+}
+interface FFIDDbTokenMinterConfig {
+    /**
+     * The private JWK, either as an object or as the JSON string stored in an
+     * environment variable (for example `SUPABASE_JWT_SIGNING_KEY`).
+     */
+    signingKey: string | FFIDDbTokenSigningJwk;
+    /** Overrides the JWK's `kid`. Required when the JWK has none. */
+    kid?: string;
+    /** Token lifetime. Default `DEFAULT_DB_TOKEN_TTL_SECONDS`, max `MAX_DB_TOKEN_TTL_SECONDS`. */
+    ttlSeconds?: number;
+    /** Optional `iss` claim. Supabase does not require it; set it when the product's policies read it. */
+    issuer?: string;
+}
+interface FFIDMintDbTokenInput {
+    /** FFID user id (UUID). Becomes `sub`, the value `private.current_ffid_user_id()` returns. */
+    userId: string;
+    /** FFID organization id (UUID). Becomes the `organization_id` claim. `null` means "none", like `FFIDUser.organizationId`. */
+    organizationId?: string | null;
+    /** Product-specific claims. Reserved names (`FFID_DB_TOKEN_RESERVED_CLAIMS`) are rejected. */
+    claims?: Record<string, unknown>;
+    /** Clock override for tests. Defaults to `new Date()`. An Invalid Date is rejected (`INVALID_CLOCK`). */
+    now?: Date;
+}
+interface FFIDDbTokenClaims {
+    sub: string;
+    role: typeof FFID_DB_TOKEN_ROLE;
+    aud: typeof FFID_DB_TOKEN_AUDIENCE;
+    iat: number;
+    exp: number;
+    iss?: string;
+    organization_id?: string;
+    [claim: string]: unknown;
+}
+interface FFIDDbToken {
+    /** Compact JWS to send as `Authorization: Bearer <token>` to the product's Supabase. */
+    token: string;
+    /** `exp` as a `Date`. For logging / diagnostics; the client is still created per request. */
+    expiresAt: Date;
+    /** The signed payload, for logging claim names (never log the token itself). */
+    claims: FFIDDbTokenClaims;
+}
+interface FFIDDbTokenMinter {
+    /** Key id written to every token header. */
+    readonly kid: string;
+    /** Effective lifetime in seconds. */
+    readonly ttlSeconds: number;
+    mint(input: FFIDMintDbTokenInput): Promise<FFIDDbToken>;
+}
+
+/**
+ * Creates a minter bound to one signing key. Create it once per process and
+ * call `mint()` per request.
+ *
+ * The key shape is checked synchronously here. The key material is imported on
+ * the first `mint()`; a successful import is kept for the minter's lifetime,
+ * a failed one is retried on the next `mint()`.
+ *
+ * @throws FFIDDbTokenError when the key shape or TTL is invalid.
+ */
+declare function createDbTokenMinter(config: FFIDDbTokenMinterConfig): FFIDDbTokenMinter;
+
+/**
+ * Errors thrown by the product-side DB token minter (#6318).
+ *
+ * These are programming / configuration errors on the product's server, never
+ * end-user input errors. Messages never include key material.
+ */
+declare const FFID_DB_TOKEN_ERROR_CODES: {
+    /** Signing key is not a private P-256 JWK with a `kid`, or cannot be imported. */
+    readonly INVALID_SIGNING_KEY: "INVALID_SIGNING_KEY";
+    /** `ttlSeconds` is not a positive integer within `MAX_DB_TOKEN_TTL_SECONDS`. */
+    readonly INVALID_TTL: "INVALID_TTL";
+    /** `userId` is not a UUID. */
+    readonly INVALID_USER_ID: "INVALID_USER_ID";
+    /** `organizationId` is not a UUID. */
+    readonly INVALID_ORGANIZATION_ID: "INVALID_ORGANIZATION_ID";
+    /** A product claim uses a name the minter reserves (`sub`, `role`, `exp`, ...). */
+    readonly RESERVED_CLAIM: "RESERVED_CLAIM";
+    /** `now` is not a valid `Date` (an Invalid Date would sign `iat` / `exp` as null). */
+    readonly INVALID_CLOCK: "INVALID_CLOCK";
+};
+type FFIDDbTokenErrorCode = (typeof FFID_DB_TOKEN_ERROR_CODES)[keyof typeof FFID_DB_TOKEN_ERROR_CODES];
+declare class FFIDDbTokenError extends Error {
+    readonly code: FFIDDbTokenErrorCode;
+    constructor(code: FFIDDbTokenErrorCode, message: string, options?: {
+        cause?: unknown;
+    });
+}
+
+export { ALL_DENIED_EXCEPT_NECESSARY, type BuildAuthorizeUrlOptions, type BuildAuthorizeUrlResult, CATALOG_HASH_PATTERN, CONSENT_COOKIE_NAME, COOKIE_VERSION, type CookieOptions, DEFAULT_DB_TOKEN_TTL_SECONDS, type FFIDAuthorizationError, type FFIDAuthorizationErrorDetails, FFIDCacheAdapter, type FFIDCanonicalJsonValue, FFIDCatalogEnvironment, FFIDCatalogHashError, type FFIDConsentCategories, type FFIDConsentCategoryCode, type FFIDCookieStoreLike, type FFIDDbToken, type FFIDDbTokenClaims, FFIDDbTokenError, type FFIDDbTokenErrorCode, type FFIDDbTokenMinter, type FFIDDbTokenMinterConfig, type FFIDDbTokenSigningJwk, type FFIDErrorCode, type FFIDMintDbTokenInput, type FFIDOAuthDenialReason, FFIDOAuthUserInfo, type FFIDPaymentConfiguration, FFIDPublishedCatalog, type FFIDScopeHashInput, type FFIDScopeHashPlan, FFIDTaxBehavior, type FFIDTaxConfiguration, FFIDVerifyAccessTokenOptions, FFID_DB_TOKEN_ALGORITHM, FFID_DB_TOKEN_AUDIENCE, FFID_DB_TOKEN_ERROR_CODES, FFID_DB_TOKEN_ORGANIZATION_CLAIM, FFID_DB_TOKEN_RESERVED_CLAIMS, FFID_DB_TOKEN_ROLE, FFID_ERROR_CODES, FFID_OAUTH_DENIAL_REASONS, FFID_SESSION_COOKIE_NAME, type HandleCallbackInput, type KVNamespaceLike, MAX_DB_TOKEN_TTL_SECONDS, type ServerAuthClient, type ServerAuthConfig, type ServerSessionTokens, type ServerTokenResult, canonicalizeCatalogValue, computeFFIDCheckoutCopyHash, computeLegalDisclosureHash, computePaymentConfigurationHash, computePraxisCopyHash, computeScopeHash, computeTaxConfigurationHash, createDbTokenMinter, createKVCacheAdapter, createMemoryCacheAdapter, createServerAuthClient, createVerifyAccessToken, decodeConsentCookie, encodeConsentCookie, generateServerState, getFFIDAuthorizationError, getFFIDConsentFromCookieHeader, getFFIDConsentFromCookies, hashCanonicalJson, isFFIDOAuthDenialReason, sessionCookies, sha256Hex, validatePublishedCatalog };

package/dist/server/index.js

@@ -1,6 +1,7 @@
 import { DEFAULT_API_BASE_URL } from '../chunk-JEVK2XUM.js';
 export { DEFAULT_API_BASE_URL, DEFAULT_OAUTH_SCOPES } from '../chunk-JEVK2XUM.js';
-import { createRemoteJWKSet, jwtVerify, errors } from 'jose';
+import { SignJWT, importJWK, jwtVerify, createRemoteJWKSet, errors } from 'jose';
+import { z } from 'zod';
 
 // src/auth/token-store.ts
 var STORAGE_KEY = "ffid_tokens";
@@ -309,13 +310,13 @@ var HTTP_SERVER_ERROR_MIN = 500;
 var HTTP_SERVER_ERROR_LIMIT = 600;
 function createVerifyAccessToken(deps) {
   const { authMode, baseUrl, serviceCode, serviceApiKey, verifyStrategy, logger, createError, errorCodes, cache, timeout } = deps;
-  let jwtVerify2 = null;
+  let jwtVerify3 = null;
   let cacheReadFailureEscalated = false;
   let cacheWriteFailureEscalated = false;
   let missingSubtleCryptoLogged = false;
   function getJwtVerifier() {
-    if (!jwtVerify2) {
-      jwtVerify2 = createJwtVerifier({
+    if (!jwtVerify3) {
+      jwtVerify3 = createJwtVerifier({
         baseUrl,
         serviceCode,
         logger,
@@ -325,7 +326,7 @@ function createVerifyAccessToken(deps) {
         errorCodes
       });
     }
-    return jwtVerify2;
+    return jwtVerify3;
   }
   async function verifyAccessToken(accessToken, options) {
     if (authMode !== "service-key") {
@@ -573,7 +574,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 } : {}
         })
       }
     );
@@ -1386,7 +1388,7 @@ var FFID_ORGANIZATION_PROFILE_ERROR_CODES = {
 };
 
 // src/client/version-check.ts
-var SDK_VERSION = "12.0.0";
+var SDK_VERSION = "12.2.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {
@@ -3335,24 +3337,44 @@ function createContractWizardMethods(deps) {
   };
 }
 
+// src/newsletter/types.ts
+var FFID_NEWSLETTER_TYPES = ["inquiry_followup", "general"];
+
 // src/newsletter/ffid-newsletter-client.ts
 var EXT_SUBSCRIBE_ENDPOINT2 = "/api/v1/ext/newsletter/subscribe";
 var CONFIRM_ENDPOINT = "/api/newsletter/confirm";
 var UNSUBSCRIBE_ENDPOINT = "/api/newsletter/unsubscribe";
 var DISPATCH_ENDPOINT = "/api/v1/newsletter/dispatch";
+var PUBLIC_TOKEN_TIMEOUT_MS = 3e4;
+var subscribeResponseSchema = z.object({
+  ok: z.literal(true),
+  requiresConfirmation: z.boolean(),
+  requiresSignIn: z.boolean(),
+  confirmationEmailPending: z.boolean(),
+  requestId: z.uuid().optional()
+}).refine(
+  (value) => [
+    value.requiresConfirmation,
+    value.requiresSignIn,
+    value.confirmationEmailPending
+  ].filter(Boolean).length <= 1
+);
 function trimOrEmpty(s) {
   return typeof s === "string" ? s.trim() : "";
 }
 async function postPublic(url, init, opts) {
   let response;
   try {
-    response = await fetch(url, init);
-  } catch (err) {
+    response = await fetch(url, {
+      ...init,
+      credentials: "omit",
+      redirect: "error",
+      cache: "no-store",
+      signal: AbortSignal.timeout(PUBLIC_TOKEN_TIMEOUT_MS)
+    });
+  } catch {
     return {
-      error: opts.createError(
-        "NETWORK_ERROR",
-        err instanceof Error ? err.message : "\u30CD\u30C3\u30C8\u30EF\u30FC\u30AF\u30A8\u30E9\u30FC\u304C\u767A\u751F\u3057\u307E\u3057\u305F"
-      )
+      error: opts.createError("NETWORK_ERROR", opts.fallbackMessage)
     };
   }
   if (!response.ok) {
@@ -3379,7 +3401,7 @@ async function postPublic(url, init, opts) {
 }
 function createNewsletterMethods(deps) {
   const { fetchWithAuth, baseUrl, createError } = deps;
-  async function subscribe(params) {
+  async function subscribe(params, options = {}) {
     const email = trimOrEmpty(params.email);
     const source = trimOrEmpty(params.source);
     if (!email) {
@@ -3396,10 +3418,19 @@ function createNewsletterMethods(deps) {
         )
       };
     }
-    return fetchWithAuth(
+    if (options.idempotencyKey !== void 0 && !z.uuid().safeParse(options.idempotencyKey).success) {
+      return {
+        error: createError(
+          "INVALID_IDEMPOTENCY_KEY",
+          "idempotencyKey \u306B\u306F UUID \u3092\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044"
+        )
+      };
+    }
+    const response = await fetchWithAuth(
       EXT_SUBSCRIBE_ENDPOINT2,
       {
         method: "POST",
+        ...options.idempotencyKey ? { headers: { "Idempotency-Key": options.idempotencyKey } } : {},
         body: JSON.stringify({
           email,
           types: params.types,
@@ -3408,6 +3439,23 @@ function createNewsletterMethods(deps) {
         })
       }
     );
+    if (response.error) return response;
+    const parsed = subscribeResponseSchema.safeParse(response.data);
+    if (!parsed.success)
+      return {
+        error: createError(
+          "PARSE_ERROR",
+          "\u30CB\u30E5\u30FC\u30B9\u30EC\u30BF\u30FC\u767B\u9332\u306E\u5FDC\u7B54\u3092\u78BA\u8A8D\u3067\u304D\u307E\u305B\u3093\u3067\u3057\u305F"
+        )
+      };
+    if (options.idempotencyKey && parsed.data.requestId !== options.idempotencyKey)
+      return {
+        error: createError(
+          "PARSE_ERROR",
+          "\u30CB\u30E5\u30FC\u30B9\u30EC\u30BF\u30FC\u767B\u9332\u306E\u30EA\u30AF\u30A8\u30B9\u30C8\u8B58\u5225\u5B50\u3092\u78BA\u8A8D\u3067\u304D\u307E\u305B\u3093\u3067\u3057\u305F"
+        )
+      };
+    return { data: parsed.data };
   }
   async function confirm(params) {
     const token = trimOrEmpty(params.token);
@@ -3435,6 +3483,16 @@ function createNewsletterMethods(deps) {
     }
     const url = new URL(`${baseUrl}${UNSUBSCRIBE_ENDPOINT}`);
     url.searchParams.set("token", token);
+    if (params.type !== void 0) {
+      if (!FFID_NEWSLETTER_TYPES.includes(params.type))
+        return {
+          error: createError(
+            "VALIDATION_ERROR",
+            "\u30CB\u30E5\u30FC\u30B9\u30EC\u30BF\u30FC\u306E\u914D\u4FE1\u7A2E\u5225\u304C\u4E0D\u6B63\u3067\u3059"
+          )
+        };
+      url.searchParams.set("type", params.type);
+    }
     return postPublic(
       url.toString(),
       { method: "POST" },
@@ -4864,4 +4922,184 @@ function clear(opts = {}) {
 }
 var sessionCookies = { serialize, read, clear };
 
-export { ALL_DENIED_EXCEPT_NECESSARY, CATALOG_HASH_PATTERN, CONSENT_COOKIE_NAME, COOKIE_VERSION, FFIDCatalogHashError, FFID_ALLOWED_ORGANIZATION_LOGO_MIME_TYPES, FFID_CATALOG_ENVIRONMENTS, FFID_CATALOG_PUBLICATION_STATUSES, FFID_COMPANY_SIZE_CODES, FFID_ERROR_CODES, FFID_INDUSTRY_CODES, FFID_MAX_ORGANIZATION_LOGO_FILE_SIZE_BYTES, FFID_MAX_ORGANIZATION_LOGO_FILE_SIZE_MB, FFID_OAUTH_DENIAL_REASONS, FFID_ORGANIZATION_PROFILE_ERROR_CODES, FFID_SESSION_COOKIE_NAME, canonicalizeCatalogValue, computeFFIDCheckoutCopyHash, computeLegalDisclosureHash, computePaymentConfigurationHash, computePraxisCopyHash, computeScopeHash, computeTaxConfigurationHash, createFFIDClient, createKVCacheAdapter, createMemoryCacheAdapter, createServerAuthClient, createTokenStore, createVerifyAccessToken, decodeConsentCookie, encodeConsentCookie, generateServerState, getFFIDAuthorizationError, getFFIDConsentFromCookieHeader, getFFIDConsentFromCookies, hashCanonicalJson, isFFIDOAuthDenialReason, sessionCookies, sha256Hex, validatePublishedCatalog };
+// src/server/db-token/constants.ts
+var FFID_DB_TOKEN_ALGORITHM = "ES256";
+var FFID_DB_TOKEN_ROLE = "authenticated";
+var FFID_DB_TOKEN_AUDIENCE = "authenticated";
+var DEFAULT_DB_TOKEN_TTL_SECONDS = 300;
+var MAX_DB_TOKEN_TTL_SECONDS = 900;
+var FFID_DB_TOKEN_ORGANIZATION_CLAIM = "organization_id";
+var FFID_DB_TOKEN_RESERVED_CLAIMS = [
+  "sub",
+  "role",
+  "aud",
+  "iss",
+  "iat",
+  "exp",
+  "nbf",
+  "jti",
+  FFID_DB_TOKEN_ORGANIZATION_CLAIM
+];
+var MILLISECONDS_PER_SECOND = 1e3;
+
+// src/server/db-token/errors.ts
+var FFID_DB_TOKEN_ERROR_CODES = {
+  /** Signing key is not a private P-256 JWK with a `kid`, or cannot be imported. */
+  INVALID_SIGNING_KEY: "INVALID_SIGNING_KEY",
+  /** `ttlSeconds` is not a positive integer within `MAX_DB_TOKEN_TTL_SECONDS`. */
+  INVALID_TTL: "INVALID_TTL",
+  /** `userId` is not a UUID. */
+  INVALID_USER_ID: "INVALID_USER_ID",
+  /** `organizationId` is not a UUID. */
+  INVALID_ORGANIZATION_ID: "INVALID_ORGANIZATION_ID",
+  /** A product claim uses a name the minter reserves (`sub`, `role`, `exp`, ...). */
+  RESERVED_CLAIM: "RESERVED_CLAIM",
+  /** `now` is not a valid `Date` (an Invalid Date would sign `iat` / `exp` as null). */
+  INVALID_CLOCK: "INVALID_CLOCK"
+};
+var FFIDDbTokenError = class extends Error {
+  code;
+  constructor(code, message, options) {
+    super(message, options);
+    this.name = "FFIDDbTokenError";
+    this.code = code;
+  }
+};
+
+// src/server/db-token/mint.ts
+var UUID_PATTERN2 = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+var RESERVED_CLAIM_SET = new Set(FFID_DB_TOKEN_RESERVED_CLAIMS);
+var isNonEmptyString = (value) => typeof value === "string" && value.length > 0;
+var invalidKey = (reason, cause) => new FFIDDbTokenError(
+  FFID_DB_TOKEN_ERROR_CODES.INVALID_SIGNING_KEY,
+  `Invalid DB token signing key: ${reason}`,
+  cause === void 0 ? void 0 : { cause }
+);
+var describeCause = (cause) => cause instanceof Error ? `${cause.name}: ${cause.message}` : String(cause);
+function parseSigningKey(signingKey, kidOverride) {
+  let candidate = signingKey;
+  if (typeof signingKey === "string") {
+    if (signingKey.trim().length === 0) {
+      throw invalidKey("signingKey is empty (is the environment variable set?)");
+    }
+    try {
+      candidate = JSON.parse(signingKey);
+    } catch {
+      throw invalidKey("not valid JSON");
+    }
+  }
+  if (typeof candidate !== "object" || candidate === null || Array.isArray(candidate)) {
+    throw invalidKey("expected a JWK object");
+  }
+  const jwk = candidate;
+  if (jwk.kty !== "EC" || jwk.crv !== "P-256") {
+    throw invalidKey(`expected kty=EC crv=P-256 for ${FFID_DB_TOKEN_ALGORITHM}`);
+  }
+  if (!isNonEmptyString(jwk.d) || !isNonEmptyString(jwk.x) || !isNonEmptyString(jwk.y)) {
+    throw invalidKey("expected a private key (d, x, y)");
+  }
+  const kid = kidOverride ?? jwk.kid;
+  if (!isNonEmptyString(kid)) {
+    throw invalidKey("kid is required (Supabase matches the header kid against the imported key)");
+  }
+  return { jwk, kid };
+}
+function resolveTtlSeconds(ttlSeconds) {
+  const ttl = ttlSeconds ?? DEFAULT_DB_TOKEN_TTL_SECONDS;
+  if (!Number.isInteger(ttl) || ttl < 1 || ttl > MAX_DB_TOKEN_TTL_SECONDS) {
+    throw new FFIDDbTokenError(
+      FFID_DB_TOKEN_ERROR_CODES.INVALID_TTL,
+      `ttlSeconds must be an integer between 1 and ${MAX_DB_TOKEN_TTL_SECONDS}`
+    );
+  }
+  return ttl;
+}
+function requireUuid(value, code, label) {
+  if (typeof value !== "string" || !UUID_PATTERN2.test(value)) {
+    throw new FFIDDbTokenError(FFID_DB_TOKEN_ERROR_CODES[code], `${label} must be a UUID`);
+  }
+  return value.toLowerCase();
+}
+function resolveNow(now) {
+  if (now === void 0) return /* @__PURE__ */ new Date();
+  if (!(now instanceof Date) || Number.isNaN(now.getTime())) {
+    throw new FFIDDbTokenError(FFID_DB_TOKEN_ERROR_CODES.INVALID_CLOCK, "now must be a valid Date");
+  }
+  return now;
+}
+function assertNoReservedClaims(claims) {
+  if (!claims) return;
+  for (const name of Object.keys(claims)) {
+    if (RESERVED_CLAIM_SET.has(name)) {
+      throw new FFIDDbTokenError(
+        FFID_DB_TOKEN_ERROR_CODES.RESERVED_CLAIM,
+        `Claim "${name}" is reserved by the DB token minter`
+      );
+    }
+  }
+}
+async function importSigningKey(jwk, kid) {
+  const ecParameters = { kty: jwk.kty, crv: jwk.crv, x: jwk.x, y: jwk.y };
+  let privateKey;
+  let publicKey;
+  try {
+    const imported = await Promise.all([
+      importJWK({ ...ecParameters, d: jwk.d, kid, alg: FFID_DB_TOKEN_ALGORITHM }, FFID_DB_TOKEN_ALGORITHM),
+      importJWK({ ...ecParameters, kid, alg: FFID_DB_TOKEN_ALGORITHM }, FFID_DB_TOKEN_ALGORITHM)
+    ]);
+    if (imported[0] instanceof Uint8Array || imported[1] instanceof Uint8Array) {
+      throw new Error("expected an asymmetric key");
+    }
+    ;
+    [privateKey, publicKey] = imported;
+  } catch (cause) {
+    throw invalidKey(`key material could not be imported (${describeCause(cause)})`, cause);
+  }
+  try {
+    const probe = await new SignJWT({}).setProtectedHeader({ alg: FFID_DB_TOKEN_ALGORITHM, kid }).sign(privateKey);
+    await jwtVerify(probe, publicKey);
+  } catch (cause) {
+    throw invalidKey("private part (d) does not match the public part (x, y)", cause);
+  }
+  return privateKey;
+}
+function createDbTokenMinter(config) {
+  const { jwk, kid } = parseSigningKey(config.signingKey, config.kid);
+  const ttlSeconds = resolveTtlSeconds(config.ttlSeconds);
+  const issuer = config.issuer;
+  let keyPromise;
+  const loadKey = () => {
+    keyPromise ??= importSigningKey(jwk, kid).catch((error) => {
+      keyPromise = void 0;
+      throw error;
+    });
+    return keyPromise;
+  };
+  return {
+    kid,
+    ttlSeconds,
+    async mint(input) {
+      const sub = requireUuid(input.userId, "INVALID_USER_ID", "userId");
+      const organizationId = input.organizationId === void 0 || input.organizationId === null ? void 0 : requireUuid(input.organizationId, "INVALID_ORGANIZATION_ID", "organizationId");
+      assertNoReservedClaims(input.claims);
+      const now = resolveNow(input.now);
+      const iat = Math.floor(now.getTime() / MILLISECONDS_PER_SECOND);
+      const exp = iat + ttlSeconds;
+      const claims = {
+        ...input.claims,
+        sub,
+        role: FFID_DB_TOKEN_ROLE,
+        aud: FFID_DB_TOKEN_AUDIENCE,
+        iat,
+        exp,
+        ...issuer === void 0 ? {} : { iss: issuer },
+        ...organizationId === void 0 ? {} : { [FFID_DB_TOKEN_ORGANIZATION_CLAIM]: organizationId }
+      };
+      const key = await loadKey();
+      const token = await new SignJWT(claims).setProtectedHeader({ alg: FFID_DB_TOKEN_ALGORITHM, kid, typ: "JWT" }).sign(key);
+      return { token, expiresAt: new Date(exp * MILLISECONDS_PER_SECOND), claims };
+    }
+  };
+}
+
+export { ALL_DENIED_EXCEPT_NECESSARY, CATALOG_HASH_PATTERN, CONSENT_COOKIE_NAME, COOKIE_VERSION, DEFAULT_DB_TOKEN_TTL_SECONDS, FFIDCatalogHashError, FFIDDbTokenError, FFID_ALLOWED_ORGANIZATION_LOGO_MIME_TYPES, FFID_CATALOG_ENVIRONMENTS, FFID_CATALOG_PUBLICATION_STATUSES, FFID_COMPANY_SIZE_CODES, FFID_DB_TOKEN_ALGORITHM, FFID_DB_TOKEN_AUDIENCE, FFID_DB_TOKEN_ERROR_CODES, FFID_DB_TOKEN_ORGANIZATION_CLAIM, FFID_DB_TOKEN_RESERVED_CLAIMS, FFID_DB_TOKEN_ROLE, FFID_ERROR_CODES, FFID_INDUSTRY_CODES, FFID_MAX_ORGANIZATION_LOGO_FILE_SIZE_BYTES, FFID_MAX_ORGANIZATION_LOGO_FILE_SIZE_MB, FFID_OAUTH_DENIAL_REASONS, FFID_ORGANIZATION_PROFILE_ERROR_CODES, FFID_SESSION_COOKIE_NAME, MAX_DB_TOKEN_TTL_SECONDS, canonicalizeCatalogValue, computeFFIDCheckoutCopyHash, computeLegalDisclosureHash, computePaymentConfigurationHash, computePraxisCopyHash, computeScopeHash, computeTaxConfigurationHash, createDbTokenMinter, createFFIDClient, createKVCacheAdapter, createMemoryCacheAdapter, createServerAuthClient, createTokenStore, createVerifyAccessToken, decodeConsentCookie, encodeConsentCookie, generateServerState, getFFIDAuthorizationError, getFFIDConsentFromCookieHeader, getFFIDConsentFromCookies, hashCanonicalJson, isFFIDOAuthDenialReason, sessionCookies, sha256Hex, validatePublishedCatalog };

package/dist/server/test/index.d.cts

@@ -1,4 +1,4 @@
-import { r as FFIDClient, e as FFIDOAuthUserInfo } from '../../ffid-client-DW8_m1_M.cjs';
+import { r as FFIDClient, e as FFIDOAuthUserInfo } from '../../ffid-client-DMwmK8mM.cjs';
 import '../../types-Cjb9J0rL.cjs';
 
 /**

package/dist/server/test/index.d.ts

@@ -1,4 +1,4 @@
-import { r as FFIDClient, e as FFIDOAuthUserInfo } from '../../ffid-client-ByfZA9sJ.js';
+import { r as FFIDClient, e as FFIDOAuthUserInfo } from '../../ffid-client-Dr2KVlIZ.js';
 import '../../types-Cjb9J0rL.js';
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feelflow/ffid-sdk",
-  "version": "12.0.0",
+  "version": "12.2.0",
   "description": "FeelFlow ID Platform SDK for React/Next.js applications",
   "keywords": [
     "feelflow",