@feelflow/ffid-sdk 2.7.0 → 2.9.0

package/dist/server/index.cjs

@@ -617,7 +617,7 @@ function createMembersMethods(deps) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "2.7.0";
+var SDK_VERSION = "2.9.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {
@@ -1660,6 +1660,56 @@ function createNewsletterMethods(deps) {
   return { subscribe, confirm, unsubscribe };
 }
 
+// src/inquiry/ffid-inquiry-client.ts
+var EXT_INQUIRY_ENDPOINT = "/api/v1/ext/inquiry";
+function trimOrEmpty2(s) {
+  return typeof s === "string" ? s.trim() : "";
+}
+function createInquiryMethods(deps) {
+  const { fetchWithAuth, createError } = deps;
+  async function create(params) {
+    const email = trimOrEmpty2(params.email);
+    const name = trimOrEmpty2(params.name);
+    const message = trimOrEmpty2(params.message);
+    const termsVersion = trimOrEmpty2(params.termsVersion);
+    const privacyVersion = trimOrEmpty2(params.privacyVersion);
+    if (!email) return { error: createError("VALIDATION_ERROR", "email \u306F\u5FC5\u9808\u3067\u3059") };
+    if (!name) return { error: createError("VALIDATION_ERROR", "name \u306F\u5FC5\u9808\u3067\u3059") };
+    if (!message) return { error: createError("VALIDATION_ERROR", "message \u306F\u5FC5\u9808\u3067\u3059") };
+    if (!termsVersion) {
+      return { error: createError("VALIDATION_ERROR", "termsVersion \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    if (!privacyVersion) {
+      return { error: createError("VALIDATION_ERROR", "privacyVersion \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    const inquiryFollowupOptIn = params.inquiryFollowupOptIn === true;
+    const generalNewsletterOptIn = params.generalNewsletterOptIn === true;
+    return fetchWithAuth(EXT_INQUIRY_ENDPOINT, {
+      method: "POST",
+      body: JSON.stringify({
+        email,
+        name,
+        message,
+        category: params.category,
+        company: params.company,
+        phone: params.phone,
+        locale: params.locale,
+        termsVersion,
+        privacyVersion,
+        // The ext endpoint still accepts the legacy single-flag field, but
+        // the SDK always submits the 2-layer model. `newsletterOptIn` is
+        // passed as the union of the two new flags only to satisfy the
+        // current schema's required bool — the server preferentially
+        // reads `inquiryFollowupOptIn` / `generalNewsletterOptIn`.
+        newsletterOptIn: inquiryFollowupOptIn || generalNewsletterOptIn,
+        inquiryFollowupOptIn,
+        generalNewsletterOptIn
+      })
+    });
+  }
+  return { create };
+}
+
 // src/client/ffid-client.ts
 var UNAUTHORIZED_STATUS2 = 401;
 var SDK_LOG_PREFIX = "[FFID SDK]";
@@ -1940,6 +1990,10 @@ function createFFIDClient(config) {
     baseUrl,
     createError
   });
+  const inquiry = createInquiryMethods({
+    fetchWithAuth,
+    createError
+  });
   const verifyAccessToken = createVerifyAccessToken({
     authMode,
     baseUrl,
@@ -1996,6 +2050,8 @@ function createFFIDClient(config) {
     verifyOtp,
     /** Newsletter methods (subscribe / confirm / unsubscribe) */
     newsletter,
+    /** Inquiry methods (create) */
+    inquiry,
     /** Token store (token mode only) */
     tokenStore,
     /** Resolved auth mode */

package/dist/server/index.d.cts

@@ -1,5 +1,47 @@
 export { D as DEFAULT_API_BASE_URL } from '../constants-DvTGHPZn.cjs';
 
+/**
+ * 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.
+ */
+/**
+ * Categories surfaced by the default form. Consumers are free to
+ * pass their own list via `<FFIDInquiryForm categories={...} />`.
+ */
+declare const FFID_INQUIRY_CATEGORIES: readonly ["general", "sales", "support", "partnership", "press", "other"];
+type FFIDInquiryCategory = (typeof FFID_INQUIRY_CATEGORIES)[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.
+ */
+interface FFIDInquiryCreateParams {
+    email: string;
+    name: string;
+    message: string;
+    category?: 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.
  *
@@ -831,6 +873,10 @@ declare function createFFIDClient(config: FFIDConfig): {
         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 */

package/dist/server/index.d.ts

@@ -1,5 +1,47 @@
 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.
+ */
+/**
+ * Categories surfaced by the default form. Consumers are free to
+ * pass their own list via `<FFIDInquiryForm categories={...} />`.
+ */
+declare const FFID_INQUIRY_CATEGORIES: readonly ["general", "sales", "support", "partnership", "press", "other"];
+type FFIDInquiryCategory = (typeof FFID_INQUIRY_CATEGORIES)[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.
+ */
+interface FFIDInquiryCreateParams {
+    email: string;
+    name: string;
+    message: string;
+    category?: 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.
  *
@@ -831,6 +873,10 @@ declare function createFFIDClient(config: FFIDConfig): {
         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 */

package/dist/server/index.js

@@ -616,7 +616,7 @@ function createMembersMethods(deps) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "2.7.0";
+var SDK_VERSION = "2.9.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {
@@ -1659,6 +1659,56 @@ function createNewsletterMethods(deps) {
   return { subscribe, confirm, unsubscribe };
 }
 
+// src/inquiry/ffid-inquiry-client.ts
+var EXT_INQUIRY_ENDPOINT = "/api/v1/ext/inquiry";
+function trimOrEmpty2(s) {
+  return typeof s === "string" ? s.trim() : "";
+}
+function createInquiryMethods(deps) {
+  const { fetchWithAuth, createError } = deps;
+  async function create(params) {
+    const email = trimOrEmpty2(params.email);
+    const name = trimOrEmpty2(params.name);
+    const message = trimOrEmpty2(params.message);
+    const termsVersion = trimOrEmpty2(params.termsVersion);
+    const privacyVersion = trimOrEmpty2(params.privacyVersion);
+    if (!email) return { error: createError("VALIDATION_ERROR", "email \u306F\u5FC5\u9808\u3067\u3059") };
+    if (!name) return { error: createError("VALIDATION_ERROR", "name \u306F\u5FC5\u9808\u3067\u3059") };
+    if (!message) return { error: createError("VALIDATION_ERROR", "message \u306F\u5FC5\u9808\u3067\u3059") };
+    if (!termsVersion) {
+      return { error: createError("VALIDATION_ERROR", "termsVersion \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    if (!privacyVersion) {
+      return { error: createError("VALIDATION_ERROR", "privacyVersion \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    const inquiryFollowupOptIn = params.inquiryFollowupOptIn === true;
+    const generalNewsletterOptIn = params.generalNewsletterOptIn === true;
+    return fetchWithAuth(EXT_INQUIRY_ENDPOINT, {
+      method: "POST",
+      body: JSON.stringify({
+        email,
+        name,
+        message,
+        category: params.category,
+        company: params.company,
+        phone: params.phone,
+        locale: params.locale,
+        termsVersion,
+        privacyVersion,
+        // The ext endpoint still accepts the legacy single-flag field, but
+        // the SDK always submits the 2-layer model. `newsletterOptIn` is
+        // passed as the union of the two new flags only to satisfy the
+        // current schema's required bool — the server preferentially
+        // reads `inquiryFollowupOptIn` / `generalNewsletterOptIn`.
+        newsletterOptIn: inquiryFollowupOptIn || generalNewsletterOptIn,
+        inquiryFollowupOptIn,
+        generalNewsletterOptIn
+      })
+    });
+  }
+  return { create };
+}
+
 // src/client/ffid-client.ts
 var UNAUTHORIZED_STATUS2 = 401;
 var SDK_LOG_PREFIX = "[FFID SDK]";
@@ -1939,6 +1989,10 @@ function createFFIDClient(config) {
     baseUrl,
     createError
   });
+  const inquiry = createInquiryMethods({
+    fetchWithAuth,
+    createError
+  });
   const verifyAccessToken = createVerifyAccessToken({
     authMode,
     baseUrl,
@@ -1995,6 +2049,8 @@ function createFFIDClient(config) {
     verifyOtp,
     /** Newsletter methods (subscribe / confirm / unsubscribe) */
     newsletter,
+    /** Inquiry methods (create) */
+    inquiry,
     /** Token store (token mode only) */
     tokenStore,
     /** Resolved auth mode */

package/package.json

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