@nium/nium-sdk 0.1.3 → 0.1.5

package/dist/index.d.mts

@@ -6,12 +6,20 @@ type NiumElementType = 'payment' | 'tax' | 'identity' | 'full';
 interface NiumInitOptions {
     /** Target environment */
     env: NiumEnv;
-    /** Session code returned by marketplace-service /init */
-    sessionCode: string;
     /** Optional locale (defaults to 'en') */
     locale?: string;
     /** Override the hosted form base URL (useful for local dev) */
     hostedFormUrl?: string;
+    /** Authorization code from NIAM oauth/authcode */
+    authCode?: string;
+    /** PKCE code verifier corresponding to the code challenge sent to get authCode */
+    codeVerifier?: string;
+    /** Customer hash ID */
+    customerHashId?: string;
+    /** Client ID */
+    clientId?: string;
+    /** Pre-exchanged session token (temporary — bypasses auth code exchange) */
+    sessionToken?: string;
 }
 /** Theme options for embedded components */
 interface NiumTheme {
@@ -36,10 +44,14 @@ interface NiumPaymentPrefill {
 }
 /** Options passed to `createElement()` */
 interface NiumElementOptions {
+    /** Customer hash ID */
+    customerHashId?: string;
     /** Pre-fill form fields */
     prefill?: NiumPaymentPrefill;
     /** Custom theme overrides */
     theme?: NiumTheme;
+    /** If true, the form will call the create beneficiary API directly instead of returning the payload */
+    createBeneficiary?: boolean;
     /** Custom minimum height for the iframe (default: 400) */
     customizations?: {
         minHeight?: number;
@@ -57,11 +69,7 @@ interface NiumChangeEvent {
     type: 'change';
     data: Record<string, unknown>;
 }
-interface NiumSubmitResult {
-    beneficiaryId?: string;
-    filerHashId?: string;
-    status: 'success';
-}
+type NiumSubmitResult = Record<string, unknown>;
 interface NiumSubmitEvent {
     type: 'submit';
     result: NiumSubmitResult;
@@ -144,7 +152,7 @@ declare class NiumElement {
  *
  * await init({
  *   env: 'sandbox',
- *   sessionCode: '<code-from-server>',
+ *   authCode: '<auth-code-from-niam>',
  * })
  *
  * const element = await createElement('payment')

package/dist/index.d.ts

@@ -6,12 +6,20 @@ type NiumElementType = 'payment' | 'tax' | 'identity' | 'full';
 interface NiumInitOptions {
     /** Target environment */
     env: NiumEnv;
-    /** Session code returned by marketplace-service /init */
-    sessionCode: string;
     /** Optional locale (defaults to 'en') */
     locale?: string;
     /** Override the hosted form base URL (useful for local dev) */
     hostedFormUrl?: string;
+    /** Authorization code from NIAM oauth/authcode */
+    authCode?: string;
+    /** PKCE code verifier corresponding to the code challenge sent to get authCode */
+    codeVerifier?: string;
+    /** Customer hash ID */
+    customerHashId?: string;
+    /** Client ID */
+    clientId?: string;
+    /** Pre-exchanged session token (temporary — bypasses auth code exchange) */
+    sessionToken?: string;
 }
 /** Theme options for embedded components */
 interface NiumTheme {
@@ -36,10 +44,14 @@ interface NiumPaymentPrefill {
 }
 /** Options passed to `createElement()` */
 interface NiumElementOptions {
+    /** Customer hash ID */
+    customerHashId?: string;
     /** Pre-fill form fields */
     prefill?: NiumPaymentPrefill;
     /** Custom theme overrides */
     theme?: NiumTheme;
+    /** If true, the form will call the create beneficiary API directly instead of returning the payload */
+    createBeneficiary?: boolean;
     /** Custom minimum height for the iframe (default: 400) */
     customizations?: {
         minHeight?: number;
@@ -57,11 +69,7 @@ interface NiumChangeEvent {
     type: 'change';
     data: Record<string, unknown>;
 }
-interface NiumSubmitResult {
-    beneficiaryId?: string;
-    filerHashId?: string;
-    status: 'success';
-}
+type NiumSubmitResult = Record<string, unknown>;
 interface NiumSubmitEvent {
     type: 'submit';
     result: NiumSubmitResult;
@@ -144,7 +152,7 @@ declare class NiumElement {
  *
  * await init({
  *   env: 'sandbox',
- *   sessionCode: '<code-from-server>',
+ *   authCode: '<auth-code-from-niam>',
  * })
  *
  * const element = await createElement('payment')

package/dist/index.js

@@ -196,9 +196,9 @@ var NiumElement = class {
 var initConfig = null;
 var ENV_URLS = {
   local: "http://localhost:3000",
-  sandbox: "https://onboard.sandbox.niumops.com",
   qa: "https://onboard-qa.nium.com",
-  production: "https://onboard.niumops.com"
+  sandbox: "https://onboard-sandbox.nium.com/",
+  production: "https://onboard.nium.com"
 };
 var ELEMENT_ROUTES = {
   payment: "/sdk/beneficiary-form",
@@ -207,8 +207,8 @@ var ELEMENT_ROUTES = {
   full: "/sdk/full-form"
 };
 var init = async (options) => {
-  if (!options.sessionCode) {
-    throw new Error("@nium/nium-sdk: sessionCode is required");
+  if (!options.authCode && !options.sessionToken) {
+    throw new Error("@nium/nium-sdk: authCode or sessionToken is required");
   }
   if (!options.env) {
     throw new Error("@nium/nium-sdk: env is required");
@@ -226,7 +226,24 @@ var createElement = async (type, options = {}) => {
   const origin = new URL(baseUrl).origin;
   const route = ELEMENT_ROUTES[type];
   const url = new URL(`${baseUrl}${route}`);
-  url.searchParams.set("code", initConfig.sessionCode);
+  if (initConfig.authCode) {
+    url.searchParams.set("authCode", initConfig.authCode);
+  }
+  if (initConfig.codeVerifier) {
+    url.searchParams.set("codeVerifier", initConfig.codeVerifier);
+  }
+  if (initConfig.clientId) {
+    url.searchParams.set("clientId", initConfig.clientId);
+  }
+  if (initConfig.sessionToken) {
+    url.searchParams.set("sessionToken", initConfig.sessionToken);
+  }
+  if (options.customerHashId) {
+    url.searchParams.set("customerHashId", options.customerHashId);
+  }
+  if (options.createBeneficiary) {
+    url.searchParams.set("createBeneficiary", "true");
+  }
   if (initConfig.locale) {
     url.searchParams.set("locale", initConfig.locale);
   }

package/dist/index.mjs

@@ -168,9 +168,9 @@ var NiumElement = class {
 var initConfig = null;
 var ENV_URLS = {
   local: "http://localhost:3000",
-  sandbox: "https://onboard.sandbox.niumops.com",
   qa: "https://onboard-qa.nium.com",
-  production: "https://onboard.niumops.com"
+  sandbox: "https://onboard-sandbox.nium.com/",
+  production: "https://onboard.nium.com"
 };
 var ELEMENT_ROUTES = {
   payment: "/sdk/beneficiary-form",
@@ -179,8 +179,8 @@ var ELEMENT_ROUTES = {
   full: "/sdk/full-form"
 };
 var init = async (options) => {
-  if (!options.sessionCode) {
-    throw new Error("@nium/nium-sdk: sessionCode is required");
+  if (!options.authCode && !options.sessionToken) {
+    throw new Error("@nium/nium-sdk: authCode or sessionToken is required");
   }
   if (!options.env) {
     throw new Error("@nium/nium-sdk: env is required");
@@ -198,7 +198,24 @@ var createElement = async (type, options = {}) => {
   const origin = new URL(baseUrl).origin;
   const route = ELEMENT_ROUTES[type];
   const url = new URL(`${baseUrl}${route}`);
-  url.searchParams.set("code", initConfig.sessionCode);
+  if (initConfig.authCode) {
+    url.searchParams.set("authCode", initConfig.authCode);
+  }
+  if (initConfig.codeVerifier) {
+    url.searchParams.set("codeVerifier", initConfig.codeVerifier);
+  }
+  if (initConfig.clientId) {
+    url.searchParams.set("clientId", initConfig.clientId);
+  }
+  if (initConfig.sessionToken) {
+    url.searchParams.set("sessionToken", initConfig.sessionToken);
+  }
+  if (options.customerHashId) {
+    url.searchParams.set("customerHashId", options.customerHashId);
+  }
+  if (options.createBeneficiary) {
+    url.searchParams.set("createBeneficiary", "true");
+  }
   if (initConfig.locale) {
     url.searchParams.set("locale", initConfig.locale);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nium/nium-sdk",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "NIUM Onboarding SDK - Embed hosted onboarding forms with a clean JavaScript API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",