@sendoracloud/sdk-react-native 0.18.3 → 0.18.5

package/dist/index.cjs

@@ -654,6 +654,29 @@ var Auth = class {
     }
     return { authorizationUrl: parsed.data.authorizationUrl };
   }
+  /**
+   * Kick off a SAML 2.0 SSO flow. Mirrors `startSso` for SAML —
+   * backend POST `/auth-service/sso/saml/start` returns the IdP
+   * AuthnRequest URL. Caller opens it with
+   * ASWebAuthenticationSession (iOS) / Custom Tabs (Android) /
+   * Linking, captures the callback URL via the standard
+   * `Linking.addEventListener` flow, then passes the captured URL to
+   * `consumeSsoFragment(url)`. consumeSsoFragment handles both OIDC
+   * and SAML fragments transparently.
+   */
+  async startSaml(returnTo) {
+    const res = await post(
+      { apiUrl: this.hooks.apiUrl, publicKey: this.hooks.publicKey, debug: this.hooks.debug },
+      "/api/v1/auth-service/sso/saml/start",
+      { returnTo }
+    );
+    if (!res || !res.ok) throw new AuthError("SAML_START_FAILED", `HTTP ${res?.status ?? "network"}`);
+    const parsed = await res.json();
+    if (!parsed.success || !parsed.data?.authorizationUrl) {
+      throw new AuthError("SAML_START_FAILED", "Missing authorizationUrl");
+    }
+    return { authorizationUrl: parsed.data.authorizationUrl };
+  }
   /**
    * Consume an OIDC callback URL captured via React Native's
    * `Linking.addEventListener('url', ...)`. Reads the fragment for
@@ -666,10 +689,10 @@ var Auth = class {
       const hashIdx = callbackUrl.indexOf("#");
       const fragment = hashIdx >= 0 ? callbackUrl.slice(hashIdx + 1) : "";
       const params = new URLSearchParams(fragment);
-      const err = params.get("sendora_oidc_error");
+      const err = params.get("sendora_oidc_error") ?? params.get("sendora_saml_error");
       if (err) throw new AuthError("SSO_FAILED", decodeURIComponent(err));
-      const refresh = params.get("sendora_oidc_token");
-      if (!refresh) throw new AuthError("SSO_NO_TOKEN", "Callback URL has no sendora_oidc_token");
+      const refresh = params.get("sendora_oidc_token") ?? params.get("sendora_saml_token");
+      if (!refresh) throw new AuthError("SSO_NO_TOKEN", "Callback URL has no SSO token");
       const res = await post(
         { apiUrl: this.hooks.apiUrl, publicKey: this.hooks.publicKey, debug: this.hooks.debug },
         "/api/v1/auth-service/token/refresh",
@@ -2020,6 +2043,57 @@ var SendoraSDK = class {
       }
     };
   }
+  /**
+   * Surveys namespace — fetch + submit NPS / CSAT / custom surveys
+   * from inside the app. Mirrors backend `/surveys/:id/config` +
+   * `/surveys/responses` SDK routes + the web SDK's
+   * `sendora.surveys.showSurvey()` + `submitResponse()` shape.
+   *
+   * Typical use:
+   *   const survey = await SendoraCloud.surveys.fetchConfig("survey_nps_2026");
+   *   if (survey) {
+   *     // render survey.questions[] in your UI
+   *     await SendoraCloud.surveys.submitResponse({
+   *       surveyId: survey.id,
+   *       answers: { q1: 9, q2: "Loving it" },
+   *       completed: true,
+   *     });
+   *   }
+   *
+   * fetchConfig returns null when the survey is inactive / not found
+   * (backend returns 404; SDK normalizes to null so callers can `if (!survey) return`).
+   */
+  get surveys() {
+    const self = this;
+    return {
+      fetchConfig: async (surveyId) => {
+        if (!self.config) throw new Error("[sendoracloud] init() must complete before surveys.fetchConfig().");
+        if (typeof surveyId !== "string" || surveyId.length === 0) return null;
+        const url = `${self.config.apiUrl}/api/v1/surveys/${encodeURIComponent(surveyId)}/config`;
+        const res = await fetch(url, {
+          method: "GET",
+          headers: { "x-api-key": self.config.publicKey }
+        });
+        if (res.status === 404) return null;
+        if (!res.ok) throw new Error(`[sendoracloud] surveys.fetchConfig failed (${res.status})`);
+        const parsed = await res.json();
+        if (!parsed.success || !parsed.data) return null;
+        return parsed.data;
+      },
+      submitResponse: async (input) => {
+        if (!self.config) throw new Error("[sendoracloud] init() must complete before surveys.submitResponse().");
+        const res = await post(
+          { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
+          "/surveys/responses",
+          { completed: true, ...input }
+        );
+        if (!res || !res.ok) throw new Error(`[sendoracloud] surveys.submitResponse failed (${res?.status ?? "network"})`);
+        const parsed = await res.json();
+        if (!parsed.success || !parsed.data) throw new Error("[sendoracloud] surveys.submitResponse: bad response");
+        return parsed.data;
+      }
+    };
+  }
   /**
    * Clear identity + rotate the anonymous id. Call on logout. Awaits
    * the AsyncStorage writes so a caller who kills the app immediately

package/dist/index.d.cts

@@ -268,6 +268,19 @@ declare class Auth {
     startSso(returnTo: string): Promise<{
         authorizationUrl: string;
     }>;
+    /**
+     * Kick off a SAML 2.0 SSO flow. Mirrors `startSso` for SAML —
+     * backend POST `/auth-service/sso/saml/start` returns the IdP
+     * AuthnRequest URL. Caller opens it with
+     * ASWebAuthenticationSession (iOS) / Custom Tabs (Android) /
+     * Linking, captures the callback URL via the standard
+     * `Linking.addEventListener` flow, then passes the captured URL to
+     * `consumeSsoFragment(url)`. consumeSsoFragment handles both OIDC
+     * and SAML fragments transparently.
+     */
+    startSaml(returnTo: string): Promise<{
+        authorizationUrl: string;
+    }>;
     /**
      * Consume an OIDC callback URL captured via React Native's
      * `Linking.addEventListener('url', ...)`. Reads the fragment for
@@ -934,6 +947,55 @@ declare class SendoraSDK {
             createdAt: string;
         }>;
     };
+    /**
+     * Surveys namespace — fetch + submit NPS / CSAT / custom surveys
+     * from inside the app. Mirrors backend `/surveys/:id/config` +
+     * `/surveys/responses` SDK routes + the web SDK's
+     * `sendora.surveys.showSurvey()` + `submitResponse()` shape.
+     *
+     * Typical use:
+     *   const survey = await SendoraCloud.surveys.fetchConfig("survey_nps_2026");
+     *   if (survey) {
+     *     // render survey.questions[] in your UI
+     *     await SendoraCloud.surveys.submitResponse({
+     *       surveyId: survey.id,
+     *       answers: { q1: 9, q2: "Loving it" },
+     *       completed: true,
+     *     });
+     *   }
+     *
+     * fetchConfig returns null when the survey is inactive / not found
+     * (backend returns 404; SDK normalizes to null so callers can `if (!survey) return`).
+     */
+    get surveys(): {
+        fetchConfig: (surveyId: string) => Promise<{
+            id: string;
+            name: string;
+            questions: Array<{
+                id: string;
+                type: string;
+                label: string;
+                required?: boolean;
+                options?: string[];
+                scale?: {
+                    min: number;
+                    max: number;
+                };
+            }>;
+            [key: string]: unknown;
+        } | null>;
+        submitResponse: (input: {
+            surveyId: string;
+            answers: Record<string, unknown>;
+            completed?: boolean;
+            entityId?: string;
+            userId?: string;
+            metadata?: Record<string, unknown>;
+        }) => Promise<{
+            id: string;
+            submittedAt: string;
+        }>;
+    };
     /**
      * Clear identity + rotate the anonymous id. Call on logout. Awaits
      * the AsyncStorage writes so a caller who kills the app immediately

package/dist/index.d.ts

@@ -268,6 +268,19 @@ declare class Auth {
     startSso(returnTo: string): Promise<{
         authorizationUrl: string;
     }>;
+    /**
+     * Kick off a SAML 2.0 SSO flow. Mirrors `startSso` for SAML —
+     * backend POST `/auth-service/sso/saml/start` returns the IdP
+     * AuthnRequest URL. Caller opens it with
+     * ASWebAuthenticationSession (iOS) / Custom Tabs (Android) /
+     * Linking, captures the callback URL via the standard
+     * `Linking.addEventListener` flow, then passes the captured URL to
+     * `consumeSsoFragment(url)`. consumeSsoFragment handles both OIDC
+     * and SAML fragments transparently.
+     */
+    startSaml(returnTo: string): Promise<{
+        authorizationUrl: string;
+    }>;
     /**
      * Consume an OIDC callback URL captured via React Native's
      * `Linking.addEventListener('url', ...)`. Reads the fragment for
@@ -934,6 +947,55 @@ declare class SendoraSDK {
             createdAt: string;
         }>;
     };
+    /**
+     * Surveys namespace — fetch + submit NPS / CSAT / custom surveys
+     * from inside the app. Mirrors backend `/surveys/:id/config` +
+     * `/surveys/responses` SDK routes + the web SDK's
+     * `sendora.surveys.showSurvey()` + `submitResponse()` shape.
+     *
+     * Typical use:
+     *   const survey = await SendoraCloud.surveys.fetchConfig("survey_nps_2026");
+     *   if (survey) {
+     *     // render survey.questions[] in your UI
+     *     await SendoraCloud.surveys.submitResponse({
+     *       surveyId: survey.id,
+     *       answers: { q1: 9, q2: "Loving it" },
+     *       completed: true,
+     *     });
+     *   }
+     *
+     * fetchConfig returns null when the survey is inactive / not found
+     * (backend returns 404; SDK normalizes to null so callers can `if (!survey) return`).
+     */
+    get surveys(): {
+        fetchConfig: (surveyId: string) => Promise<{
+            id: string;
+            name: string;
+            questions: Array<{
+                id: string;
+                type: string;
+                label: string;
+                required?: boolean;
+                options?: string[];
+                scale?: {
+                    min: number;
+                    max: number;
+                };
+            }>;
+            [key: string]: unknown;
+        } | null>;
+        submitResponse: (input: {
+            surveyId: string;
+            answers: Record<string, unknown>;
+            completed?: boolean;
+            entityId?: string;
+            userId?: string;
+            metadata?: Record<string, unknown>;
+        }) => Promise<{
+            id: string;
+            submittedAt: string;
+        }>;
+    };
     /**
      * Clear identity + rotate the anonymous id. Call on logout. Awaits
      * the AsyncStorage writes so a caller who kills the app immediately

package/dist/index.js

@@ -611,6 +611,29 @@ var Auth = class {
     }
     return { authorizationUrl: parsed.data.authorizationUrl };
   }
+  /**
+   * Kick off a SAML 2.0 SSO flow. Mirrors `startSso` for SAML —
+   * backend POST `/auth-service/sso/saml/start` returns the IdP
+   * AuthnRequest URL. Caller opens it with
+   * ASWebAuthenticationSession (iOS) / Custom Tabs (Android) /
+   * Linking, captures the callback URL via the standard
+   * `Linking.addEventListener` flow, then passes the captured URL to
+   * `consumeSsoFragment(url)`. consumeSsoFragment handles both OIDC
+   * and SAML fragments transparently.
+   */
+  async startSaml(returnTo) {
+    const res = await post(
+      { apiUrl: this.hooks.apiUrl, publicKey: this.hooks.publicKey, debug: this.hooks.debug },
+      "/api/v1/auth-service/sso/saml/start",
+      { returnTo }
+    );
+    if (!res || !res.ok) throw new AuthError("SAML_START_FAILED", `HTTP ${res?.status ?? "network"}`);
+    const parsed = await res.json();
+    if (!parsed.success || !parsed.data?.authorizationUrl) {
+      throw new AuthError("SAML_START_FAILED", "Missing authorizationUrl");
+    }
+    return { authorizationUrl: parsed.data.authorizationUrl };
+  }
   /**
    * Consume an OIDC callback URL captured via React Native's
    * `Linking.addEventListener('url', ...)`. Reads the fragment for
@@ -623,10 +646,10 @@ var Auth = class {
       const hashIdx = callbackUrl.indexOf("#");
       const fragment = hashIdx >= 0 ? callbackUrl.slice(hashIdx + 1) : "";
       const params = new URLSearchParams(fragment);
-      const err = params.get("sendora_oidc_error");
+      const err = params.get("sendora_oidc_error") ?? params.get("sendora_saml_error");
       if (err) throw new AuthError("SSO_FAILED", decodeURIComponent(err));
-      const refresh = params.get("sendora_oidc_token");
-      if (!refresh) throw new AuthError("SSO_NO_TOKEN", "Callback URL has no sendora_oidc_token");
+      const refresh = params.get("sendora_oidc_token") ?? params.get("sendora_saml_token");
+      if (!refresh) throw new AuthError("SSO_NO_TOKEN", "Callback URL has no SSO token");
       const res = await post(
         { apiUrl: this.hooks.apiUrl, publicKey: this.hooks.publicKey, debug: this.hooks.debug },
         "/api/v1/auth-service/token/refresh",
@@ -1982,6 +2005,57 @@ var SendoraSDK = class {
       }
     };
   }
+  /**
+   * Surveys namespace — fetch + submit NPS / CSAT / custom surveys
+   * from inside the app. Mirrors backend `/surveys/:id/config` +
+   * `/surveys/responses` SDK routes + the web SDK's
+   * `sendora.surveys.showSurvey()` + `submitResponse()` shape.
+   *
+   * Typical use:
+   *   const survey = await SendoraCloud.surveys.fetchConfig("survey_nps_2026");
+   *   if (survey) {
+   *     // render survey.questions[] in your UI
+   *     await SendoraCloud.surveys.submitResponse({
+   *       surveyId: survey.id,
+   *       answers: { q1: 9, q2: "Loving it" },
+   *       completed: true,
+   *     });
+   *   }
+   *
+   * fetchConfig returns null when the survey is inactive / not found
+   * (backend returns 404; SDK normalizes to null so callers can `if (!survey) return`).
+   */
+  get surveys() {
+    const self = this;
+    return {
+      fetchConfig: async (surveyId) => {
+        if (!self.config) throw new Error("[sendoracloud] init() must complete before surveys.fetchConfig().");
+        if (typeof surveyId !== "string" || surveyId.length === 0) return null;
+        const url = `${self.config.apiUrl}/api/v1/surveys/${encodeURIComponent(surveyId)}/config`;
+        const res = await fetch(url, {
+          method: "GET",
+          headers: { "x-api-key": self.config.publicKey }
+        });
+        if (res.status === 404) return null;
+        if (!res.ok) throw new Error(`[sendoracloud] surveys.fetchConfig failed (${res.status})`);
+        const parsed = await res.json();
+        if (!parsed.success || !parsed.data) return null;
+        return parsed.data;
+      },
+      submitResponse: async (input) => {
+        if (!self.config) throw new Error("[sendoracloud] init() must complete before surveys.submitResponse().");
+        const res = await post(
+          { apiUrl: self.config.apiUrl, publicKey: self.config.publicKey, debug: self.debug },
+          "/surveys/responses",
+          { completed: true, ...input }
+        );
+        if (!res || !res.ok) throw new Error(`[sendoracloud] surveys.submitResponse failed (${res?.status ?? "network"})`);
+        const parsed = await res.json();
+        if (!parsed.success || !parsed.data) throw new Error("[sendoracloud] surveys.submitResponse: bad response");
+        return parsed.data;
+      }
+    };
+  }
   /**
    * Clear identity + rotate the anonymous id. Call on logout. Awaits
    * the AsyncStorage writes so a caller who kills the app immediately

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sendoracloud/sdk-react-native",
-  "version": "0.18.3",
+  "version": "0.18.5",
   "description": "Sendora Cloud React Native + Expo SDK — analytics, identity, push-token registration, auth, deep links (Branch / Firebase Dynamic Links parity). Auth + analytics + deep links work in Expo Go; push token registration requires a Dev Client (EAS Build or `npx expo prebuild`).",
   "type": "module",
   "main": "./dist/index.cjs",