@feelflow/ffid-sdk 3.0.0 → 4.0.0

package/dist/{chunk-XWI4BFKW.js → chunk-P35ULJLM.js}

@@ -806,7 +806,7 @@ function createProfileMethods(deps) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "3.0.0";
+var SDK_VERSION = "4.0.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {
@@ -1367,6 +1367,8 @@ function base64UrlEncode(buffer) {
 // src/client/redirect.ts
 var OAUTH_AUTHORIZE_ENDPOINT = "/api/v1/oauth/authorize";
 var AUTH_LOGOUT_ENDPOINT = "/api/v1/auth/logout";
+var SCREEN_HINT_SIGNUP = "signup";
+var SCREEN_HINT_PARAM = "screen_hint";
 var STATE_RANDOM_BYTES = 16;
 var HEX_BASE2 = 16;
 var REDIRECT_LOOP_KEY = "ffid_sdk_redirect_loop_history";
@@ -1534,6 +1536,9 @@ function createRedirectMethods(deps) {
       }
       params.set("organization_id", trimmedOrgId);
     }
+    if (options?.screenHint === SCREEN_HINT_SIGNUP) {
+      params.set(SCREEN_HINT_PARAM, SCREEN_HINT_SIGNUP);
+    }
     const authorizeUrl = `${baseUrl}${OAUTH_AUTHORIZE_ENDPOINT}?${params.toString()}`;
     logger.debug("Redirecting to authorize:", authorizeUrl);
     recordRedirectAttempt(authorizeKey, now, logger);
@@ -1545,18 +1550,17 @@ function createRedirectMethods(deps) {
     }
     return { success: true };
   }
-  async function redirectToLogin() {
+  async function redirectToLogin(options) {
     if (typeof window === "undefined") {
       logger.warn("SSR \u74B0\u5883\u3067\u306F\u30EA\u30C0\u30A4\u30EC\u30AF\u30C8\u3067\u304D\u307E\u305B\u3093");
       return { success: false, error: "SSR \u74B0\u5883\u3067\u306F\u30EA\u30C0\u30A4\u30EC\u30AF\u30C8\u3067\u304D\u307E\u305B\u3093" };
     }
     if (authMode === "token") {
-      return redirectToAuthorize();
+      return redirectToAuthorize(options);
     }
-    const currentUrl = window.location.href;
-    const loginUrl = `${baseUrl}/login?redirect=${encodeURIComponent(currentUrl)}&service=${encodeURIComponent(serviceCode)}`;
-    logger.debug("Redirecting to login:", loginUrl);
-    window.location.href = loginUrl;
+    const targetUrl = options?.screenHint === SCREEN_HINT_SIGNUP ? getSignupUrl() : getLoginUrl();
+    logger.debug("Redirecting to auth page:", targetUrl);
+    window.location.href = targetUrl;
     return { success: true };
   }
   function getLoginUrl(redirectUrl) {
@@ -2689,8 +2693,8 @@ function FFIDProvider({
       setIsLoading(false);
     }
   }, [client]);
-  const login = useCallback(() => {
-    client.redirectToLogin().catch((err) => {
+  const login = useCallback((options) => {
+    client.redirectToLogin(options).catch((err) => {
       client.logger.error("\u30ED\u30B0\u30A4\u30F3\u30EA\u30C0\u30A4\u30EC\u30AF\u30C8\u306B\u5931\u6557\u3057\u307E\u3057\u305F:", err);
     });
   }, [client]);
@@ -4119,6 +4123,7 @@ var DEFAULT_CATEGORY_LABELS_JA = {
 };
 function defaultCategories() {
   return FFID_INQUIRY_CATEGORIES.map((value) => ({
+    kind: "flat",
     value,
     label: DEFAULT_CATEGORY_LABELS_JA[value]
   }));
@@ -4128,7 +4133,7 @@ function warnOnGroupLabelConflicts(options) {
   const firstExplicitLabel = /* @__PURE__ */ new Map();
   const warnedGroups = /* @__PURE__ */ new Set();
   for (const opt of options) {
-    if (!opt.group || opt.groupLabel === void 0) continue;
+    if (opt.kind !== "grouped") continue;
     const firstLabel = firstExplicitLabel.get(opt.group);
     if (firstLabel === void 0) {
       firstExplicitLabel.set(opt.group, opt.groupLabel);
@@ -4141,20 +4146,22 @@ function warnOnGroupLabelConflicts(options) {
   }
 }
 function renderCategoryOptions(options) {
-  const hasAnyGroup = options.some((o) => !!o.group);
+  const hasAnyGroup = options.some((o) => o.kind === "grouped");
   if (!hasAnyGroup) {
     return options.map((opt) => /* @__PURE__ */ jsx("option", { value: opt.value, children: opt.label }, opt.value));
   }
-  const ungrouped = options.filter((o) => !o.group);
+  const ungrouped = options.filter(
+    (o) => o.kind === "flat"
+  );
   const groupKeys = [];
   const groupLabelByKey = /* @__PURE__ */ new Map();
   const itemsByKey = /* @__PURE__ */ new Map();
   for (const opt of options) {
-    if (!opt.group) continue;
+    if (opt.kind !== "grouped") continue;
     if (!itemsByKey.has(opt.group)) {
       groupKeys.push(opt.group);
       itemsByKey.set(opt.group, []);
-      groupLabelByKey.set(opt.group, opt.groupLabel ?? opt.group);
+      groupLabelByKey.set(opt.group, opt.groupLabel);
     }
     itemsByKey.get(opt.group).push(opt);
   }
@@ -4177,7 +4184,7 @@ function FFIDInquiryForm({
   turnstileSlot,
   onSubmit,
   onChange,
-  separateLegalCheckboxes = false,
+  legalLayout = "combined",
   messagePlaceholder,
   requireCategorySelection = false,
   unstyled = false,
@@ -4188,6 +4195,7 @@ function FFIDInquiryForm({
   const isAuth = mode === "authenticated";
   const isNameReadOnly = isAuth && !!prefill?.name;
   const isEmailReadOnly = isAuth;
+  const usesSeparateLegalCheckboxes = legalLayout === "separate";
   const categoryOptions = useMemo(
     () => categories && categories.length > 0 ? categories : defaultCategories(),
     [categories]
@@ -4283,7 +4291,7 @@ function FFIDInquiryForm({
   async function handleSubmit(e) {
     e.preventDefault();
     setFormError(null);
-    if (separateLegalCheckboxes) {
+    if (usesSeparateLegalCheckboxes) {
       const termsInvalid = !agreedTerms;
       const privacyInvalid = !agreedPrivacy;
       setAgreedTermsError(termsInvalid);
@@ -4545,7 +4553,7 @@ function FFIDInquiryForm({
             ]
           }
         ),
-        separateLegalCheckboxes ? /* @__PURE__ */ jsxs("div", { style: s(fieldsetStyle), className: classNames?.legalBlock, children: [
+        usesSeparateLegalCheckboxes ? /* @__PURE__ */ jsxs("div", { style: s(fieldsetStyle), className: classNames?.legalBlock, children: [
           /* @__PURE__ */ jsxs("label", { style: s(legalRowFirst), className: classNames?.legalRow, children: [
             /* @__PURE__ */ jsx(
               "input",

package/dist/{chunk-JNR4AKL5.cjs → chunk-XQL4YSTL.cjs}

@@ -808,7 +808,7 @@ function createProfileMethods(deps) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "3.0.0";
+var SDK_VERSION = "4.0.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {
@@ -1369,6 +1369,8 @@ function base64UrlEncode(buffer) {
 // src/client/redirect.ts
 var OAUTH_AUTHORIZE_ENDPOINT = "/api/v1/oauth/authorize";
 var AUTH_LOGOUT_ENDPOINT = "/api/v1/auth/logout";
+var SCREEN_HINT_SIGNUP = "signup";
+var SCREEN_HINT_PARAM = "screen_hint";
 var STATE_RANDOM_BYTES = 16;
 var HEX_BASE2 = 16;
 var REDIRECT_LOOP_KEY = "ffid_sdk_redirect_loop_history";
@@ -1536,6 +1538,9 @@ function createRedirectMethods(deps) {
       }
       params.set("organization_id", trimmedOrgId);
     }
+    if (options?.screenHint === SCREEN_HINT_SIGNUP) {
+      params.set(SCREEN_HINT_PARAM, SCREEN_HINT_SIGNUP);
+    }
     const authorizeUrl = `${baseUrl}${OAUTH_AUTHORIZE_ENDPOINT}?${params.toString()}`;
     logger.debug("Redirecting to authorize:", authorizeUrl);
     recordRedirectAttempt(authorizeKey, now, logger);
@@ -1547,18 +1552,17 @@ function createRedirectMethods(deps) {
     }
     return { success: true };
   }
-  async function redirectToLogin() {
+  async function redirectToLogin(options) {
     if (typeof window === "undefined") {
       logger.warn("SSR \u74B0\u5883\u3067\u306F\u30EA\u30C0\u30A4\u30EC\u30AF\u30C8\u3067\u304D\u307E\u305B\u3093");
       return { success: false, error: "SSR \u74B0\u5883\u3067\u306F\u30EA\u30C0\u30A4\u30EC\u30AF\u30C8\u3067\u304D\u307E\u305B\u3093" };
     }
     if (authMode === "token") {
-      return redirectToAuthorize();
+      return redirectToAuthorize(options);
     }
-    const currentUrl = window.location.href;
-    const loginUrl = `${baseUrl}/login?redirect=${encodeURIComponent(currentUrl)}&service=${encodeURIComponent(serviceCode)}`;
-    logger.debug("Redirecting to login:", loginUrl);
-    window.location.href = loginUrl;
+    const targetUrl = options?.screenHint === SCREEN_HINT_SIGNUP ? getSignupUrl() : getLoginUrl();
+    logger.debug("Redirecting to auth page:", targetUrl);
+    window.location.href = targetUrl;
     return { success: true };
   }
   function getLoginUrl(redirectUrl) {
@@ -2691,8 +2695,8 @@ function FFIDProvider({
       setIsLoading(false);
     }
   }, [client]);
-  const login = react.useCallback(() => {
-    client.redirectToLogin().catch((err) => {
+  const login = react.useCallback((options) => {
+    client.redirectToLogin(options).catch((err) => {
       client.logger.error("\u30ED\u30B0\u30A4\u30F3\u30EA\u30C0\u30A4\u30EC\u30AF\u30C8\u306B\u5931\u6557\u3057\u307E\u3057\u305F:", err);
     });
   }, [client]);
@@ -4121,6 +4125,7 @@ var DEFAULT_CATEGORY_LABELS_JA = {
 };
 function defaultCategories() {
   return FFID_INQUIRY_CATEGORIES.map((value) => ({
+    kind: "flat",
     value,
     label: DEFAULT_CATEGORY_LABELS_JA[value]
   }));
@@ -4130,7 +4135,7 @@ function warnOnGroupLabelConflicts(options) {
   const firstExplicitLabel = /* @__PURE__ */ new Map();
   const warnedGroups = /* @__PURE__ */ new Set();
   for (const opt of options) {
-    if (!opt.group || opt.groupLabel === void 0) continue;
+    if (opt.kind !== "grouped") continue;
     const firstLabel = firstExplicitLabel.get(opt.group);
     if (firstLabel === void 0) {
       firstExplicitLabel.set(opt.group, opt.groupLabel);
@@ -4143,20 +4148,22 @@ function warnOnGroupLabelConflicts(options) {
   }
 }
 function renderCategoryOptions(options) {
-  const hasAnyGroup = options.some((o) => !!o.group);
+  const hasAnyGroup = options.some((o) => o.kind === "grouped");
   if (!hasAnyGroup) {
     return options.map((opt) => /* @__PURE__ */ jsxRuntime.jsx("option", { value: opt.value, children: opt.label }, opt.value));
   }
-  const ungrouped = options.filter((o) => !o.group);
+  const ungrouped = options.filter(
+    (o) => o.kind === "flat"
+  );
   const groupKeys = [];
   const groupLabelByKey = /* @__PURE__ */ new Map();
   const itemsByKey = /* @__PURE__ */ new Map();
   for (const opt of options) {
-    if (!opt.group) continue;
+    if (opt.kind !== "grouped") continue;
     if (!itemsByKey.has(opt.group)) {
       groupKeys.push(opt.group);
       itemsByKey.set(opt.group, []);
-      groupLabelByKey.set(opt.group, opt.groupLabel ?? opt.group);
+      groupLabelByKey.set(opt.group, opt.groupLabel);
     }
     itemsByKey.get(opt.group).push(opt);
   }
@@ -4179,7 +4186,7 @@ function FFIDInquiryForm({
   turnstileSlot,
   onSubmit,
   onChange,
-  separateLegalCheckboxes = false,
+  legalLayout = "combined",
   messagePlaceholder,
   requireCategorySelection = false,
   unstyled = false,
@@ -4190,6 +4197,7 @@ function FFIDInquiryForm({
   const isAuth = mode === "authenticated";
   const isNameReadOnly = isAuth && !!prefill?.name;
   const isEmailReadOnly = isAuth;
+  const usesSeparateLegalCheckboxes = legalLayout === "separate";
   const categoryOptions = react.useMemo(
     () => categories && categories.length > 0 ? categories : defaultCategories(),
     [categories]
@@ -4285,7 +4293,7 @@ function FFIDInquiryForm({
   async function handleSubmit(e) {
     e.preventDefault();
     setFormError(null);
-    if (separateLegalCheckboxes) {
+    if (usesSeparateLegalCheckboxes) {
       const termsInvalid = !agreedTerms;
       const privacyInvalid = !agreedPrivacy;
       setAgreedTermsError(termsInvalid);
@@ -4547,7 +4555,7 @@ function FFIDInquiryForm({
             ]
           }
         ),
-        separateLegalCheckboxes ? /* @__PURE__ */ jsxRuntime.jsxs("div", { style: s(fieldsetStyle), className: classNames?.legalBlock, children: [
+        usesSeparateLegalCheckboxes ? /* @__PURE__ */ jsxRuntime.jsxs("div", { style: s(fieldsetStyle), className: classNames?.legalBlock, children: [
           /* @__PURE__ */ jsxRuntime.jsxs("label", { style: s(legalRowFirst), className: classNames?.legalRow, children: [
             /* @__PURE__ */ jsxRuntime.jsx(
               "input",

package/dist/components/index.cjs

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

package/dist/components/index.d.cts

@@ -1,3 +1,3 @@
-export { N as FFIDAnnouncementBadge, am as FFIDAnnouncementBadgeClassNames, an as FFIDAnnouncementBadgeProps, O as FFIDAnnouncementList, ao as FFIDAnnouncementListClassNames, ap as FFIDAnnouncementListProps, W as FFIDInquiryForm, X as FFIDInquiryFormCategoryItem, Y as FFIDInquiryFormClassNames, Z as FFIDInquiryFormOrganization, _ as FFIDInquiryFormPlaceholderContext, $ as FFIDInquiryFormPrefill, a0 as FFIDInquiryFormProps, a1 as FFIDInquiryFormSubmitData, a2 as FFIDInquiryFormSubmitResult, a4 as FFIDLoginButton, aq as FFIDLoginButtonProps, aa as FFIDOrganizationSwitcher, ar as FFIDOrganizationSwitcherClassNames, as as FFIDOrganizationSwitcherProps, ad as FFIDSubscriptionBadge, at as FFIDSubscriptionBadgeClassNames, au as FFIDSubscriptionBadgeProps, af as FFIDUserMenu, av as FFIDUserMenuClassNames, aw as FFIDUserMenuProps } from '../index-C3zyNa4j.cjs';
+export { N as FFIDAnnouncementBadge, an as FFIDAnnouncementBadgeClassNames, ao as FFIDAnnouncementBadgeProps, O as FFIDAnnouncementList, ap as FFIDAnnouncementListClassNames, aq as FFIDAnnouncementListProps, W as FFIDInquiryForm, X as FFIDInquiryFormCategoryItem, Y as FFIDInquiryFormClassNames, Z as FFIDInquiryFormLegalLayout, _ as FFIDInquiryFormOrganization, $ as FFIDInquiryFormPlaceholderContext, a0 as FFIDInquiryFormPrefill, a1 as FFIDInquiryFormProps, a2 as FFIDInquiryFormSubmitData, a3 as FFIDInquiryFormSubmitResult, a5 as FFIDLoginButton, ar as FFIDLoginButtonProps, ab as FFIDOrganizationSwitcher, as as FFIDOrganizationSwitcherClassNames, at as FFIDOrganizationSwitcherProps, ae as FFIDSubscriptionBadge, au as FFIDSubscriptionBadgeClassNames, av as FFIDSubscriptionBadgeProps, ag as FFIDUserMenu, aw as FFIDUserMenuClassNames, ax as FFIDUserMenuProps } from '../index-Cn8-3hgb.cjs';
 import 'react/jsx-runtime';
 import 'react';

package/dist/components/index.d.ts

@@ -1,3 +1,3 @@
-export { N as FFIDAnnouncementBadge, am as FFIDAnnouncementBadgeClassNames, an as FFIDAnnouncementBadgeProps, O as FFIDAnnouncementList, ao as FFIDAnnouncementListClassNames, ap as FFIDAnnouncementListProps, W as FFIDInquiryForm, X as FFIDInquiryFormCategoryItem, Y as FFIDInquiryFormClassNames, Z as FFIDInquiryFormOrganization, _ as FFIDInquiryFormPlaceholderContext, $ as FFIDInquiryFormPrefill, a0 as FFIDInquiryFormProps, a1 as FFIDInquiryFormSubmitData, a2 as FFIDInquiryFormSubmitResult, a4 as FFIDLoginButton, aq as FFIDLoginButtonProps, aa as FFIDOrganizationSwitcher, ar as FFIDOrganizationSwitcherClassNames, as as FFIDOrganizationSwitcherProps, ad as FFIDSubscriptionBadge, at as FFIDSubscriptionBadgeClassNames, au as FFIDSubscriptionBadgeProps, af as FFIDUserMenu, av as FFIDUserMenuClassNames, aw as FFIDUserMenuProps } from '../index-C3zyNa4j.js';
+export { N as FFIDAnnouncementBadge, an as FFIDAnnouncementBadgeClassNames, ao as FFIDAnnouncementBadgeProps, O as FFIDAnnouncementList, ap as FFIDAnnouncementListClassNames, aq as FFIDAnnouncementListProps, W as FFIDInquiryForm, X as FFIDInquiryFormCategoryItem, Y as FFIDInquiryFormClassNames, Z as FFIDInquiryFormLegalLayout, _ as FFIDInquiryFormOrganization, $ as FFIDInquiryFormPlaceholderContext, a0 as FFIDInquiryFormPrefill, a1 as FFIDInquiryFormProps, a2 as FFIDInquiryFormSubmitData, a3 as FFIDInquiryFormSubmitResult, a5 as FFIDLoginButton, ar as FFIDLoginButtonProps, ab as FFIDOrganizationSwitcher, as as FFIDOrganizationSwitcherClassNames, at as FFIDOrganizationSwitcherProps, ae as FFIDSubscriptionBadge, au as FFIDSubscriptionBadgeClassNames, av as FFIDSubscriptionBadgeProps, ag as FFIDUserMenu, aw as FFIDUserMenuClassNames, ax as FFIDUserMenuProps } from '../index-Cn8-3hgb.js';
 import 'react/jsx-runtime';
 import 'react';

package/dist/components/index.js

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

package/dist/{ffid-client-B26jbUp5.d.cts → ffid-client-ZcJhRbD6.d.cts}

@@ -1056,10 +1056,30 @@ interface ContractWizardSubscriptionOptions {
 
 /** Redirect and URL generation - redirectToLogin / redirectToAuthorize / redirectToLogout / getLoginUrl / getSignupUrl / getLogoutUrl */
 
+/**
+ * `screen_hint=signup` query value for `/oauth/authorize` (#2908 / #2911).
+ * Forwards to Supabase Auth signup screen; only the `'signup'` value is
+ * propagated (no-op when `'login'` or omitted).
+ */
+declare const SCREEN_HINT_SIGNUP: "signup";
 /** Options for redirectToAuthorize */
 interface RedirectToAuthorizeOptions {
     /** Target organization ID — triggers org-scoped OAuth re-authorization */
     organizationId?: string;
+    /**
+     * Initial Supabase Auth screen hint (#2908 / #2911).
+     *
+     * - `'signup'`: forwards `?screen_hint=signup` so the FFID OAuth flow lands
+     *   on the signup screen (used by external services that want to deep-link
+     *   new users into the signup CTA).
+     * - `'login'` / `undefined`: no `screen_hint` param is added — the default
+     *   login screen is shown.
+     *
+     * In cookie mode, `'signup'` redirects to the FFID `/signup` page instead
+     * of `/login` so the SDK contract (signup-screen intent) stays consistent
+     * regardless of `authMode`.
+     */
+    screenHint?: typeof SCREEN_HINT_SIGNUP | 'login';
 }
 
 /**
@@ -1107,7 +1127,7 @@ declare function createTokenStore(storageType?: 'localStorage' | 'memory'): Toke
 declare function createFFIDClient(config: FFIDConfig): {
     getSession: () => Promise<FFIDApiResponse<FFIDSessionResponse>>;
     signOut: () => Promise<FFIDApiResponse<void>>;
-    redirectToLogin: () => Promise<FFIDRedirectResult>;
+    redirectToLogin: (options?: RedirectToAuthorizeOptions) => Promise<FFIDRedirectResult>;
     redirectToAuthorize: (options?: RedirectToAuthorizeOptions) => Promise<FFIDRedirectResult>;
     redirectToLogout: (postLogoutRedirectUri?: string) => FFIDRedirectResult;
     getLoginUrl: (redirectUrl?: string) => string;

package/dist/{ffid-client-B26jbUp5.d.ts → ffid-client-ZcJhRbD6.d.ts}

@@ -1056,10 +1056,30 @@ interface ContractWizardSubscriptionOptions {
 
 /** Redirect and URL generation - redirectToLogin / redirectToAuthorize / redirectToLogout / getLoginUrl / getSignupUrl / getLogoutUrl */
 
+/**
+ * `screen_hint=signup` query value for `/oauth/authorize` (#2908 / #2911).
+ * Forwards to Supabase Auth signup screen; only the `'signup'` value is
+ * propagated (no-op when `'login'` or omitted).
+ */
+declare const SCREEN_HINT_SIGNUP: "signup";
 /** Options for redirectToAuthorize */
 interface RedirectToAuthorizeOptions {
     /** Target organization ID — triggers org-scoped OAuth re-authorization */
     organizationId?: string;
+    /**
+     * Initial Supabase Auth screen hint (#2908 / #2911).
+     *
+     * - `'signup'`: forwards `?screen_hint=signup` so the FFID OAuth flow lands
+     *   on the signup screen (used by external services that want to deep-link
+     *   new users into the signup CTA).
+     * - `'login'` / `undefined`: no `screen_hint` param is added — the default
+     *   login screen is shown.
+     *
+     * In cookie mode, `'signup'` redirects to the FFID `/signup` page instead
+     * of `/login` so the SDK contract (signup-screen intent) stays consistent
+     * regardless of `authMode`.
+     */
+    screenHint?: typeof SCREEN_HINT_SIGNUP | 'login';
 }
 
 /**
@@ -1107,7 +1127,7 @@ declare function createTokenStore(storageType?: 'localStorage' | 'memory'): Toke
 declare function createFFIDClient(config: FFIDConfig): {
     getSession: () => Promise<FFIDApiResponse<FFIDSessionResponse>>;
     signOut: () => Promise<FFIDApiResponse<void>>;
-    redirectToLogin: () => Promise<FFIDRedirectResult>;
+    redirectToLogin: (options?: RedirectToAuthorizeOptions) => Promise<FFIDRedirectResult>;
     redirectToAuthorize: (options?: RedirectToAuthorizeOptions) => Promise<FFIDRedirectResult>;
     redirectToLogout: (postLogoutRedirectUri?: string) => FFIDRedirectResult;
     getLoginUrl: (redirectUrl?: string) => string;

package/dist/{index-C3zyNa4j.d.cts → index-Cn8-3hgb.d.cts}

@@ -302,8 +302,17 @@ interface FFIDContextValue {
     isAuthenticated: boolean;
     /** Any authentication error */
     error: FFIDError | null;
-    /** Redirect to FFID login page */
-    login: () => void;
+    /**
+     * Redirect to FFID login page.
+     *
+     * @param options.screenHint `'signup'` to deep-link into the signup screen
+     *   (forwards `screen_hint=signup` in token mode / redirects to `/signup`
+     *   in cookie mode). `'login'` and `undefined` use the default login flow.
+     *   See `RedirectToAuthorizeOptions` (#2908 / #2911).
+     */
+    login: (options?: {
+        screenHint?: 'signup' | 'login';
+    }) => void;
     /** Sign out and clear session */
     logout: () => Promise<void>;
     /**
@@ -1194,13 +1203,24 @@ declare function FFIDAnnouncementList({ announcements, isLoading, className, cla
  * The single source of truth for consumers is `FFIDInquiryForm.tsx`.
  */
 
-/** Category option rendered in the form select. */
-interface FFIDInquiryFormCategoryItem {
+/** Legal agreement layout rendered by the inquiry form. */
+type FFIDInquiryFormLegalLayout = 'combined' | 'separate';
+/** Category option rendered as a top-level `<option>`. */
+interface FFIDInquiryFormFlatCategoryItem {
+    kind: 'flat';
     value: string;
     label: string;
-    group?: string;
-    groupLabel?: string;
 }
+/** Category option rendered inside an `<optgroup>`. */
+interface FFIDInquiryFormGroupedCategoryItem {
+    kind: 'grouped';
+    value: string;
+    label: string;
+    group: string;
+    groupLabel: string;
+}
+/** Category option rendered in the form select. */
+type FFIDInquiryFormCategoryItem = FFIDInquiryFormFlatCategoryItem | FFIDInquiryFormGroupedCategoryItem;
 /**
  * Per-slot `className` overrides. Every key is optional; when omitted,
  * the slot falls back to SDK defaults. Intended to be combined with
@@ -1365,11 +1385,11 @@ interface FFIDInquiryFormProps {
      */
     onChange?: (data: FFIDInquiryFormSubmitData) => void;
     /**
-     * When true, renders the legal agreement as two independent checkboxes
-     * (terms and privacy). Defaults to `false`, preserving the combined
-     * single-checkbox behavior from SDK ≤ 2.8.
+     * Controls whether legal agreement is rendered as one combined checkbox
+     * or two independent terms / privacy checkboxes. Defaults to `combined`,
+     * preserving the single-checkbox behavior from SDK ≤ 3.x.
      */
-    separateLegalCheckboxes?: boolean;
+    legalLayout?: FFIDInquiryFormLegalLayout;
     /**
      * Overrides the `<textarea>` placeholder. A plain string is applied
      * verbatim; a function is called with the currently selected category
@@ -1420,6 +1440,6 @@ interface FFIDInquiryFormProps {
 interface FFIDInquiryFormPlaceholderContext {
     category: string | null;
 }
-declare function FFIDInquiryForm({ mode, prefill, organizations, preselectedOrganizationId, categories, termsVersion, privacyVersion, termsHref, privacyHref, turnstileToken, turnstileSlot, onSubmit, onChange, separateLegalCheckboxes, messagePlaceholder, requireCategorySelection, unstyled, classNames, locale, className, }: FFIDInquiryFormProps): react_jsx_runtime.JSX.Element;
+declare function FFIDInquiryForm({ mode, prefill, organizations, preselectedOrganizationId, categories, termsVersion, privacyVersion, termsHref, privacyHref, turnstileToken, turnstileSlot, onSubmit, onChange, legalLayout, messagePlaceholder, requireCategorySelection, unstyled, classNames, locale, className, }: FFIDInquiryFormProps): react_jsx_runtime.JSX.Element;
 
-export { type FFIDInquiryFormPrefill as $, type FFIDOrganization as A, type FFIDSubscription as B, type FFIDSubscriptionContextValue as C, type FFIDAnnouncementsClientConfig as D, type EffectiveSubscriptionStatus as E, type FFIDSubscriptionStatus as F, type FFIDAnnouncementsApiResponse as G, type AnnouncementListResponse as H, type FFIDAnnouncementsLogger as I, type Announcement as J, type AnnouncementStatus as K, type ListAnnouncementsOptions as L, type AnnouncementType as M, FFIDAnnouncementBadge as N, FFIDAnnouncementList as O, type FFIDAnnouncementsError as P, type FFIDAnnouncementsErrorCode as Q, type FFIDAnnouncementsServerResponse as R, type FFIDCacheConfig as S, type FFIDContextValue as T, type FFIDInquiryCategory as U, type FFIDInquiryCategorySite2026 as V, FFIDInquiryForm as W, type FFIDInquiryFormCategoryItem as X, type FFIDInquiryFormClassNames as Y, type FFIDInquiryFormOrganization as Z, type FFIDInquiryFormPlaceholderContext as _, type FFIDConfig as a, type FFIDInquiryFormProps as a0, type FFIDInquiryFormSubmitData as a1, type FFIDInquiryFormSubmitResult as a2, type FFIDJwtClaims as a3, FFIDLoginButton as a4, type FFIDMemberStatus as a5, type FFIDOAuthTokenResponse as a6, type FFIDOAuthUserInfoMemberRole as a7, type FFIDOAuthUserInfoSubscription as a8, type FFIDOrganizationMember as a9, FFIDOrganizationSwitcher as aa, type FFIDRedirectErrorCode as ab, type FFIDSeatModel as ac, FFIDSubscriptionBadge as ad, type FFIDTokenIntrospectionResponse as ae, FFIDUserMenu as af, FFID_INQUIRY_CATEGORIES as ag, FFID_INQUIRY_CATEGORIES_SITE_2026 as ah, type UseFFIDAnnouncementsOptions as ai, type UseFFIDAnnouncementsReturn as aj, isFFIDInquiryCategorySite2026 as ak, useFFIDAnnouncements as al, type FFIDAnnouncementBadgeClassNames as am, type FFIDAnnouncementBadgeProps as an, type FFIDAnnouncementListClassNames as ao, type FFIDAnnouncementListProps as ap, type FFIDLoginButtonProps as aq, type FFIDOrganizationSwitcherClassNames as ar, type FFIDOrganizationSwitcherProps as as, type FFIDSubscriptionBadgeClassNames as at, type FFIDSubscriptionBadgeProps as au, type FFIDUserMenuClassNames as av, type FFIDUserMenuProps as aw, type FFIDApiResponse as b, type FFIDSessionResponse as c, type FFIDRedirectResult as d, type FFIDError as e, type FFIDSubscriptionCheckResponse as f, type FFIDListMembersResponse as g, type FFIDMemberRole as h, type FFIDUpdateMemberRoleResponse as i, type FFIDRemoveMemberResponse as j, type FFIDProfileCallOptions as k, type FFIDUserProfile as l, type FFIDUpdateUserProfileRequest as m, type FFIDAnalyticsConfig as n, type FFIDCreateCheckoutParams as o, type FFIDCheckoutSessionResponse as p, type FFIDCreatePortalParams as q, type FFIDPortalSessionResponse as r, type FFIDVerifyAccessTokenOptions as s, type FFIDOAuthUserInfo as t, type FFIDInquiryCreateParams as u, type FFIDInquiryCreateResponse as v, type FFIDAuthMode as w, type FFIDLogger as x, type FFIDCacheAdapter as y, type FFIDUser as z };
+export { type FFIDInquiryFormPlaceholderContext as $, type FFIDOrganization as A, type FFIDSubscription as B, type FFIDSubscriptionContextValue as C, type FFIDAnnouncementsClientConfig as D, type EffectiveSubscriptionStatus as E, type FFIDSubscriptionStatus as F, type FFIDAnnouncementsApiResponse as G, type AnnouncementListResponse as H, type FFIDAnnouncementsLogger as I, type Announcement as J, type AnnouncementStatus as K, type ListAnnouncementsOptions as L, type AnnouncementType as M, FFIDAnnouncementBadge as N, FFIDAnnouncementList as O, type FFIDAnnouncementsError as P, type FFIDAnnouncementsErrorCode as Q, type FFIDAnnouncementsServerResponse as R, type FFIDCacheConfig as S, type FFIDContextValue as T, type FFIDInquiryCategory as U, type FFIDInquiryCategorySite2026 as V, FFIDInquiryForm as W, type FFIDInquiryFormCategoryItem as X, type FFIDInquiryFormClassNames as Y, type FFIDInquiryFormLegalLayout as Z, type FFIDInquiryFormOrganization as _, type FFIDConfig as a, type FFIDInquiryFormPrefill as a0, type FFIDInquiryFormProps as a1, type FFIDInquiryFormSubmitData as a2, type FFIDInquiryFormSubmitResult as a3, type FFIDJwtClaims as a4, FFIDLoginButton as a5, type FFIDMemberStatus as a6, type FFIDOAuthTokenResponse as a7, type FFIDOAuthUserInfoMemberRole as a8, type FFIDOAuthUserInfoSubscription as a9, type FFIDOrganizationMember as aa, FFIDOrganizationSwitcher as ab, type FFIDRedirectErrorCode as ac, type FFIDSeatModel as ad, FFIDSubscriptionBadge as ae, type FFIDTokenIntrospectionResponse as af, FFIDUserMenu as ag, FFID_INQUIRY_CATEGORIES as ah, FFID_INQUIRY_CATEGORIES_SITE_2026 as ai, type UseFFIDAnnouncementsOptions as aj, type UseFFIDAnnouncementsReturn as ak, isFFIDInquiryCategorySite2026 as al, useFFIDAnnouncements as am, type FFIDAnnouncementBadgeClassNames as an, type FFIDAnnouncementBadgeProps as ao, type FFIDAnnouncementListClassNames as ap, type FFIDAnnouncementListProps as aq, type FFIDLoginButtonProps as ar, type FFIDOrganizationSwitcherClassNames as as, type FFIDOrganizationSwitcherProps as at, type FFIDSubscriptionBadgeClassNames as au, type FFIDSubscriptionBadgeProps as av, type FFIDUserMenuClassNames as aw, type FFIDUserMenuProps as ax, type FFIDApiResponse as b, type FFIDSessionResponse as c, type FFIDRedirectResult as d, type FFIDError as e, type FFIDSubscriptionCheckResponse as f, type FFIDListMembersResponse as g, type FFIDMemberRole as h, type FFIDUpdateMemberRoleResponse as i, type FFIDRemoveMemberResponse as j, type FFIDProfileCallOptions as k, type FFIDUserProfile as l, type FFIDUpdateUserProfileRequest as m, type FFIDAnalyticsConfig as n, type FFIDCreateCheckoutParams as o, type FFIDCheckoutSessionResponse as p, type FFIDCreatePortalParams as q, type FFIDPortalSessionResponse as r, type FFIDVerifyAccessTokenOptions as s, type FFIDOAuthUserInfo as t, type FFIDInquiryCreateParams as u, type FFIDInquiryCreateResponse as v, type FFIDAuthMode as w, type FFIDLogger as x, type FFIDCacheAdapter as y, type FFIDUser as z };

package/dist/{index-C3zyNa4j.d.ts → index-Cn8-3hgb.d.ts}

@@ -302,8 +302,17 @@ interface FFIDContextValue {
     isAuthenticated: boolean;
     /** Any authentication error */
     error: FFIDError | null;
-    /** Redirect to FFID login page */
-    login: () => void;
+    /**
+     * Redirect to FFID login page.
+     *
+     * @param options.screenHint `'signup'` to deep-link into the signup screen
+     *   (forwards `screen_hint=signup` in token mode / redirects to `/signup`
+     *   in cookie mode). `'login'` and `undefined` use the default login flow.
+     *   See `RedirectToAuthorizeOptions` (#2908 / #2911).
+     */
+    login: (options?: {
+        screenHint?: 'signup' | 'login';
+    }) => void;
     /** Sign out and clear session */
     logout: () => Promise<void>;
     /**
@@ -1194,13 +1203,24 @@ declare function FFIDAnnouncementList({ announcements, isLoading, className, cla
  * The single source of truth for consumers is `FFIDInquiryForm.tsx`.
  */
 
-/** Category option rendered in the form select. */
-interface FFIDInquiryFormCategoryItem {
+/** Legal agreement layout rendered by the inquiry form. */
+type FFIDInquiryFormLegalLayout = 'combined' | 'separate';
+/** Category option rendered as a top-level `<option>`. */
+interface FFIDInquiryFormFlatCategoryItem {
+    kind: 'flat';
     value: string;
     label: string;
-    group?: string;
-    groupLabel?: string;
 }
+/** Category option rendered inside an `<optgroup>`. */
+interface FFIDInquiryFormGroupedCategoryItem {
+    kind: 'grouped';
+    value: string;
+    label: string;
+    group: string;
+    groupLabel: string;
+}
+/** Category option rendered in the form select. */
+type FFIDInquiryFormCategoryItem = FFIDInquiryFormFlatCategoryItem | FFIDInquiryFormGroupedCategoryItem;
 /**
  * Per-slot `className` overrides. Every key is optional; when omitted,
  * the slot falls back to SDK defaults. Intended to be combined with
@@ -1365,11 +1385,11 @@ interface FFIDInquiryFormProps {
      */
     onChange?: (data: FFIDInquiryFormSubmitData) => void;
     /**
-     * When true, renders the legal agreement as two independent checkboxes
-     * (terms and privacy). Defaults to `false`, preserving the combined
-     * single-checkbox behavior from SDK ≤ 2.8.
+     * Controls whether legal agreement is rendered as one combined checkbox
+     * or two independent terms / privacy checkboxes. Defaults to `combined`,
+     * preserving the single-checkbox behavior from SDK ≤ 3.x.
      */
-    separateLegalCheckboxes?: boolean;
+    legalLayout?: FFIDInquiryFormLegalLayout;
     /**
      * Overrides the `<textarea>` placeholder. A plain string is applied
      * verbatim; a function is called with the currently selected category
@@ -1420,6 +1440,6 @@ interface FFIDInquiryFormProps {
 interface FFIDInquiryFormPlaceholderContext {
     category: string | null;
 }
-declare function FFIDInquiryForm({ mode, prefill, organizations, preselectedOrganizationId, categories, termsVersion, privacyVersion, termsHref, privacyHref, turnstileToken, turnstileSlot, onSubmit, onChange, separateLegalCheckboxes, messagePlaceholder, requireCategorySelection, unstyled, classNames, locale, className, }: FFIDInquiryFormProps): react_jsx_runtime.JSX.Element;
+declare function FFIDInquiryForm({ mode, prefill, organizations, preselectedOrganizationId, categories, termsVersion, privacyVersion, termsHref, privacyHref, turnstileToken, turnstileSlot, onSubmit, onChange, legalLayout, messagePlaceholder, requireCategorySelection, unstyled, classNames, locale, className, }: FFIDInquiryFormProps): react_jsx_runtime.JSX.Element;
 
-export { type FFIDInquiryFormPrefill as $, type FFIDOrganization as A, type FFIDSubscription as B, type FFIDSubscriptionContextValue as C, type FFIDAnnouncementsClientConfig as D, type EffectiveSubscriptionStatus as E, type FFIDSubscriptionStatus as F, type FFIDAnnouncementsApiResponse as G, type AnnouncementListResponse as H, type FFIDAnnouncementsLogger as I, type Announcement as J, type AnnouncementStatus as K, type ListAnnouncementsOptions as L, type AnnouncementType as M, FFIDAnnouncementBadge as N, FFIDAnnouncementList as O, type FFIDAnnouncementsError as P, type FFIDAnnouncementsErrorCode as Q, type FFIDAnnouncementsServerResponse as R, type FFIDCacheConfig as S, type FFIDContextValue as T, type FFIDInquiryCategory as U, type FFIDInquiryCategorySite2026 as V, FFIDInquiryForm as W, type FFIDInquiryFormCategoryItem as X, type FFIDInquiryFormClassNames as Y, type FFIDInquiryFormOrganization as Z, type FFIDInquiryFormPlaceholderContext as _, type FFIDConfig as a, type FFIDInquiryFormProps as a0, type FFIDInquiryFormSubmitData as a1, type FFIDInquiryFormSubmitResult as a2, type FFIDJwtClaims as a3, FFIDLoginButton as a4, type FFIDMemberStatus as a5, type FFIDOAuthTokenResponse as a6, type FFIDOAuthUserInfoMemberRole as a7, type FFIDOAuthUserInfoSubscription as a8, type FFIDOrganizationMember as a9, FFIDOrganizationSwitcher as aa, type FFIDRedirectErrorCode as ab, type FFIDSeatModel as ac, FFIDSubscriptionBadge as ad, type FFIDTokenIntrospectionResponse as ae, FFIDUserMenu as af, FFID_INQUIRY_CATEGORIES as ag, FFID_INQUIRY_CATEGORIES_SITE_2026 as ah, type UseFFIDAnnouncementsOptions as ai, type UseFFIDAnnouncementsReturn as aj, isFFIDInquiryCategorySite2026 as ak, useFFIDAnnouncements as al, type FFIDAnnouncementBadgeClassNames as am, type FFIDAnnouncementBadgeProps as an, type FFIDAnnouncementListClassNames as ao, type FFIDAnnouncementListProps as ap, type FFIDLoginButtonProps as aq, type FFIDOrganizationSwitcherClassNames as ar, type FFIDOrganizationSwitcherProps as as, type FFIDSubscriptionBadgeClassNames as at, type FFIDSubscriptionBadgeProps as au, type FFIDUserMenuClassNames as av, type FFIDUserMenuProps as aw, type FFIDApiResponse as b, type FFIDSessionResponse as c, type FFIDRedirectResult as d, type FFIDError as e, type FFIDSubscriptionCheckResponse as f, type FFIDListMembersResponse as g, type FFIDMemberRole as h, type FFIDUpdateMemberRoleResponse as i, type FFIDRemoveMemberResponse as j, type FFIDProfileCallOptions as k, type FFIDUserProfile as l, type FFIDUpdateUserProfileRequest as m, type FFIDAnalyticsConfig as n, type FFIDCreateCheckoutParams as o, type FFIDCheckoutSessionResponse as p, type FFIDCreatePortalParams as q, type FFIDPortalSessionResponse as r, type FFIDVerifyAccessTokenOptions as s, type FFIDOAuthUserInfo as t, type FFIDInquiryCreateParams as u, type FFIDInquiryCreateResponse as v, type FFIDAuthMode as w, type FFIDLogger as x, type FFIDCacheAdapter as y, type FFIDUser as z };
+export { type FFIDInquiryFormPlaceholderContext as $, type FFIDOrganization as A, type FFIDSubscription as B, type FFIDSubscriptionContextValue as C, type FFIDAnnouncementsClientConfig as D, type EffectiveSubscriptionStatus as E, type FFIDSubscriptionStatus as F, type FFIDAnnouncementsApiResponse as G, type AnnouncementListResponse as H, type FFIDAnnouncementsLogger as I, type Announcement as J, type AnnouncementStatus as K, type ListAnnouncementsOptions as L, type AnnouncementType as M, FFIDAnnouncementBadge as N, FFIDAnnouncementList as O, type FFIDAnnouncementsError as P, type FFIDAnnouncementsErrorCode as Q, type FFIDAnnouncementsServerResponse as R, type FFIDCacheConfig as S, type FFIDContextValue as T, type FFIDInquiryCategory as U, type FFIDInquiryCategorySite2026 as V, FFIDInquiryForm as W, type FFIDInquiryFormCategoryItem as X, type FFIDInquiryFormClassNames as Y, type FFIDInquiryFormLegalLayout as Z, type FFIDInquiryFormOrganization as _, type FFIDConfig as a, type FFIDInquiryFormPrefill as a0, type FFIDInquiryFormProps as a1, type FFIDInquiryFormSubmitData as a2, type FFIDInquiryFormSubmitResult as a3, type FFIDJwtClaims as a4, FFIDLoginButton as a5, type FFIDMemberStatus as a6, type FFIDOAuthTokenResponse as a7, type FFIDOAuthUserInfoMemberRole as a8, type FFIDOAuthUserInfoSubscription as a9, type FFIDOrganizationMember as aa, FFIDOrganizationSwitcher as ab, type FFIDRedirectErrorCode as ac, type FFIDSeatModel as ad, FFIDSubscriptionBadge as ae, type FFIDTokenIntrospectionResponse as af, FFIDUserMenu as ag, FFID_INQUIRY_CATEGORIES as ah, FFID_INQUIRY_CATEGORIES_SITE_2026 as ai, type UseFFIDAnnouncementsOptions as aj, type UseFFIDAnnouncementsReturn as ak, isFFIDInquiryCategorySite2026 as al, useFFIDAnnouncements as am, type FFIDAnnouncementBadgeClassNames as an, type FFIDAnnouncementBadgeProps as ao, type FFIDAnnouncementListClassNames as ap, type FFIDAnnouncementListProps as aq, type FFIDLoginButtonProps as ar, type FFIDOrganizationSwitcherClassNames as as, type FFIDOrganizationSwitcherProps as at, type FFIDSubscriptionBadgeClassNames as au, type FFIDSubscriptionBadgeProps as av, type FFIDUserMenuClassNames as aw, type FFIDUserMenuProps as ax, type FFIDApiResponse as b, type FFIDSessionResponse as c, type FFIDRedirectResult as d, type FFIDError as e, type FFIDSubscriptionCheckResponse as f, type FFIDListMembersResponse as g, type FFIDMemberRole as h, type FFIDUpdateMemberRoleResponse as i, type FFIDRemoveMemberResponse as j, type FFIDProfileCallOptions as k, type FFIDUserProfile as l, type FFIDUpdateUserProfileRequest as m, type FFIDAnalyticsConfig as n, type FFIDCreateCheckoutParams as o, type FFIDCheckoutSessionResponse as p, type FFIDCreatePortalParams as q, type FFIDPortalSessionResponse as r, type FFIDVerifyAccessTokenOptions as s, type FFIDOAuthUserInfo as t, type FFIDInquiryCreateParams as u, type FFIDInquiryCreateResponse as v, type FFIDAuthMode as w, type FFIDLogger as x, type FFIDCacheAdapter as y, type FFIDUser as z };

package/dist/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkJNR4AKL5_cjs = require('./chunk-JNR4AKL5.cjs');
+var chunkXQL4YSTL_cjs = require('./chunk-XQL4YSTL.cjs');
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 
@@ -53,8 +53,8 @@ function defaultRedirect(url) {
 }
 function useRequireActiveSubscription(options) {
   const { redirectTo, allowGrace = true, onRedirect } = options;
-  const { isLoading, error } = chunkJNR4AKL5_cjs.useFFIDContext();
-  const { effectiveStatus, isBlocked, isGrace } = chunkJNR4AKL5_cjs.useSubscription();
+  const { isLoading, error } = chunkXQL4YSTL_cjs.useFFIDContext();
+  const { effectiveStatus, isBlocked, isGrace } = chunkXQL4YSTL_cjs.useSubscription();
   const hasFetchError = error !== null && effectiveStatus === null;
   const shouldRedirect = !isLoading && !hasFetchError && (isBlocked || !allowGrace && isGrace || effectiveStatus === null);
   react.useEffect(() => {
@@ -75,7 +75,7 @@ function useRequireActiveSubscription(options) {
 }
 function withFFIDAuth(Component, options = {}) {
   const WrappedComponent = (props) => {
-    const { isLoading, isAuthenticated, login } = chunkJNR4AKL5_cjs.useFFIDContext();
+    const { isLoading, isAuthenticated, login } = chunkXQL4YSTL_cjs.useFFIDContext();
     const hasRedirected = react.useRef(false);
     react.useEffect(() => {
       if (!isLoading && !isAuthenticated && options.redirectToLogin && !hasRedirected.current) {
@@ -104,115 +104,115 @@ var FFID_NEWSLETTER_DISPATCH_MAX_RECIPIENTS = 1e3;
 
 Object.defineProperty(exports, "DEFAULT_API_BASE_URL", {
   enumerable: true,
-  get: function () { return chunkJNR4AKL5_cjs.DEFAULT_API_BASE_URL; }
+  get: function () { return chunkXQL4YSTL_cjs.DEFAULT_API_BASE_URL; }
 });
 Object.defineProperty(exports, "DEFAULT_OAUTH_SCOPES", {
   enumerable: true,
-  get: function () { return chunkJNR4AKL5_cjs.DEFAULT_OAUTH_SCOPES; }
+  get: function () { return chunkXQL4YSTL_cjs.DEFAULT_OAUTH_SCOPES; }
 });
 Object.defineProperty(exports, "FFIDAnnouncementBadge", {
   enumerable: true,
-  get: function () { return chunkJNR4AKL5_cjs.FFIDAnnouncementBadge; }
+  get: function () { return chunkXQL4YSTL_cjs.FFIDAnnouncementBadge; }
 });
 Object.defineProperty(exports, "FFIDAnnouncementList", {
   enumerable: true,
-  get: function () { return chunkJNR4AKL5_cjs.FFIDAnnouncementList; }
+  get: function () { return chunkXQL4YSTL_cjs.FFIDAnnouncementList; }
 });
 Object.defineProperty(exports, "FFIDInquiryForm", {
   enumerable: true,
-  get: function () { return chunkJNR4AKL5_cjs.FFIDInquiryForm; }
+  get: function () { return chunkXQL4YSTL_cjs.FFIDInquiryForm; }
 });
 Object.defineProperty(exports, "FFIDLoginButton", {
   enumerable: true,
-  get: function () { return chunkJNR4AKL5_cjs.FFIDLoginButton; }
+  get: function () { return chunkXQL4YSTL_cjs.FFIDLoginButton; }
 });
 Object.defineProperty(exports, "FFIDOrganizationSwitcher", {
   enumerable: true,
-  get: function () { return chunkJNR4AKL5_cjs.FFIDOrganizationSwitcher; }
+  get: function () { return chunkXQL4YSTL_cjs.FFIDOrganizationSwitcher; }
 });
 Object.defineProperty(exports, "FFIDProvider", {
   enumerable: true,
-  get: function () { return chunkJNR4AKL5_cjs.FFIDProvider; }
+  get: function () { return chunkXQL4YSTL_cjs.FFIDProvider; }
 });
 Object.defineProperty(exports, "FFIDSDKError", {
   enumerable: true,
-  get: function () { return chunkJNR4AKL5_cjs.FFIDSDKError; }
+  get: function () { return chunkXQL4YSTL_cjs.FFIDSDKError; }
 });
 Object.defineProperty(exports, "FFIDSubscriptionBadge", {
   enumerable: true,
-  get: function () { return chunkJNR4AKL5_cjs.FFIDSubscriptionBadge; }
+  get: function () { return chunkXQL4YSTL_cjs.FFIDSubscriptionBadge; }
 });
 Object.defineProperty(exports, "FFIDUserMenu", {
   enumerable: true,
-  get: function () { return chunkJNR4AKL5_cjs.FFIDUserMenu; }
+  get: function () { return chunkXQL4YSTL_cjs.FFIDUserMenu; }
 });
 Object.defineProperty(exports, "FFID_ANNOUNCEMENTS_ERROR_CODES", {
   enumerable: true,
-  get: function () { return chunkJNR4AKL5_cjs.FFID_ANNOUNCEMENTS_ERROR_CODES; }
+  get: function () { return chunkXQL4YSTL_cjs.FFID_ANNOUNCEMENTS_ERROR_CODES; }
 });
 Object.defineProperty(exports, "FFID_INQUIRY_CATEGORIES", {
   enumerable: true,
-  get: function () { return chunkJNR4AKL5_cjs.FFID_INQUIRY_CATEGORIES; }
+  get: function () { return chunkXQL4YSTL_cjs.FFID_INQUIRY_CATEGORIES; }
 });
 Object.defineProperty(exports, "FFID_INQUIRY_CATEGORIES_SITE_2026", {
   enumerable: true,
-  get: function () { return chunkJNR4AKL5_cjs.FFID_INQUIRY_CATEGORIES_SITE_2026; }
+  get: function () { return chunkXQL4YSTL_cjs.FFID_INQUIRY_CATEGORIES_SITE_2026; }
 });
 Object.defineProperty(exports, "computeEffectiveStatusFromSession", {
   enumerable: true,
-  get: function () { return chunkJNR4AKL5_cjs.computeEffectiveStatusFromSession; }
+  get: function () { return chunkXQL4YSTL_cjs.computeEffectiveStatusFromSession; }
 });
 Object.defineProperty(exports, "createFFIDAnnouncementsClient", {
   enumerable: true,
-  get: function () { return chunkJNR4AKL5_cjs.createFFIDAnnouncementsClient; }
+  get: function () { return chunkXQL4YSTL_cjs.createFFIDAnnouncementsClient; }
 });
 Object.defineProperty(exports, "createFFIDClient", {
   enumerable: true,
-  get: function () { return chunkJNR4AKL5_cjs.createFFIDClient; }
+  get: function () { return chunkXQL4YSTL_cjs.createFFIDClient; }
 });
 Object.defineProperty(exports, "createTokenStore", {
   enumerable: true,
-  get: function () { return chunkJNR4AKL5_cjs.createTokenStore; }
+  get: function () { return chunkXQL4YSTL_cjs.createTokenStore; }
 });
 Object.defineProperty(exports, "generateCodeChallenge", {
   enumerable: true,
-  get: function () { return chunkJNR4AKL5_cjs.generateCodeChallenge; }
+  get: function () { return chunkXQL4YSTL_cjs.generateCodeChallenge; }
 });
 Object.defineProperty(exports, "generateCodeVerifier", {
   enumerable: true,
-  get: function () { return chunkJNR4AKL5_cjs.generateCodeVerifier; }
+  get: function () { return chunkXQL4YSTL_cjs.generateCodeVerifier; }
 });
 Object.defineProperty(exports, "isFFIDInquiryCategorySite2026", {
   enumerable: true,
-  get: function () { return chunkJNR4AKL5_cjs.isFFIDInquiryCategorySite2026; }
+  get: function () { return chunkXQL4YSTL_cjs.isFFIDInquiryCategorySite2026; }
 });
 Object.defineProperty(exports, "normalizeRedirectUri", {
   enumerable: true,
-  get: function () { return chunkJNR4AKL5_cjs.normalizeRedirectUri; }
+  get: function () { return chunkXQL4YSTL_cjs.normalizeRedirectUri; }
 });
 Object.defineProperty(exports, "retrieveCodeVerifier", {
   enumerable: true,
-  get: function () { return chunkJNR4AKL5_cjs.retrieveCodeVerifier; }
+  get: function () { return chunkXQL4YSTL_cjs.retrieveCodeVerifier; }
 });
 Object.defineProperty(exports, "storeCodeVerifier", {
   enumerable: true,
-  get: function () { return chunkJNR4AKL5_cjs.storeCodeVerifier; }
+  get: function () { return chunkXQL4YSTL_cjs.storeCodeVerifier; }
 });
 Object.defineProperty(exports, "useFFID", {
   enumerable: true,
-  get: function () { return chunkJNR4AKL5_cjs.useFFID; }
+  get: function () { return chunkXQL4YSTL_cjs.useFFID; }
 });
 Object.defineProperty(exports, "useFFIDAnnouncements", {
   enumerable: true,
-  get: function () { return chunkJNR4AKL5_cjs.useFFIDAnnouncements; }
+  get: function () { return chunkXQL4YSTL_cjs.useFFIDAnnouncements; }
 });
 Object.defineProperty(exports, "useSubscription", {
   enumerable: true,
-  get: function () { return chunkJNR4AKL5_cjs.useSubscription; }
+  get: function () { return chunkXQL4YSTL_cjs.useSubscription; }
 });
 Object.defineProperty(exports, "withSubscription", {
   enumerable: true,
-  get: function () { return chunkJNR4AKL5_cjs.withSubscription; }
+  get: function () { return chunkXQL4YSTL_cjs.withSubscription; }
 });
 exports.FFID_NEWSLETTER_DISPATCH_MAX_RECIPIENTS = FFID_NEWSLETTER_DISPATCH_MAX_RECIPIENTS;
 exports.FFID_NEWSLETTER_TYPES = FFID_NEWSLETTER_TYPES;

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { F as FFIDSubscriptionStatus, a as FFIDConfig, b as FFIDApiResponse, c as FFIDSessionResponse, d as FFIDRedirectResult, e as FFIDError, f as FFIDSubscriptionCheckResponse, g as FFIDListMembersResponse, h as FFIDMemberRole, i as FFIDUpdateMemberRoleResponse, j as FFIDRemoveMemberResponse, k as FFIDProfileCallOptions, l as FFIDUserProfile, m as FFIDUpdateUserProfileRequest, n as FFIDAnalyticsConfig, o as FFIDCreateCheckoutParams, p as FFIDCheckoutSessionResponse, q as FFIDCreatePortalParams, r as FFIDPortalSessionResponse, s as FFIDVerifyAccessTokenOptions, t as FFIDOAuthUserInfo, u as FFIDInquiryCreateParams, v as FFIDInquiryCreateResponse, w as FFIDAuthMode, x as FFIDLogger, y as FFIDCacheAdapter, z as FFIDUser, A as FFIDOrganization, B as FFIDSubscription, C as FFIDSubscriptionContextValue, E as EffectiveSubscriptionStatus, D as FFIDAnnouncementsClientConfig, L as ListAnnouncementsOptions, G as FFIDAnnouncementsApiResponse, H as AnnouncementListResponse, I as FFIDAnnouncementsLogger } from './index-C3zyNa4j.cjs';
-export { J as Announcement, K as AnnouncementStatus, M as AnnouncementType, N as FFIDAnnouncementBadge, O as FFIDAnnouncementList, P as FFIDAnnouncementsError, Q as FFIDAnnouncementsErrorCode, R as FFIDAnnouncementsServerResponse, S as FFIDCacheConfig, T as FFIDContextValue, U as FFIDInquiryCategory, V as FFIDInquiryCategorySite2026, W as FFIDInquiryForm, X as FFIDInquiryFormCategoryItem, Y as FFIDInquiryFormClassNames, Z as FFIDInquiryFormOrganization, _ as FFIDInquiryFormPlaceholderContext, $ as FFIDInquiryFormPrefill, a0 as FFIDInquiryFormProps, a1 as FFIDInquiryFormSubmitData, a2 as FFIDInquiryFormSubmitResult, a3 as FFIDJwtClaims, a4 as FFIDLoginButton, a5 as FFIDMemberStatus, a6 as FFIDOAuthTokenResponse, a7 as FFIDOAuthUserInfoMemberRole, a8 as FFIDOAuthUserInfoSubscription, a9 as FFIDOrganizationMember, aa as FFIDOrganizationSwitcher, ab as FFIDRedirectErrorCode, ac as FFIDSeatModel, ad as FFIDSubscriptionBadge, ae as FFIDTokenIntrospectionResponse, af as FFIDUserMenu, ag as FFID_INQUIRY_CATEGORIES, ah as FFID_INQUIRY_CATEGORIES_SITE_2026, ai as UseFFIDAnnouncementsOptions, aj as UseFFIDAnnouncementsReturn, ak as isFFIDInquiryCategorySite2026, al as useFFIDAnnouncements } from './index-C3zyNa4j.cjs';
+import { F as FFIDSubscriptionStatus, a as FFIDConfig, b as FFIDApiResponse, c as FFIDSessionResponse, d as FFIDRedirectResult, e as FFIDError, f as FFIDSubscriptionCheckResponse, g as FFIDListMembersResponse, h as FFIDMemberRole, i as FFIDUpdateMemberRoleResponse, j as FFIDRemoveMemberResponse, k as FFIDProfileCallOptions, l as FFIDUserProfile, m as FFIDUpdateUserProfileRequest, n as FFIDAnalyticsConfig, o as FFIDCreateCheckoutParams, p as FFIDCheckoutSessionResponse, q as FFIDCreatePortalParams, r as FFIDPortalSessionResponse, s as FFIDVerifyAccessTokenOptions, t as FFIDOAuthUserInfo, u as FFIDInquiryCreateParams, v as FFIDInquiryCreateResponse, w as FFIDAuthMode, x as FFIDLogger, y as FFIDCacheAdapter, z as FFIDUser, A as FFIDOrganization, B as FFIDSubscription, C as FFIDSubscriptionContextValue, E as EffectiveSubscriptionStatus, D as FFIDAnnouncementsClientConfig, L as ListAnnouncementsOptions, G as FFIDAnnouncementsApiResponse, H as AnnouncementListResponse, I as FFIDAnnouncementsLogger } from './index-Cn8-3hgb.cjs';
+export { J as Announcement, K as AnnouncementStatus, M as AnnouncementType, N as FFIDAnnouncementBadge, O as FFIDAnnouncementList, P as FFIDAnnouncementsError, Q as FFIDAnnouncementsErrorCode, R as FFIDAnnouncementsServerResponse, S as FFIDCacheConfig, T as FFIDContextValue, U as FFIDInquiryCategory, V as FFIDInquiryCategorySite2026, W as FFIDInquiryForm, X as FFIDInquiryFormCategoryItem, Y as FFIDInquiryFormClassNames, Z as FFIDInquiryFormLegalLayout, _ as FFIDInquiryFormOrganization, $ as FFIDInquiryFormPlaceholderContext, a0 as FFIDInquiryFormPrefill, a1 as FFIDInquiryFormProps, a2 as FFIDInquiryFormSubmitData, a3 as FFIDInquiryFormSubmitResult, a4 as FFIDJwtClaims, a5 as FFIDLoginButton, a6 as FFIDMemberStatus, a7 as FFIDOAuthTokenResponse, a8 as FFIDOAuthUserInfoMemberRole, a9 as FFIDOAuthUserInfoSubscription, aa as FFIDOrganizationMember, ab as FFIDOrganizationSwitcher, ac as FFIDRedirectErrorCode, ad as FFIDSeatModel, ae as FFIDSubscriptionBadge, af as FFIDTokenIntrospectionResponse, ag as FFIDUserMenu, ah as FFID_INQUIRY_CATEGORIES, ai as FFID_INQUIRY_CATEGORIES_SITE_2026, aj as UseFFIDAnnouncementsOptions, ak as UseFFIDAnnouncementsReturn, al as isFFIDInquiryCategorySite2026, am as useFFIDAnnouncements } from './index-Cn8-3hgb.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, ComponentType, FC } from 'react';
 
@@ -493,17 +493,37 @@ interface ContractWizardSubscriptionOptions {
 
 /** Redirect and URL generation - redirectToLogin / redirectToAuthorize / redirectToLogout / getLoginUrl / getSignupUrl / getLogoutUrl */
 
+/**
+ * `screen_hint=signup` query value for `/oauth/authorize` (#2908 / #2911).
+ * Forwards to Supabase Auth signup screen; only the `'signup'` value is
+ * propagated (no-op when `'login'` or omitted).
+ */
+declare const SCREEN_HINT_SIGNUP: "signup";
 /** Options for redirectToAuthorize */
 interface RedirectToAuthorizeOptions {
     /** Target organization ID — triggers org-scoped OAuth re-authorization */
     organizationId?: string;
+    /**
+     * Initial Supabase Auth screen hint (#2908 / #2911).
+     *
+     * - `'signup'`: forwards `?screen_hint=signup` so the FFID OAuth flow lands
+     *   on the signup screen (used by external services that want to deep-link
+     *   new users into the signup CTA).
+     * - `'login'` / `undefined`: no `screen_hint` param is added — the default
+     *   login screen is shown.
+     *
+     * In cookie mode, `'signup'` redirects to the FFID `/signup` page instead
+     * of `/login` so the SDK contract (signup-screen intent) stays consistent
+     * regardless of `authMode`.
+     */
+    screenHint?: typeof SCREEN_HINT_SIGNUP | 'login';
 }
 
 /** Creates an FFID API client instance */
 declare function createFFIDClient(config: FFIDConfig): {
     getSession: () => Promise<FFIDApiResponse<FFIDSessionResponse>>;
     signOut: () => Promise<FFIDApiResponse<void>>;
-    redirectToLogin: () => Promise<FFIDRedirectResult>;
+    redirectToLogin: (options?: RedirectToAuthorizeOptions) => Promise<FFIDRedirectResult>;
     redirectToAuthorize: (options?: RedirectToAuthorizeOptions) => Promise<FFIDRedirectResult>;
     redirectToLogout: (postLogoutRedirectUri?: string) => FFIDRedirectResult;
     getLoginUrl: (redirectUrl?: string) => string;
@@ -679,8 +699,17 @@ interface UseFFIDReturn {
     isAuthenticated: boolean;
     /** Any authentication error that occurred */
     error: FFIDError | null;
-    /** Redirect to login page */
-    login: () => void;
+    /**
+     * Redirect to login page.
+     *
+     * @param options.screenHint `'signup'` to deep-link into the signup screen
+     *   (forwards `screen_hint=signup` in token mode / redirects to `/signup`
+     *   in cookie mode). `'login'` and `undefined` use the default login flow.
+     *   See `RedirectToAuthorizeOptions` (#2908 / #2911).
+     */
+    login: (options?: {
+        screenHint?: 'signup' | 'login';
+    }) => void;
     /** Sign out */
     logout: () => Promise<void>;
     /**

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { F as FFIDSubscriptionStatus, a as FFIDConfig, b as FFIDApiResponse, c as FFIDSessionResponse, d as FFIDRedirectResult, e as FFIDError, f as FFIDSubscriptionCheckResponse, g as FFIDListMembersResponse, h as FFIDMemberRole, i as FFIDUpdateMemberRoleResponse, j as FFIDRemoveMemberResponse, k as FFIDProfileCallOptions, l as FFIDUserProfile, m as FFIDUpdateUserProfileRequest, n as FFIDAnalyticsConfig, o as FFIDCreateCheckoutParams, p as FFIDCheckoutSessionResponse, q as FFIDCreatePortalParams, r as FFIDPortalSessionResponse, s as FFIDVerifyAccessTokenOptions, t as FFIDOAuthUserInfo, u as FFIDInquiryCreateParams, v as FFIDInquiryCreateResponse, w as FFIDAuthMode, x as FFIDLogger, y as FFIDCacheAdapter, z as FFIDUser, A as FFIDOrganization, B as FFIDSubscription, C as FFIDSubscriptionContextValue, E as EffectiveSubscriptionStatus, D as FFIDAnnouncementsClientConfig, L as ListAnnouncementsOptions, G as FFIDAnnouncementsApiResponse, H as AnnouncementListResponse, I as FFIDAnnouncementsLogger } from './index-C3zyNa4j.js';
-export { J as Announcement, K as AnnouncementStatus, M as AnnouncementType, N as FFIDAnnouncementBadge, O as FFIDAnnouncementList, P as FFIDAnnouncementsError, Q as FFIDAnnouncementsErrorCode, R as FFIDAnnouncementsServerResponse, S as FFIDCacheConfig, T as FFIDContextValue, U as FFIDInquiryCategory, V as FFIDInquiryCategorySite2026, W as FFIDInquiryForm, X as FFIDInquiryFormCategoryItem, Y as FFIDInquiryFormClassNames, Z as FFIDInquiryFormOrganization, _ as FFIDInquiryFormPlaceholderContext, $ as FFIDInquiryFormPrefill, a0 as FFIDInquiryFormProps, a1 as FFIDInquiryFormSubmitData, a2 as FFIDInquiryFormSubmitResult, a3 as FFIDJwtClaims, a4 as FFIDLoginButton, a5 as FFIDMemberStatus, a6 as FFIDOAuthTokenResponse, a7 as FFIDOAuthUserInfoMemberRole, a8 as FFIDOAuthUserInfoSubscription, a9 as FFIDOrganizationMember, aa as FFIDOrganizationSwitcher, ab as FFIDRedirectErrorCode, ac as FFIDSeatModel, ad as FFIDSubscriptionBadge, ae as FFIDTokenIntrospectionResponse, af as FFIDUserMenu, ag as FFID_INQUIRY_CATEGORIES, ah as FFID_INQUIRY_CATEGORIES_SITE_2026, ai as UseFFIDAnnouncementsOptions, aj as UseFFIDAnnouncementsReturn, ak as isFFIDInquiryCategorySite2026, al as useFFIDAnnouncements } from './index-C3zyNa4j.js';
+import { F as FFIDSubscriptionStatus, a as FFIDConfig, b as FFIDApiResponse, c as FFIDSessionResponse, d as FFIDRedirectResult, e as FFIDError, f as FFIDSubscriptionCheckResponse, g as FFIDListMembersResponse, h as FFIDMemberRole, i as FFIDUpdateMemberRoleResponse, j as FFIDRemoveMemberResponse, k as FFIDProfileCallOptions, l as FFIDUserProfile, m as FFIDUpdateUserProfileRequest, n as FFIDAnalyticsConfig, o as FFIDCreateCheckoutParams, p as FFIDCheckoutSessionResponse, q as FFIDCreatePortalParams, r as FFIDPortalSessionResponse, s as FFIDVerifyAccessTokenOptions, t as FFIDOAuthUserInfo, u as FFIDInquiryCreateParams, v as FFIDInquiryCreateResponse, w as FFIDAuthMode, x as FFIDLogger, y as FFIDCacheAdapter, z as FFIDUser, A as FFIDOrganization, B as FFIDSubscription, C as FFIDSubscriptionContextValue, E as EffectiveSubscriptionStatus, D as FFIDAnnouncementsClientConfig, L as ListAnnouncementsOptions, G as FFIDAnnouncementsApiResponse, H as AnnouncementListResponse, I as FFIDAnnouncementsLogger } from './index-Cn8-3hgb.js';
+export { J as Announcement, K as AnnouncementStatus, M as AnnouncementType, N as FFIDAnnouncementBadge, O as FFIDAnnouncementList, P as FFIDAnnouncementsError, Q as FFIDAnnouncementsErrorCode, R as FFIDAnnouncementsServerResponse, S as FFIDCacheConfig, T as FFIDContextValue, U as FFIDInquiryCategory, V as FFIDInquiryCategorySite2026, W as FFIDInquiryForm, X as FFIDInquiryFormCategoryItem, Y as FFIDInquiryFormClassNames, Z as FFIDInquiryFormLegalLayout, _ as FFIDInquiryFormOrganization, $ as FFIDInquiryFormPlaceholderContext, a0 as FFIDInquiryFormPrefill, a1 as FFIDInquiryFormProps, a2 as FFIDInquiryFormSubmitData, a3 as FFIDInquiryFormSubmitResult, a4 as FFIDJwtClaims, a5 as FFIDLoginButton, a6 as FFIDMemberStatus, a7 as FFIDOAuthTokenResponse, a8 as FFIDOAuthUserInfoMemberRole, a9 as FFIDOAuthUserInfoSubscription, aa as FFIDOrganizationMember, ab as FFIDOrganizationSwitcher, ac as FFIDRedirectErrorCode, ad as FFIDSeatModel, ae as FFIDSubscriptionBadge, af as FFIDTokenIntrospectionResponse, ag as FFIDUserMenu, ah as FFID_INQUIRY_CATEGORIES, ai as FFID_INQUIRY_CATEGORIES_SITE_2026, aj as UseFFIDAnnouncementsOptions, ak as UseFFIDAnnouncementsReturn, al as isFFIDInquiryCategorySite2026, am as useFFIDAnnouncements } from './index-Cn8-3hgb.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, ComponentType, FC } from 'react';
 
@@ -493,17 +493,37 @@ interface ContractWizardSubscriptionOptions {
 
 /** Redirect and URL generation - redirectToLogin / redirectToAuthorize / redirectToLogout / getLoginUrl / getSignupUrl / getLogoutUrl */
 
+/**
+ * `screen_hint=signup` query value for `/oauth/authorize` (#2908 / #2911).
+ * Forwards to Supabase Auth signup screen; only the `'signup'` value is
+ * propagated (no-op when `'login'` or omitted).
+ */
+declare const SCREEN_HINT_SIGNUP: "signup";
 /** Options for redirectToAuthorize */
 interface RedirectToAuthorizeOptions {
     /** Target organization ID — triggers org-scoped OAuth re-authorization */
     organizationId?: string;
+    /**
+     * Initial Supabase Auth screen hint (#2908 / #2911).
+     *
+     * - `'signup'`: forwards `?screen_hint=signup` so the FFID OAuth flow lands
+     *   on the signup screen (used by external services that want to deep-link
+     *   new users into the signup CTA).
+     * - `'login'` / `undefined`: no `screen_hint` param is added — the default
+     *   login screen is shown.
+     *
+     * In cookie mode, `'signup'` redirects to the FFID `/signup` page instead
+     * of `/login` so the SDK contract (signup-screen intent) stays consistent
+     * regardless of `authMode`.
+     */
+    screenHint?: typeof SCREEN_HINT_SIGNUP | 'login';
 }
 
 /** Creates an FFID API client instance */
 declare function createFFIDClient(config: FFIDConfig): {
     getSession: () => Promise<FFIDApiResponse<FFIDSessionResponse>>;
     signOut: () => Promise<FFIDApiResponse<void>>;
-    redirectToLogin: () => Promise<FFIDRedirectResult>;
+    redirectToLogin: (options?: RedirectToAuthorizeOptions) => Promise<FFIDRedirectResult>;
     redirectToAuthorize: (options?: RedirectToAuthorizeOptions) => Promise<FFIDRedirectResult>;
     redirectToLogout: (postLogoutRedirectUri?: string) => FFIDRedirectResult;
     getLoginUrl: (redirectUrl?: string) => string;
@@ -679,8 +699,17 @@ interface UseFFIDReturn {
     isAuthenticated: boolean;
     /** Any authentication error that occurred */
     error: FFIDError | null;
-    /** Redirect to login page */
-    login: () => void;
+    /**
+     * Redirect to login page.
+     *
+     * @param options.screenHint `'signup'` to deep-link into the signup screen
+     *   (forwards `screen_hint=signup` in token mode / redirects to `/signup`
+     *   in cookie mode). `'login'` and `undefined` use the default login flow.
+     *   See `RedirectToAuthorizeOptions` (#2908 / #2911).
+     */
+    login: (options?: {
+        screenHint?: 'signup' | 'login';
+    }) => void;
     /** Sign out */
     logout: () => Promise<void>;
     /**

package/dist/index.js

@@ -1,5 +1,5 @@
-import { useFFIDContext, useSubscription } from './chunk-XWI4BFKW.js';
-export { DEFAULT_API_BASE_URL, DEFAULT_OAUTH_SCOPES, FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDInquiryForm, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDProvider, FFIDSDKError, FFIDSubscriptionBadge, FFIDUserMenu, FFID_ANNOUNCEMENTS_ERROR_CODES, FFID_INQUIRY_CATEGORIES, FFID_INQUIRY_CATEGORIES_SITE_2026, computeEffectiveStatusFromSession, createFFIDAnnouncementsClient, createFFIDClient, createTokenStore, generateCodeChallenge, generateCodeVerifier, isFFIDInquiryCategorySite2026, normalizeRedirectUri, retrieveCodeVerifier, storeCodeVerifier, useFFID, useFFIDAnnouncements, useSubscription, withSubscription } from './chunk-XWI4BFKW.js';
+import { useFFIDContext, useSubscription } from './chunk-P35ULJLM.js';
+export { DEFAULT_API_BASE_URL, DEFAULT_OAUTH_SCOPES, FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDInquiryForm, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDProvider, FFIDSDKError, FFIDSubscriptionBadge, FFIDUserMenu, FFID_ANNOUNCEMENTS_ERROR_CODES, FFID_INQUIRY_CATEGORIES, FFID_INQUIRY_CATEGORIES_SITE_2026, computeEffectiveStatusFromSession, createFFIDAnnouncementsClient, createFFIDClient, createTokenStore, generateCodeChallenge, generateCodeVerifier, isFFIDInquiryCategorySite2026, normalizeRedirectUri, retrieveCodeVerifier, storeCodeVerifier, useFFID, useFFIDAnnouncements, useSubscription, withSubscription } from './chunk-P35ULJLM.js';
 import { useEffect, useRef } from 'react';
 import { jsx, Fragment } from 'react/jsx-runtime';
 

package/dist/server/index.cjs

@@ -803,7 +803,7 @@ function createProfileMethods(deps) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "3.0.0";
+var SDK_VERSION = "4.0.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {
@@ -1325,6 +1325,8 @@ function base64UrlEncode(buffer) {
 // src/client/redirect.ts
 var OAUTH_AUTHORIZE_ENDPOINT = "/api/v1/oauth/authorize";
 var AUTH_LOGOUT_ENDPOINT = "/api/v1/auth/logout";
+var SCREEN_HINT_SIGNUP = "signup";
+var SCREEN_HINT_PARAM = "screen_hint";
 var STATE_RANDOM_BYTES = 16;
 var HEX_BASE2 = 16;
 var REDIRECT_LOOP_KEY = "ffid_sdk_redirect_loop_history";
@@ -1492,6 +1494,9 @@ function createRedirectMethods(deps) {
       }
       params.set("organization_id", trimmedOrgId);
     }
+    if (options?.screenHint === SCREEN_HINT_SIGNUP) {
+      params.set(SCREEN_HINT_PARAM, SCREEN_HINT_SIGNUP);
+    }
     const authorizeUrl = `${baseUrl}${OAUTH_AUTHORIZE_ENDPOINT}?${params.toString()}`;
     logger.debug("Redirecting to authorize:", authorizeUrl);
     recordRedirectAttempt(authorizeKey, now, logger);
@@ -1503,18 +1508,17 @@ function createRedirectMethods(deps) {
     }
     return { success: true };
   }
-  async function redirectToLogin() {
+  async function redirectToLogin(options) {
     if (typeof window === "undefined") {
       logger.warn("SSR \u74B0\u5883\u3067\u306F\u30EA\u30C0\u30A4\u30EC\u30AF\u30C8\u3067\u304D\u307E\u305B\u3093");
       return { success: false, error: "SSR \u74B0\u5883\u3067\u306F\u30EA\u30C0\u30A4\u30EC\u30AF\u30C8\u3067\u304D\u307E\u305B\u3093" };
     }
     if (authMode === "token") {
-      return redirectToAuthorize();
+      return redirectToAuthorize(options);
     }
-    const currentUrl = window.location.href;
-    const loginUrl = `${baseUrl}/login?redirect=${encodeURIComponent(currentUrl)}&service=${encodeURIComponent(serviceCode)}`;
-    logger.debug("Redirecting to login:", loginUrl);
-    window.location.href = loginUrl;
+    const targetUrl = options?.screenHint === SCREEN_HINT_SIGNUP ? getSignupUrl() : getLoginUrl();
+    logger.debug("Redirecting to auth page:", targetUrl);
+    window.location.href = targetUrl;
     return { success: true };
   }
   function getLoginUrl(redirectUrl) {

package/dist/server/index.d.cts

@@ -1,5 +1,5 @@
-import { F as FFIDLogger, a as FFIDError, b as FFIDCacheAdapter, c as FFIDVerifyAccessTokenOptions, d as FFIDApiResponse, e as FFIDOAuthUserInfo } from '../ffid-client-B26jbUp5.cjs';
-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-B26jbUp5.cjs';
+import { F as FFIDLogger, a as FFIDError, b as FFIDCacheAdapter, c as FFIDVerifyAccessTokenOptions, d as FFIDApiResponse, e as FFIDOAuthUserInfo } from '../ffid-client-ZcJhRbD6.cjs';
+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-ZcJhRbD6.cjs';
 export { D as DEFAULT_API_BASE_URL, a as DEFAULT_OAUTH_SCOPES } from '../constants-D61jqRIO.cjs';
 
 /** Token verification - verifyAccessToken() implementation */

package/dist/server/index.d.ts

@@ -1,5 +1,5 @@
-import { F as FFIDLogger, a as FFIDError, b as FFIDCacheAdapter, c as FFIDVerifyAccessTokenOptions, d as FFIDApiResponse, e as FFIDOAuthUserInfo } from '../ffid-client-B26jbUp5.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-B26jbUp5.js';
+import { F as FFIDLogger, a as FFIDError, b as FFIDCacheAdapter, c as FFIDVerifyAccessTokenOptions, d as FFIDApiResponse, e as FFIDOAuthUserInfo } from '../ffid-client-ZcJhRbD6.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-ZcJhRbD6.js';
 export { D as DEFAULT_API_BASE_URL, a as DEFAULT_OAUTH_SCOPES } from '../constants-D61jqRIO.js';
 
 /** Token verification - verifyAccessToken() implementation */

package/dist/server/index.js

@@ -802,7 +802,7 @@ function createProfileMethods(deps) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "3.0.0";
+var SDK_VERSION = "4.0.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {
@@ -1324,6 +1324,8 @@ function base64UrlEncode(buffer) {
 // src/client/redirect.ts
 var OAUTH_AUTHORIZE_ENDPOINT = "/api/v1/oauth/authorize";
 var AUTH_LOGOUT_ENDPOINT = "/api/v1/auth/logout";
+var SCREEN_HINT_SIGNUP = "signup";
+var SCREEN_HINT_PARAM = "screen_hint";
 var STATE_RANDOM_BYTES = 16;
 var HEX_BASE2 = 16;
 var REDIRECT_LOOP_KEY = "ffid_sdk_redirect_loop_history";
@@ -1491,6 +1493,9 @@ function createRedirectMethods(deps) {
       }
       params.set("organization_id", trimmedOrgId);
     }
+    if (options?.screenHint === SCREEN_HINT_SIGNUP) {
+      params.set(SCREEN_HINT_PARAM, SCREEN_HINT_SIGNUP);
+    }
     const authorizeUrl = `${baseUrl}${OAUTH_AUTHORIZE_ENDPOINT}?${params.toString()}`;
     logger.debug("Redirecting to authorize:", authorizeUrl);
     recordRedirectAttempt(authorizeKey, now, logger);
@@ -1502,18 +1507,17 @@ function createRedirectMethods(deps) {
     }
     return { success: true };
   }
-  async function redirectToLogin() {
+  async function redirectToLogin(options) {
     if (typeof window === "undefined") {
       logger.warn("SSR \u74B0\u5883\u3067\u306F\u30EA\u30C0\u30A4\u30EC\u30AF\u30C8\u3067\u304D\u307E\u305B\u3093");
       return { success: false, error: "SSR \u74B0\u5883\u3067\u306F\u30EA\u30C0\u30A4\u30EC\u30AF\u30C8\u3067\u304D\u307E\u305B\u3093" };
     }
     if (authMode === "token") {
-      return redirectToAuthorize();
+      return redirectToAuthorize(options);
     }
-    const currentUrl = window.location.href;
-    const loginUrl = `${baseUrl}/login?redirect=${encodeURIComponent(currentUrl)}&service=${encodeURIComponent(serviceCode)}`;
-    logger.debug("Redirecting to login:", loginUrl);
-    window.location.href = loginUrl;
+    const targetUrl = options?.screenHint === SCREEN_HINT_SIGNUP ? getSignupUrl() : getLoginUrl();
+    logger.debug("Redirecting to auth page:", targetUrl);
+    window.location.href = targetUrl;
     return { success: true };
   }
   function getLoginUrl(redirectUrl) {

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

@@ -1,4 +1,4 @@
-import { g as FFIDClient, e as FFIDOAuthUserInfo } from '../../ffid-client-B26jbUp5.cjs';
+import { g as FFIDClient, e as FFIDOAuthUserInfo } from '../../ffid-client-ZcJhRbD6.cjs';
 
 /**
  * FFID SDK - Test mode client (E2E / integration test bypass)

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

@@ -1,4 +1,4 @@
-import { g as FFIDClient, e as FFIDOAuthUserInfo } from '../../ffid-client-B26jbUp5.js';
+import { g as FFIDClient, e as FFIDOAuthUserInfo } from '../../ffid-client-ZcJhRbD6.js';
 
 /**
  * FFID SDK - Test mode client (E2E / integration test bypass)

package/package.json

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