@feelflow/ffid-sdk 2.19.0 → 2.20.0

package/dist/server/index.d.ts

@@ -1,1127 +1,7 @@
+import { F as FFIDLogger, a as FFIDError, b as FFIDCacheAdapter, c as FFIDVerifyAccessTokenOptions, d as FFIDApiResponse, e as FFIDOAuthUserInfo } from '../ffid-client-Cjm_TKUc.js';
+export { f as FFIDCacheConfig, g as FFIDClient, h as FFIDConfig, i as FFIDOrganization, j as FFIDOtpSendResponse, k as FFIDOtpVerifyResponse, l as FFIDPasswordResetConfirmResponse, m as FFIDPasswordResetResponse, n as FFIDPasswordResetVerifyResponse, o as FFIDProfileCallOptions, p as FFIDResetSessionResponse, q as FFIDSubscription, r as FFIDUpdateUserProfileRequest, s as FFIDUser, t as FFIDUserProfile, T as TokenData, u as TokenStore, v as createFFIDClient, w as createTokenStore } from '../ffid-client-Cjm_TKUc.js';
 export { D as DEFAULT_API_BASE_URL } from '../constants-DvTGHPZn.js';
 
-/**
- * Inquiry types exposed by the FFID SDK.
- *
- * Mirrors the `/api/v1/ext/inquiry` and `/api/contact` endpoints
- * with a single shared shape so that consumers can render one
- * `<FFIDInquiryForm />` and submit through either endpoint.
- */
-/**
- * Legacy 6-value canonical categories. Retained for historical DB rows
- * (the pre-2026 values `general`, `sales`, `support`, `press` still appear
- * in older inquiries) and for 2.x backwards compatibility with SDK
- * consumers that pinned to this exact set.
- *
- * Note: `partnership` and `other` intentionally also appear in
- * {@link FFID_INQUIRY_CATEGORIES_SITE_2026}; the legacy-only subset is
- * `general`, `sales`, `support`, `press`.
- *
- * @deprecated New integrations should use
- * {@link FFID_INQUIRY_CATEGORIES_SITE_2026} (13 values, aligned with
- * feelflow-website-2026 `/contact`). This legacy constant remains
- * exported for 2.x compatibility and may be removed in 3.x.
- */
-declare const FFID_INQUIRY_CATEGORIES: readonly ["general", "sales", "support", "partnership", "press", "other"];
-/**
- * Type alias derived from the legacy 6-value list. Still referenced by
- * {@link FFIDInquiryCreateParams.category} so existing callers compile
- * without changes; no `@deprecated` on the type itself because the
- * actionable migration target is the runtime constant above, and
- * propagating `@deprecated` to the type would surface false-positive
- * warnings on public API that deliberately accepts both shapes.
- */
-type FFIDInquiryCategory = (typeof FFID_INQUIRY_CATEGORIES)[number];
-/**
- * 13-value category list that mirrors feelflow-website-2026
- * `/contact` (`feelflow-site/src/lib/contact-schema.ts` `CATEGORY_OPTIONS`).
- *
- * Source-of-truth ownership: **the site repo is authoritative**; this
- * constant is a delayed-sync snapshot shipped through the SDK so
- * consumers can get autocomplete without depending on the site repo.
- * Drift between site and the FFID admin UI is detected automatically by
- * `scripts/sync-inquiry-categories.ts` (SDK-side drift is a separate
- * follow-up and today is caught only if the SDK snapshot is updated
- * alongside the admin UI constants).
- */
-declare const FFID_INQUIRY_CATEGORIES_SITE_2026: readonly ["consulting", "saas", "development", "agent-hub", "ai-feel-chatbot", "knowledge-db", "biz-simulator", "discussion-board", "realtime-ai", "partnership", "media", "recruiting", "other"];
-type FFIDInquiryCategorySite2026 = (typeof FFID_INQUIRY_CATEGORIES_SITE_2026)[number];
-/**
- * Parameters for `client.inquiry.create()`. When submitting from a
- * server-side SDK (Service API Key), set `source` to a stable
- * origin string so admins can trace the submission back.
- *
- * `category` accepts any string at the SDK boundary to keep the SDK
- * forward-compatible with new site-side categories added before the SDK
- * re-publishes. FFID ext-endpoint validation (`/api/v1/ext/inquiry`) is
- * lenient — `z.string().max(100).optional()` — so unknown strings flow
- * through to the DB unchanged. Note: the `(string & {})` arm of the
- * union intentionally keeps autocomplete active while allowing arbitrary
- * strings; callers using exhaustive `switch` statements should include
- * a `default` branch.
- */
-interface FFIDInquiryCreateParams {
-    email: string;
-    name: string;
-    message: string;
-    category?: FFIDInquiryCategorySite2026 | FFIDInquiryCategory | (string & {});
-    company?: string;
-    phone?: string;
-    locale?: 'ja' | 'en';
-    /** Current terms-of-service version the submitter agreed to. */
-    termsVersion: string;
-    /** Current privacy-policy version the submitter agreed to. */
-    privacyVersion: string;
-    /** Opt-in to the post-inquiry follow-up newsletter (Type A). */
-    inquiryFollowupOptIn?: boolean;
-    /** Opt-in to the general marketing newsletter (Type B). */
-    generalNewsletterOptIn?: boolean;
-}
-interface FFIDInquiryCreateResponse {
-    ok: true;
-    inquiryId: string;
-    /** True only when the submitter is already a confirmed newsletter subscriber. */
-    newsletterSubscribed: boolean;
-}
-
-/**
- * Newsletter types exposed by the FFID SDK.
- *
- * 2-layer newsletter model (#2078):
- *   - `inquiry_followup`: 問い合わせフォローアップ (Type A)
- *   - `general`:          定期ニュースレター (Type B)
- *
- * FFID account holders' preferences live in `user_marketing_preferences`;
- * anonymous subscribers live in `newsletter_subscribers` with double
- * opt-in required.
- */
-declare const FFID_NEWSLETTER_TYPES: readonly ["inquiry_followup", "general"];
-type FFIDNewsletterType = (typeof FFID_NEWSLETTER_TYPES)[number];
-interface FFIDNewsletterSubscribeParams {
-    /** Subscriber email address */
-    email: string;
-    /** One or more newsletter types to opt in to */
-    types: FFIDNewsletterType[];
-    /** Origin string recorded on the subscriber row (e.g. your service code) */
-    source: string;
-    /** ISO 639-1 locale (e.g. 'ja', 'en') */
-    locale?: string;
-}
-interface FFIDNewsletterSubscribeResponse {
-    ok: true;
-    /** True when a double opt-in confirmation email was sent */
-    requiresConfirmation: boolean;
-    /** True when the email matched an existing FFID account; the caller
-     *  must sign in to update preferences. Preferences are NOT modified. */
-    requiresSignIn: boolean;
-}
-interface FFIDNewsletterConfirmParams {
-    /** Confirmation token received in the double opt-in email */
-    token: string;
-}
-interface FFIDNewsletterConfirmResponse {
-    ok: true;
-}
-interface FFIDNewsletterUnsubscribeParams {
-    /** Unsubscribe token received in the newsletter footer / List-Unsubscribe header */
-    token: string;
-}
-interface FFIDNewsletterUnsubscribeResponse {
-    ok: true;
-}
-
-/** Cache adapter interface for FFID SDK token verification */
-/**
- * Pluggable cache adapter interface.
- * Implement this to use custom cache backends (Redis, Memcached, etc.)
- */
-interface FFIDCacheAdapter {
-    /** Get a cached value by key. Returns null if not found or expired. */
-    get(key: string): Promise<unknown | null>;
-    /** Set a value with TTL in seconds. */
-    set(key: string, value: unknown, ttlSeconds: number): Promise<void>;
-    /** Delete a cached value. */
-    delete(key: string): Promise<void>;
-}
-/** Cache configuration for createFFIDClient */
-interface FFIDCacheConfig {
-    /** Cache adapter instance */
-    adapter: FFIDCacheAdapter;
-    /** Cache TTL in seconds (how long to cache userinfo/introspect results) */
-    ttl: number;
-}
-
-/** Billing interval for subscriptions */
-type FFIDBillingInterval = 'monthly' | 'yearly';
-/**
- * Supported currencies for billing responses.
- * Mirrors the platform's `SupportedCurrency` enum (`jpy` = zero-decimal Japanese Yen, `usd` = US Dollar).
- */
-type FFIDSupportedCurrency = 'jpy' | 'usd';
-/** Service information returned by plans endpoint */
-interface FFIDServiceInfo {
-    id: string;
-    code: string;
-    name: string;
-    description: string | null;
-    isActive: boolean;
-    createdAt: string;
-    plans: FFIDPlanInfo[];
-}
-/** Plan information returned by plans endpoint */
-interface FFIDPlanInfo {
-    id: string;
-    serviceId: string;
-    code: string;
-    name: string;
-    description: string | null;
-    minSeats: number;
-    maxSeats: number | null;
-    seatSelectionEnabled: boolean;
-    trialDays: number;
-    priceMonthly: number;
-    priceYearly: number | null;
-    currency: string;
-    isActive: boolean;
-    displayOrder: number;
-    customPricing: boolean;
-    createdAt: string;
-}
-/** Response from list plans endpoint */
-interface FFIDListPlansResponse {
-    services: FFIDServiceInfo[];
-    count: number;
-}
-/** Subscription details returned by ext API (sanitized, no Stripe IDs) */
-interface FFIDSubscriptionDetail {
-    id: string;
-    organizationId: string;
-    organizationName: string;
-    serviceCode: string;
-    serviceName: string;
-    planCode: string;
-    planName: string;
-    status: FFIDSubscriptionStatus;
-    paymentMethod: string | null;
-    billingInterval: FFIDBillingInterval;
-    quantity: number;
-    currentPeriodStart: string | null;
-    currentPeriodEnd: string | null;
-    trialStart: string | null;
-    trialEnd: string | null;
-    canceledAt: string | null;
-    cancelAtPeriodEnd: boolean;
-    /** Pending period-end downgrade info (null = no scheduled downgrade) */
-    pendingDowngrade: {
-        planCode: string;
-        planName: string;
-        billingInterval: FFIDBillingInterval;
-        scheduledAt: string;
-        requestedAt: string;
-    } | null;
-    createdAt: string;
-}
-/** Parameters for subscribing to a plan */
-interface FFIDSubscribeParams {
-    /** Organization ID (UUID) */
-    organizationId: string;
-    /** Plan code (e.g., 'free', 'basic', 'pro') */
-    planCode: string;
-    /** Billing interval (default: 'monthly') */
-    billingInterval?: FFIDBillingInterval;
-    /** Number of seats (default: plan's minSeats) */
-    quantity?: number;
-    /** User ID for seat auto-assignment (only needed for service-key mode) */
-    userId?: string;
-}
-/** Sanitized subscription fields returned by subscribe/reactivate endpoints (no Stripe IDs) */
-interface FFIDSubscriptionSummary {
-    id: string;
-    organizationId: string;
-    serviceId: string;
-    planId: string;
-    status: FFIDSubscriptionStatus;
-    paymentMethod: string | null;
-    billingInterval: FFIDBillingInterval;
-    quantity: number;
-    currentPeriodStart: string | null;
-    currentPeriodEnd: string | null;
-    trialStart: string | null;
-    trialEnd: string | null;
-    canceledAt: string | null;
-    cancelAtPeriodEnd: boolean;
-    createdAt: string;
-}
-/** Response from subscribe endpoint */
-interface FFIDSubscribeResponse {
-    subscription: FFIDSubscriptionSummary;
-    service: {
-        id: string;
-        code: string;
-        name: string;
-    };
-    plan: {
-        id: string;
-        code: string;
-        name: string;
-        priceMonthly: number;
-        priceYearly: number | null;
-        trialDays: number;
-    };
-    /** True if a canceled subscription was reactivated */
-    reactivated?: boolean;
-    /** True if Stripe checkout is needed (canceled paid plan reactivation) */
-    needsCheckout?: boolean;
-}
-/** Parameters for changing plan */
-interface FFIDChangePlanParams {
-    /** Subscription ID (UUID) */
-    subscriptionId: string;
-    /** New plan code */
-    planCode: string;
-    /** New billing interval (default: keeps current) */
-    billingInterval?: FFIDBillingInterval;
-}
-/** Response from change plan endpoint */
-interface FFIDChangePlanResponse {
-    message: string;
-    subscription: {
-        id: string;
-        organizationId: string;
-        serviceCode: string;
-        planCode: string;
-        planName: string;
-        billingInterval: FFIDBillingInterval;
-        status: FFIDSubscriptionStatus;
-        isUpgrade: boolean;
-    };
-    /** Present when downgrade is scheduled for period end instead of immediate */
-    pendingDowngrade?: {
-        planCode: string;
-        planName: string;
-        scheduledAt: string;
-    };
-}
-/** Parameters for canceling subscription */
-interface FFIDCancelSubscriptionParams {
-    /** Subscription ID (UUID) */
-    subscriptionId: string;
-    /** Cancellation reason code */
-    reason?: 'too_expensive' | 'missing_features' | 'switched_service' | 'rarely_used' | 'customer_service' | 'other';
-    /** Additional cancellation details */
-    reasonDetails?: string;
-}
-/** Response from cancel subscription endpoint */
-interface FFIDCancelSubscriptionResponse {
-    message: string;
-    subscription: {
-        id: string;
-        organizationId: string;
-        status: FFIDSubscriptionStatus;
-        canceledAt: string | null;
-    };
-}
-/** Response from cancel pending downgrade endpoint */
-interface FFIDCancelPendingDowngradeResponse {
-    message: string;
-    subscription: {
-        id: string;
-        organizationId: string;
-        serviceCode: string;
-        planCode: string;
-        billingInterval: FFIDBillingInterval;
-        status: FFIDSubscriptionStatus;
-        /** Always null after successful cancellation */
-        pendingDowngradePlanId: null;
-    };
-}
-/** Parameters for previewing plan change */
-interface FFIDPreviewPlanChangeParams {
-    /** Subscription ID (UUID) */
-    subscriptionId: string;
-    /** New plan code */
-    planCode: string;
-    /** New billing interval (default: keeps current) */
-    billingInterval?: FFIDBillingInterval;
-}
-/** Plan change preview line item */
-interface FFIDPlanChangeLineItem {
-    description: string;
-    amount: number;
-}
-/** Fields shared by every plan-change preview variant (internal; consumers use `FFIDPlanChangePreview`) */
-interface FFIDPlanChangePreviewBase {
-    /** Discriminant for preview response variants (reserved for future unions with e.g. seat-change previews) */
-    type: 'plan-change';
-    /** Current plan display info. `price` is the total for the current quantity (unitPrice × quantity), not per-seat. */
-    currentPlan: {
-        name: string;
-        price: number;
-    };
-    /** New plan display info. `price` is the total for the effective quantity (unitPrice × quantity), not per-seat. */
-    newPlan: {
-        name: string;
-        price: number;
-    };
-    billingInterval: FFIDBillingInterval;
-    isUpgrade: boolean;
-    /** Full amount of the next billing cycle at the new plan's standard price. Never overwritten by Stripe proration data. */
-    nextInvoiceAmount: number;
-    nextInvoiceDate: string | null;
-    currency: FFIDSupportedCurrency;
-    /** true when amounts are estimated from local prices (no Stripe proration data) */
-    isEstimate: boolean;
-    /** Reason why `isEstimate` is true. Only meaningful when `isEstimate === true`. */
-    estimateReason?: 'no_stripe_data' | 'custom_pricing' | 'stripe_error';
-    lineItems: FFIDPlanChangeLineItem[];
-}
-/**
- * Plan change proration preview.
- *
- * `willApplyAtPeriodEnd` is a discriminant that constrains related fields at the type level:
- * - `true`: period-end-deferred downgrade. `proratedAmount` is always 0; `effectiveDate` mirrors
- *   the subscription's `currentPeriodEnd` (may be `null` when the subscription has no active
- *   billing cycle yet — e.g. a pre-Stripe trial or a subscription whose billing cycle is unset).
- * - `false`: immediate change. `effectiveDate` is always `null`; `proratedAmount` is the live
- *   (possibly Stripe-refined) day-basis difference.
- */
-type FFIDPlanChangePreview = FFIDPlanChangePreviewBase & ({
-    willApplyAtPeriodEnd: true;
-    effectiveDate: string | null;
-    /** 0 on period-end-deferred changes; charge happens at the next invoice */
-    proratedAmount: 0;
-} | {
-    willApplyAtPeriodEnd: false;
-    effectiveDate: null;
-    /** Prorated difference charged within the current billing period */
-    proratedAmount: number;
-});
-/** Response from plan change preview endpoint */
-interface FFIDPlanChangePreviewResponse {
-    preview: FFIDPlanChangePreview;
-}
-/** Parameters for previewing a seat count change */
-interface FFIDPreviewSeatChangeParams {
-    /** Subscription ID (UUID) */
-    subscriptionId: string;
-    /** New seat quantity. Must be an integer within the plan's allowed range. */
-    quantity: number;
-}
-/** Seat change preview line item */
-interface FFIDSeatChangeLineItem {
-    description: string;
-    amount: number;
-}
-/**
- * Seat change proration preview.
- *
- * Sister type to `FFIDPlanChangePreview`. The shared `type` discriminant lets
- * consumers narrow a preview payload without inspecting unrelated fields.
- *
- * - `isEstimate=true` (default when Stripe is not configured or data is unavailable):
- *   `proratedAmount` is computed locally as `(newQuantity - currentQuantity) * unitPrice`.
- * - `isEstimate=false`: `proratedAmount` reflects Stripe's live proration calculation.
- *
- * `nextInvoiceAmount` is always a local estimate (`unitPrice * newQuantity`).
- *
- * `pricingUnavailable=true` indicates the plan uses custom pricing with a zero unit
- * price (Enterprise). Consumers should hide monetary amounts in this case.
- */
-interface FFIDSeatChangePreview {
-    /** Discriminant for preview response variants (pairs with `FFIDPlanChangePreview.type`) */
-    type: 'seat-change';
-    currentQuantity: number;
-    newQuantity: number;
-    /** Per-seat price for the current billing interval */
-    unitPrice: number;
-    billingInterval: FFIDBillingInterval;
-    /**
-     * Prorated cost for the current billing period. Negative when seats are decreased
-     * (credit). `0` when `pricingUnavailable === true` (Enterprise custom pricing).
-     */
-    proratedAmount: number;
-    /** Next invoice full amount — always a local estimate (`unitPrice * newQuantity`) */
-    nextInvoiceAmount: number;
-    nextInvoiceDate: string | null;
-    currency: FFIDSupportedCurrency;
-    /** true when proratedAmount is estimated from local prices rather than Stripe proration data */
-    isEstimate: boolean;
-    /** true when unit price is 0 due to custom pricing (Enterprise) — hide monetary amounts */
-    pricingUnavailable?: boolean;
-    /** Reason why `isEstimate` is true. Only meaningful when `isEstimate === true`. */
-    estimateReason?: 'no_stripe_data' | 'custom_pricing' | 'stripe_error';
-    lineItems: FFIDSeatChangeLineItem[];
-}
-/** Response from seat change preview endpoint */
-interface FFIDSeatChangePreviewResponse {
-    preview: FFIDSeatChangePreview;
-}
-
-/**
- * FFID SDK Type Definitions
- *
- * Core types for the FeelFlow ID SDK
- */
-
-/** Authentication mode for FFID client */
-type FFIDAuthMode = 'cookie' | 'token' | 'service-key';
-/**
- * User information from FFID
- */
-type FFIDSeatModel = 'organization';
-/** Userinfo member role for OAuth responses */
-type FFIDOAuthUserInfoMemberRole = 'owner' | 'admin' | 'member' | 'viewer';
-interface FFIDUser {
-    /** User ID (UUID) */
-    id: string;
-    /** Email address */
-    email: string;
-    /** Display name */
-    displayName: string | null;
-    /** Avatar URL */
-    avatarUrl: string | null;
-    /** Locale setting (e.g., 'ja', 'en') */
-    locale: string | null;
-    /** Timezone (e.g., 'Asia/Tokyo') */
-    timezone: string | null;
-    /** Account creation timestamp */
-    createdAt: string;
-}
-/**
- * Agency branding information for white-label support.
- * Included in organization when it is linked to an agency.
- */
-interface FFIDAgencyBranding {
-    /** Agency ID (UUID) */
-    agencyId: string;
-    /** Agency display name */
-    agencyName: string;
-    /** Custom logo URL */
-    logoUrl?: string;
-    /** Custom favicon URL */
-    faviconUrl?: string;
-    /** Primary brand color (hex) */
-    primaryColor?: string;
-    /** Secondary brand color (hex) */
-    secondaryColor?: string;
-    /** White-label company name */
-    companyName?: string;
-}
-/**
- * Organization membership information
- */
-interface FFIDOrganization {
-    /** Organization ID (UUID) */
-    id: string;
-    /** Organization name */
-    name: string;
-    /** URL-safe slug */
-    slug: string;
-    /** User's role in this organization */
-    role: 'owner' | 'admin' | 'member';
-    /** Membership status */
-    status: 'active' | 'invited' | 'suspended';
-    /** Agency branding (null if org is not linked to an agency) */
-    agencyBranding: FFIDAgencyBranding | null;
-}
-/**
- * Subscription/contract information
- */
-interface FFIDSubscription {
-    /** Subscription ID (UUID) */
-    id: string;
-    /** Service code (e.g., 'chatbot') */
-    serviceCode: string;
-    /** Service display name */
-    serviceName: string;
-    /** Plan code (e.g., 'basic', 'pro') */
-    planCode: string;
-    /** Plan display name */
-    planName: string;
-    /** Subscription status */
-    status: FFIDSubscriptionStatus;
-    /** Current billing period end date */
-    currentPeriodEnd: string | null;
-    /** Trial end date (null if not a trial or no trial_end set) */
-    trialEnd: string | null;
-    /** Service seat model (available when sourced from OAuth userinfo) */
-    seatModel?: FFIDSeatModel | undefined;
-    /** Member role in the resolved organization context */
-    memberRole?: FFIDOAuthUserInfoMemberRole | undefined;
-    /** Organization ID used to resolve subscription access */
-    organizationId?: string | null | undefined;
-}
-/** OAuth userinfo subscription summary */
-interface FFIDOAuthUserInfoSubscription {
-    subscriptionId: string | null;
-    status: FFIDSubscriptionStatus | null;
-    planCode: string | null;
-    seatModel: FFIDSeatModel | null;
-    memberRole: FFIDOAuthUserInfoMemberRole | null;
-    organizationId: string | null;
-    hasSeatAssignment: boolean | null;
-}
-/** OAuth userinfo response exposed by FFID */
-interface FFIDOAuthUserInfo {
-    sub: string;
-    email: string | null;
-    name: string | null;
-    picture: string | null;
-    companyName?: string | null | undefined;
-    department?: string | null | undefined;
-    position?: string | null | undefined;
-    phoneNumber?: string | null | undefined;
-    organizationId?: string | null | undefined;
-    subscription?: FFIDOAuthUserInfoSubscription | undefined;
-}
-/** Options for verifyAccessToken */
-interface FFIDVerifyAccessTokenOptions {
-    /**
-     * When true, fetches profile info (email, name, picture) via introspect API
-     * after local JWT verification. No effect when verifyStrategy is 'introspect'
-     * (profile is always included).
-     * Requires {@link FFIDConfig.serviceApiKey} to be configured when using jwt strategy.
-     * @default false
-     */
-    includeProfile?: boolean;
-}
-/**
- * SDK configuration options
- */
-interface FFIDConfig {
-    /** Service code to identify your application */
-    serviceCode: string;
-    /** FFID API base URL (defaults to production) */
-    apiBaseUrl?: string | undefined;
-    /**
-     * Enable debug logging (deprecated: use logger instead)
-     * When true and no logger provided, uses console for logging
-     * @deprecated Use `logger` option for custom logging
-     */
-    debug?: boolean | undefined;
-    /**
-     * Custom logger for SDK debug output
-     * If not provided: uses no-op logger (silent)
-     * If debug=true and no logger: uses console
-     */
-    logger?: FFIDLogger | undefined;
-    /** Session refresh interval in milliseconds */
-    refreshInterval?: number | undefined;
-    /** Callback when authentication state changes */
-    onAuthStateChange?: ((user: FFIDUser | null) => void) | undefined;
-    /** Callback on authentication error */
-    onError?: ((error: FFIDError) => void) | undefined;
-    /** Authentication mode: 'cookie' (default), 'token' (OAuth Bearer), or 'service-key' (server-to-server) */
-    authMode?: FFIDAuthMode | undefined;
-    /** Client ID for token mode (defaults to serviceCode if not set) */
-    clientId?: string | undefined;
-    /** Custom redirect URI for OAuth flow (defaults to window.location.origin + window.location.pathname) */
-    redirectUri?: string | undefined;
-    /** Service API key for service-key mode (X-Service-Api-Key header) */
-    serviceApiKey?: string | undefined;
-    /**
-     * Token verification strategy for service-key mode.
-     * - 'jwt': Local JWT verification via JWKS (default, lower latency)
-     * - 'introspect': Remote introspection via /api/v1/oauth/introspect
-     *
-     * JWT verification returns limited claims (no email/name/picture/subscription) by default.
-     * Use 'introspect' if you always need full user profile data, or pass
-     * { includeProfile: true } to verifyAccessToken() for on-demand profile fetching.
-     */
-    verifyStrategy?: 'jwt' | 'introspect' | undefined;
-    /**
-     * Cache configuration for token verification results.
-     * When set, introspect/userinfo responses are cached to reduce API calls.
-     * Effective in service-key mode with verifyStrategy: 'introspect',
-     * or with verifyStrategy: 'jwt' when includeProfile: true is used.
-     */
-    cache?: FFIDCacheConfig | undefined;
-    /**
-     * Request timeout in milliseconds for FFID API calls.
-     * Applies to token verification and introspection requests.
-     * @default undefined (no timeout, uses fetch default)
-     */
-    timeout?: number | undefined;
-}
-/**
- * Logger interface for SDK debug output
- *
- * Allows injection of custom loggers (e.g., winston, pino)
- * or use of the built-in console logger when debug is enabled
- */
-interface FFIDLogger {
-    /** Debug level logging */
-    debug: (...args: unknown[]) => void;
-    /** Info level logging */
-    info: (...args: unknown[]) => void;
-    /** Warning level logging */
-    warn: (...args: unknown[]) => void;
-    /** Error level logging */
-    error: (...args: unknown[]) => void;
-}
-/**
- * FFID error object
- */
-interface FFIDError {
-    /** Error code */
-    code: string;
-    /** Human-readable error message */
-    message: string;
-    /** Additional error details */
-    details?: Record<string, unknown>;
-}
-/**
- * Session response from FFID API
- */
-interface FFIDSessionResponse {
-    user: FFIDUser;
-    organizations: FFIDOrganization[];
-    subscriptions: FFIDSubscription[];
-}
-/**
- * API response wrapper (discriminated union for type safety)
- *
- * Either data is present (success) or error is present (failure), never both.
- * This pattern ensures callers handle both cases explicitly.
- */
-type FFIDApiResponse<T> = {
-    data: T;
-    error?: undefined;
-} | {
-    data?: undefined;
-    error: FFIDError;
-};
-/** Subscription status values matching the FFID platform's SubscriptionStatus type */
-type FFIDSubscriptionStatus = 'trialing' | 'active' | 'past_due' | 'canceled' | 'pending_invoice' | 'paused' | 'incomplete' | 'incomplete_expired' | 'unpaid';
-interface FFIDSubscriptionCheckResponse {
-    hasActiveSubscription: boolean;
-    organizationId: string | null;
-    subscriptionId: string | null;
-    status: FFIDSubscriptionStatus | null;
-    planCode: string | null;
-    currentPeriodEnd: string | null;
-}
-/**
- * Checkout session response from billing checkout endpoint
- */
-interface FFIDCheckoutSessionResponse {
-    /** Stripe Checkout session ID */
-    sessionId: string;
-    /** Stripe Checkout session URL (null if session creation had issues) */
-    url: string | null;
-}
-/**
- * Portal session response from billing portal endpoint
- */
-interface FFIDPortalSessionResponse {
-    /** Stripe Billing Portal URL */
-    url: string;
-}
-/**
- * Parameters for creating a checkout session
- */
-interface FFIDCreateCheckoutParams {
-    /** Organization ID (UUID) */
-    organizationId: string;
-    /** Subscription ID (UUID) */
-    subscriptionId: string;
-    /** URL to redirect after successful checkout */
-    successUrl: string;
-    /** URL to redirect after cancelled checkout */
-    cancelUrl: string;
-    /** Optional plan ID for upgrade or resubscription */
-    planId?: string;
-}
-/**
- * Parameters for creating a billing portal session
- */
-interface FFIDCreatePortalParams {
-    /** Organization ID (UUID) */
-    organizationId: string;
-    /** URL to redirect when user exits the portal */
-    returnUrl: string;
-}
-
-/** Member role in an organization */
-type FFIDMemberRole = 'owner' | 'admin' | 'member' | 'viewer';
-/** Member status in an organization */
-type FFIDMemberStatus = 'active' | 'invited' | 'suspended';
-/** Organization member returned by the ext members API */
-interface FFIDOrganizationMember {
-    /** User ID (UUID) */
-    userId: string;
-    /** Email address */
-    email: string;
-    /** Display name */
-    displayName: string | null;
-    /** Avatar URL */
-    avatarUrl: string | null;
-    /** Role in the organization */
-    role: FFIDMemberRole;
-    /** Membership status */
-    status: FFIDMemberStatus;
-    /** When the user joined */
-    joinedAt: string | null;
-    /** When the user was invited */
-    invitedAt: string | null;
-    /** Last sign-in timestamp */
-    lastSignInAt: string | null;
-}
-/** Response from listMembers (ext) */
-interface FFIDListMembersResponse {
-    organizationId: string;
-    members: FFIDOrganizationMember[];
-}
-/** Response from updateMemberRole (ext) */
-interface FFIDUpdateMemberRoleResponse {
-    member: FFIDOrganizationMember;
-}
-/** Response from removeMember (ext) */
-interface FFIDRemoveMemberResponse {
-    message: string;
-}
-/**
- * User profile for the authenticated user (returned by `getProfile` / `updateProfile`).
- *
- * Mirrors the FFID backend `UserProfile` shape exposed via
- * `GET /api/v1/users/ext/me` and `PUT /api/v1/users/ext/me`.
- */
-interface FFIDUserProfile {
-    /** User ID (UUID) */
-    id: string;
-    /** Email address */
-    email: string;
-    /** Display name (nullable when not set) */
-    displayName: string | null;
-    /** Avatar URL (nullable when not set) */
-    avatarUrl: string | null;
-    /** Phone number (nullable when not set) */
-    phone: string | null;
-    /** Company name (nullable when not set) */
-    companyName: string | null;
-    /** Department (nullable when not set) */
-    department: string | null;
-    /** Job title (nullable when not set) */
-    jobTitle: string | null;
-    /** IANA timezone (e.g. 'Asia/Tokyo') */
-    timezone: string;
-    /** Locale (e.g. 'ja', 'en') */
-    locale: string;
-    /** Arbitrary user preferences bag */
-    preferences: Record<string, unknown>;
-    /** Account creation timestamp (ISO 8601) */
-    createdAt: string;
-    /** Profile last-updated timestamp (ISO 8601) */
-    updatedAt: string;
-}
-/**
- * Per-call options for profile methods (`getProfile` / `updateProfile`).
- *
- * Supply `accessToken` to forward an end-user Bearer token for the single call
- * without mutating client-level auth state. Designed for server runtimes (Cloudflare
- * Workers, Edge, Node) that receive a user-scoped Bearer per request and want to
- * act as that user against `/api/v1/users/ext/me`.
- *
- * When `accessToken` is supplied with a non-empty value, it overrides the client's
- * configured auth mode: authentication for that request uses only
- * `Authorization: Bearer <accessToken>` (no service key, no cookie, no token-store
- * lookup, no auto-refresh on 401). Non-auth headers such as `Content-Type` are
- * still attached. SDK metadata headers (`User-Agent` / `X-FFID-SDK-Version`) are
- * attached on non-browser runtimes only (Node.js / Cloudflare Workers / Edge /
- * Deno); browsers receive an empty object to avoid iOS WebKit `fetch()` breakage
- * (see #2417).
- *
- * Runtime semantics:
- * - `accessToken` omitted (or `undefined`) → no override, configured `authMode` is used
- * - `accessToken` is empty string / whitespace-only → rejected as `VALIDATION_ERROR`
- *   before any network call (prevents silent impersonation fallback when a caller
- *   extracts a missing/blank `Authorization` header into this field)
- * - `accessToken` is a non-empty string → override activated
- */
-interface FFIDProfileCallOptions {
-    /**
-     * End-user Bearer token forwarded for this single request.
-     *
-     * Must be a non-empty string when supplied. Passing `''` or a whitespace-only
-     * string is treated as a caller error and surfaces as `VALIDATION_ERROR` —
-     * this guards against the common footgun where a server runtime extracts the
-     * Bearer from an incoming request without checking the header is present.
-     */
-    accessToken?: string;
-}
-/**
- * Request payload for `updateProfile`.
- *
- * Mirrors the FFID backend `UpdateUserProfileRequest` shape. All fields are
- * optional — only the supplied keys will be updated (partial update semantics).
- *
- * Per-field value semantics:
- * - `undefined` / key omitted → field is untouched (partial update)
- * - `null` → clears the field (stores SQL NULL in the DB)
- * - `""` (empty string) → stored as a literal empty string, **not** treated as
- *   a clear. Use `null` when you want the DB value to become NULL
- *
- * `timezone` and `locale` are intentionally modeled as non-null in this
- * request type (application-level invariant — the DB columns have DEFAULT
- * values but no NOT NULL constraint, yet the server-side normalization
- * pipeline assumes a string is always present). Pass a string to update the
- * value, or omit the key to leave the current value in place. Do not pass
- * `null` to clear — there is no meaningful "no timezone" state for a user.
- *
- * `preferences: null` is accepted and clears the column. Subsequent reads
- * return `{}` because the FFID backend normalizes a null `preferences` column
- * to an empty object (`toUserProfile` helper) before serializing the response —
- * the SDK itself does not transform the payload.
- */
-interface FFIDUpdateUserProfileRequest {
-    /** Display name (null clears the field) */
-    displayName?: string | null;
-    /** Phone number (null clears the field) */
-    phone?: string | null;
-    /** Company name (null clears the field) */
-    companyName?: string | null;
-    /** Department (null clears the field) */
-    department?: string | null;
-    /** Job title (null clears the field) */
-    jobTitle?: string | null;
-    /** IANA timezone (non-null; omit the key to leave unchanged) */
-    timezone?: string;
-    /** Locale (non-null; omit the key to leave unchanged) */
-    locale?: string;
-    /** Arbitrary user preferences bag (null clears the column; reads return {}) */
-    preferences?: Record<string, unknown> | null;
-}
-/**
- * Discriminant for redirect failures that callers need to handle
- * programmatically (vs. logging the human-readable `error` string).
- *
- * - `'redirect_loop_detected'`: `redirectToAuthorize()` detected that the
- *   same authorize URL (keyed by `baseUrl + client_id + organization_id`)
- *   has been fired **3 times within 60 seconds**. Caller should surface a
- *   manual "再度ログインする" UI rather than retry automatically (#2406 / #2411).
- *
- * SDK 2.18.0 only ships `'redirect_loop_detected'`. Other failure paths
- * (SSR environment, PKCE generation failure, empty organizationId) currently
- * return `error` without a `code`. New codes will be added in future minor
- * versions — treat this union as forward-extensible and do NOT exhaustively
- * `switch` over it without a `default` branch for consumer code that must
- * stay compatible across SDK upgrades.
- */
-type FFIDRedirectErrorCode = 'redirect_loop_detected';
-/**
- * Result of a redirect operation (redirectToLogin / redirectToAuthorize / redirectToLogout)
- *
- * Structured return type so callers can inspect failure reasons
- * instead of receiving a bare `false`. When `code` is set, branch on it
- * for programmatic handling; otherwise log `error` for humans.
- */
-type FFIDRedirectResult = {
-    success: true;
-} | {
-    success: false;
-    error: string;
-    code?: FFIDRedirectErrorCode;
-};
-
-/** OTP / magic link methods - sendOtp / verifyOtp */
-
-/** Response from sendOtp */
-interface FFIDOtpSendResponse {
-    message: string;
-}
-/** Response from verifyOtp */
-interface FFIDOtpVerifyResponse {
-    user: {
-        id: string;
-        email: string;
-        displayName: string | null;
-        avatarUrl: string | null;
-    };
-    session: {
-        accessToken: string;
-        refreshToken: string;
-        expiresAt: number;
-        expiresIn: number;
-    };
-}
-
-/** Password reset methods - requestPasswordReset / verifyPasswordResetToken / establishResetSession / confirmPasswordReset */
-
-/** Response from requestPasswordReset */
-interface FFIDPasswordResetResponse {
-    message: string;
-}
-/** Response from verifyPasswordResetToken */
-interface FFIDPasswordResetVerifyResponse {
-    valid: boolean;
-}
-/** Response from establishResetSession */
-type FFIDResetSessionResponse = FFIDPasswordResetResponse;
-/** Response from confirmPasswordReset */
-type FFIDPasswordResetConfirmResponse = FFIDPasswordResetResponse;
-
-/** Contract Wizard navigation methods — URL generation and browser redirect for contract flows */
-
-/** Options for the new-subscription wizard flow */
-interface ContractWizardSubscribeOptions {
-    /** URL to redirect back to after completion */
-    redirect?: string;
-    /** Organization ID — passed as ?org= so middleware auto-sets the org cookie */
-    organizationId?: string;
-}
-/** Options for the resubscribe wizard flow */
-interface ContractWizardResubscribeOptions {
-    /** Service code to resubscribe to (defaults to SDK's serviceCode) */
-    serviceCode?: string;
-    /** URL to redirect back to after completion */
-    redirect?: string;
-    /** Organization ID — passed as ?org= so middleware auto-sets the org cookie */
-    organizationId?: string;
-}
-/** Options for wizard flows that operate on an existing subscription */
-interface ContractWizardSubscriptionOptions {
-    /** URL to redirect back to after completion */
-    redirect?: string;
-    /** Organization ID — passed as ?org= so middleware auto-sets the org cookie */
-    organizationId?: string;
-}
-
-/** Redirect and URL generation - redirectToLogin / redirectToAuthorize / redirectToLogout / getLoginUrl / getSignupUrl / getLogoutUrl */
-
-/** Options for redirectToAuthorize */
-interface RedirectToAuthorizeOptions {
-    /** Target organization ID — triggers org-scoped OAuth re-authorization */
-    organizationId?: string;
-}
-
-/**
- * Token Store
- *
- * Manages OAuth 2.0 tokens (access + refresh) with dual-storage support.
- * Falls back to in-memory storage when localStorage is unavailable
- * (e.g., Safari private browsing mode).
- */
-/**
- * Token data stored by the token store
- */
-interface TokenData {
-    /** OAuth 2.0 access token */
-    accessToken: string;
-    /** OAuth 2.0 refresh token */
-    refreshToken: string;
-    /** Expiration timestamp in milliseconds (Unix epoch) */
-    expiresAt: number;
-}
-/**
- * Token store interface for managing OAuth tokens
- */
-interface TokenStore {
-    /** Get stored tokens (null if not stored) */
-    getTokens(): TokenData | null;
-    /** Store new tokens */
-    setTokens(tokens: TokenData): void;
-    /** Clear all stored tokens */
-    clearTokens(): void;
-    /** Check if access token is expired (with 30s buffer) */
-    isAccessTokenExpired(): boolean;
-}
-/**
- * Create a token store with the specified storage type.
- *
- * When storageType is 'localStorage' (default in browser), falls back
- * to memory if localStorage is not available (e.g., Safari private mode).
- *
- * @param storageType - 'localStorage' (default) or 'memory'
- */
-declare function createTokenStore(storageType?: 'localStorage' | 'memory'): TokenStore;
-
-/** Creates an FFID API client instance */
-declare function createFFIDClient(config: FFIDConfig): {
-    getSession: () => Promise<FFIDApiResponse<FFIDSessionResponse>>;
-    signOut: () => Promise<FFIDApiResponse<void>>;
-    redirectToLogin: () => Promise<FFIDRedirectResult>;
-    redirectToAuthorize: (options?: RedirectToAuthorizeOptions) => Promise<FFIDRedirectResult>;
-    redirectToLogout: (postLogoutRedirectUri?: string) => FFIDRedirectResult;
-    getLoginUrl: (redirectUrl?: string) => string;
-    getLogoutUrl: (postLogoutRedirectUri?: string) => string;
-    getSignupUrl: (redirectUrl?: string) => string;
-    createError: (code: string, message: string) => FFIDError;
-    exchangeCodeForTokens: (code: string, codeVerifier?: string) => Promise<FFIDApiResponse<void>>;
-    refreshAccessToken: () => Promise<FFIDApiResponse<void>>;
-    checkSubscription: (params: {
-        userId?: string;
-        organizationId: string;
-    }) => Promise<FFIDApiResponse<FFIDSubscriptionCheckResponse>>;
-    listMembers: (params: {
-        organizationId: string;
-    }) => Promise<FFIDApiResponse<FFIDListMembersResponse>>;
-    updateMemberRole: (params: {
-        organizationId: string;
-        userId: string;
-        role: FFIDMemberRole;
-    }) => Promise<FFIDApiResponse<FFIDUpdateMemberRoleResponse>>;
-    removeMember: (params: {
-        organizationId: string;
-        userId: string;
-    }) => Promise<FFIDApiResponse<FFIDRemoveMemberResponse>>;
-    getProfile: (options?: FFIDProfileCallOptions) => Promise<FFIDApiResponse<FFIDUserProfile>>;
-    updateProfile: (data: FFIDUpdateUserProfileRequest, options?: FFIDProfileCallOptions) => Promise<FFIDApiResponse<FFIDUserProfile>>;
-    createCheckoutSession: (params: FFIDCreateCheckoutParams) => Promise<FFIDApiResponse<FFIDCheckoutSessionResponse>>;
-    createPortalSession: (params: FFIDCreatePortalParams) => Promise<FFIDApiResponse<FFIDPortalSessionResponse>>;
-    listPlans: () => Promise<FFIDApiResponse<FFIDListPlansResponse>>;
-    getSubscription: (subscriptionId: string) => Promise<FFIDApiResponse<FFIDSubscriptionDetail>>;
-    subscribe: (params: FFIDSubscribeParams) => Promise<FFIDApiResponse<FFIDSubscribeResponse>>;
-    changePlan: (params: FFIDChangePlanParams) => Promise<FFIDApiResponse<FFIDChangePlanResponse>>;
-    cancelSubscription: (params: FFIDCancelSubscriptionParams) => Promise<FFIDApiResponse<FFIDCancelSubscriptionResponse>>;
-    cancelPendingDowngrade: (subscriptionId: string) => Promise<FFIDApiResponse<FFIDCancelPendingDowngradeResponse>>;
-    previewPlanChange: (params: FFIDPreviewPlanChangeParams) => Promise<FFIDApiResponse<FFIDPlanChangePreviewResponse>>;
-    previewSeatChange: (params: FFIDPreviewSeatChangeParams) => Promise<FFIDApiResponse<FFIDSeatChangePreviewResponse>>;
-    verifyAccessToken: (accessToken: string, options?: FFIDVerifyAccessTokenOptions) => Promise<FFIDApiResponse<FFIDOAuthUserInfo>>;
-    getSubscribeUrl: (options?: ContractWizardSubscribeOptions) => string;
-    redirectToSubscribe: (options?: ContractWizardSubscribeOptions) => FFIDRedirectResult;
-    getChangePlanUrl: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => string;
-    redirectToChangePlan: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => FFIDRedirectResult;
-    getChangeSeatsUrl: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => string;
-    redirectToChangeSeats: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => FFIDRedirectResult;
-    getRecoverPaymentUrl: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => string;
-    redirectToRecoverPayment: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => FFIDRedirectResult;
-    getResubscribeUrl: (options?: ContractWizardResubscribeOptions) => string;
-    redirectToResubscribe: (options?: ContractWizardResubscribeOptions) => FFIDRedirectResult;
-    requestPasswordReset: (email: string) => Promise<FFIDApiResponse<FFIDPasswordResetResponse>>;
-    verifyPasswordResetToken: (accessToken: string) => Promise<FFIDApiResponse<FFIDPasswordResetVerifyResponse>>;
-    establishResetSession: (accessToken: string, refreshToken: string) => Promise<FFIDApiResponse<FFIDResetSessionResponse>>;
-    confirmPasswordReset: (password: string) => Promise<FFIDApiResponse<FFIDPasswordResetConfirmResponse>>;
-    sendOtp: (email: string, options?: {
-        redirectUrl?: string;
-    }) => Promise<FFIDApiResponse<FFIDOtpSendResponse>>;
-    verifyOtp: (params: {
-        accessToken: string;
-        refreshToken: string;
-    }) => Promise<FFIDApiResponse<FFIDOtpVerifyResponse>>;
-    /** Newsletter methods (subscribe / confirm / unsubscribe) */
-    newsletter: {
-        subscribe: (params: FFIDNewsletterSubscribeParams) => Promise<FFIDApiResponse<FFIDNewsletterSubscribeResponse>>;
-        confirm: (params: FFIDNewsletterConfirmParams) => Promise<FFIDApiResponse<FFIDNewsletterConfirmResponse>>;
-        unsubscribe: (params: FFIDNewsletterUnsubscribeParams) => Promise<FFIDApiResponse<FFIDNewsletterUnsubscribeResponse>>;
-    };
-    /** Inquiry methods (create) */
-    inquiry: {
-        create: (params: FFIDInquiryCreateParams) => Promise<FFIDApiResponse<FFIDInquiryCreateResponse>>;
-    };
-    /** Token store (token mode only) */
-    tokenStore: TokenStore;
-    /** Resolved auth mode */
-    authMode: FFIDAuthMode;
-    /** Resolved logger instance */
-    logger: FFIDLogger;
-    baseUrl: string;
-    serviceCode: string;
-    clientId: string;
-    redirectUri: string | null;
-};
-/** Type of the FFID client */
-type FFIDClient = ReturnType<typeof createFFIDClient>;
-
 /** Token verification - verifyAccessToken() implementation */
 
 /** Dependencies required by verifyAccessToken */
@@ -1176,4 +56,4 @@ interface KVNamespaceLike {
  */
 declare function createKVCacheAdapter(kv: KVNamespaceLike): FFIDCacheAdapter;
 
-export { type FFIDCacheAdapter, type FFIDCacheConfig, type FFIDClient, type FFIDConfig, type FFIDOAuthUserInfo, type FFIDOrganization, type FFIDOtpSendResponse, type FFIDOtpVerifyResponse, type FFIDPasswordResetConfirmResponse, type FFIDPasswordResetResponse, type FFIDPasswordResetVerifyResponse, type FFIDProfileCallOptions, type FFIDResetSessionResponse, type FFIDSubscription, type FFIDUpdateUserProfileRequest, type FFIDUser, type FFIDUserProfile, type FFIDVerifyAccessTokenOptions, type KVNamespaceLike, type TokenData, type TokenStore, createFFIDClient, createKVCacheAdapter, createMemoryCacheAdapter, createTokenStore, createVerifyAccessToken };
+export { FFIDCacheAdapter, FFIDOAuthUserInfo, FFIDVerifyAccessTokenOptions, type KVNamespaceLike, createKVCacheAdapter, createMemoryCacheAdapter, createVerifyAccessToken };