@primer-io/primer-js 1.3.0 → 1.4.0

package/dist/jsx/index.d.ts

@@ -268,8 +268,6 @@ displays only the local portion (everything after the prefix). */
 export type SelectComponentProps = {
   /** The name attribute for the select element */
   name?: string;
-  /** The id attribute for the select element */
-  id?: string;
   /** The current value of the select */
   value?: string;
   /** Whether the select is disabled */
@@ -281,13 +279,13 @@ export type SelectComponentProps = {
   /** Array of options for the select */
   options?: SelectOption[];
   /** Fired when selection changes */
-  onchange?: (e: CustomEvent<CustomEvent>) => void;
+  onchange?: (e: CustomEvent<never>) => void;
   /** Fired when input value changes */
-  oninput?: (e: CustomEvent<CustomEvent>) => void;
+  oninput?: (e: CustomEvent<never>) => void;
   /** Fired when select receives focus */
-  onfocus?: (e: CustomEvent<CustomEvent>) => void;
+  onfocus?: (e: CustomEvent<never>) => void;
   /** Fired when select loses focus */
-  onblur?: (e: CustomEvent<CustomEvent>) => void;
+  onblur?: (e: CustomEvent<never>) => void;
 };
 
 export type SpinnerComponentProps = {
@@ -471,13 +469,13 @@ export type VaultManagerComponentProps = {
   addEventListener?: <K extends keyof VaultManagerEventMap>(
     type: K,
     listener: (ev: VaultManagerEventMap[K]) => void,
-    options?: boolean | AddEventListenerOptions,
+    options?: boolean | AddEventListenerOptions
   ) => void;
   /**  */
   removeEventListener?: <K extends keyof VaultManagerEventMap>(
     type: K,
     listener: (ev: VaultManagerEventMap[K]) => void,
-    options?: boolean | AddEventListenerOptions,
+    options?: boolean | AddEventListenerOptions
   ) => void;
   /**  */
   primerContext?: ContextType | undefined;
@@ -634,13 +632,13 @@ export type VaultDeleteConfirmationComponentProps = {
   addEventListener?: <K extends keyof VaultManagerEventMap>(
     type: K,
     listener: (ev: VaultManagerEventMap[K]) => void,
-    options?: boolean | AddEventListenerOptions,
+    options?: boolean | AddEventListenerOptions
   ) => void;
   /**  */
   removeEventListener?: <K extends keyof VaultManagerEventMap>(
     type: K,
     listener: (ev: VaultManagerEventMap[K]) => void,
-    options?: boolean | AddEventListenerOptions,
+    options?: boolean | AddEventListenerOptions
   ) => void;
 };
 
@@ -653,13 +651,13 @@ export type VaultErrorMessageComponentProps = {
   addEventListener?: <K extends keyof VaultManagerEventMap>(
     type: K,
     listener: (ev: VaultManagerEventMap[K]) => void,
-    options?: boolean | AddEventListenerOptions,
+    options?: boolean | AddEventListenerOptions
   ) => void;
   /**  */
   removeEventListener?: <K extends keyof VaultManagerEventMap>(
     type: K,
     listener: (ev: VaultManagerEventMap[K]) => void,
-    options?: boolean | AddEventListenerOptions,
+    options?: boolean | AddEventListenerOptions
   ) => void;
 };
 
@@ -672,13 +670,13 @@ export type VaultManagerHeaderComponentProps = {
   addEventListener?: <K extends keyof VaultManagerEventMap>(
     type: K,
     listener: (ev: VaultManagerEventMap[K]) => void,
-    options?: boolean | AddEventListenerOptions,
+    options?: boolean | AddEventListenerOptions
   ) => void;
   /**  */
   removeEventListener?: <K extends keyof VaultManagerEventMap>(
     type: K,
     listener: (ev: VaultManagerEventMap[K]) => void,
-    options?: boolean | AddEventListenerOptions,
+    options?: boolean | AddEventListenerOptions
   ) => void;
 };
 
@@ -689,13 +687,13 @@ export type VaultPaymentMethodItemComponentProps = {
   addEventListener?: <K extends keyof VaultManagerEventMap>(
     type: K,
     listener: (ev: VaultManagerEventMap[K]) => void,
-    options?: boolean | AddEventListenerOptions,
+    options?: boolean | AddEventListenerOptions
   ) => void;
   /**  */
   removeEventListener?: <K extends keyof VaultManagerEventMap>(
     type: K,
     listener: (ev: VaultManagerEventMap[K]) => void,
-    options?: boolean | AddEventListenerOptions,
+    options?: boolean | AddEventListenerOptions
   ) => void;
   /**  */
   primerContext?: ContextType | undefined;

package/dist/primer-loader.d.ts

@@ -712,7 +712,7 @@ export interface PaymentMethodConfig<T = Record<string, unknown>> {
 	id: string;
 	type: PaymentMethodType;
 	name: string;
-	implementationType: "WEB_REDIRECT" | "NATIVE_SDK";
+	implementationType: "WEB_REDIRECT" | "NATIVE_SDK" | "BACKEND_DRIVEN";
 	displayMetadata: {
 		button: {
 			backgroundColor: BackgroundColor;
@@ -1480,12 +1480,39 @@ export interface PrimerCheckoutOptions {
 	 */
 	redirect?: {
 		/**
-		 * URL the payment method redirects back to after the customer completes
-		 * (or cancels) the flow on the external page.
+		 * URL the customer is redirected back to after completing (or
+		 * cancelling) the payment on the external page.
+		 *
+		 * Required when the configured payment methods include any that may
+		 * redirect the customer to an external page. The SDK throws at initialization
+		 * if a redirect-capable payment method is enabled and this is
+		 * missing.
+		 *
+		 * **Setting up the return page**
+		 *
+		 * The URL you provide must host a page that mounts the
+		 * `<primer-checkout>` component again so the payment can be
+		 * resumed. Primer redirects the customer back with a new client
+		 * token appended as a `clientToken` query parameter — read it
+		 * from the URL and pass it to the component:
+		 *
+		 * ```html
+		 * <primer-checkout client-token=""></primer-checkout>
+		 * <script>
+		 *   const clientToken = new URLSearchParams(window.location.search)
+		 *     .get('clientToken');
+		 *   document
+		 *     .querySelector('primer-checkout')
+		 *     .setAttribute('client-token', clientToken);
+		 * </script>
+		 * ```
+		 *
+		 * The SDK reads the intent embedded in the token, detects that
+		 * this is a return-from-redirect, and resumes the payment
+		 * automatically — no separate method call is required.
 		 *
-		 * If omitted, the SDK uses the current page URL.
 		 */
-		returnUrl?: string;
+		returnUrl: string;
 		/**
 		 * Whether to force a full-page redirect for payment methods that would
 		 * otherwise open in a popup.
@@ -3296,10 +3323,6 @@ declare class SelectComponent extends LitElement {
 	 * The name attribute for the select element
 	 */
 	name: string;
-	/**
-	 * The id attribute for the select element
-	 */
-	id: string;
 	/**
 	 * The current value of the select
 	 */