@xpayeg/sdk 1.0.0 → 1.0.1

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @xpayeg/sdk
 
+## 1.0.1
+### Patch Changes
+
+
+
+- [#103](https://github.com/xpayeg/xpay/pull/103) [`7402e27`](https://github.com/xpayeg/xpay/commit/7402e27cde482148f126b2073694ef38386ea87a) Thanks [@Elmosh](https://github.com/Elmosh)! - Remove `CardElement` from both SDKs — `PaymentElement` is the only supported element going forward. It handles every payment method (Card, ValU, Fawry, etc.) through one unified UI and renders the appropriate fields based on the customer's choice.
+  
+  This release also republishes both packages through the proper `pnpm publish` flow, which fixes the `workspace:*` protocol leak in 1.0.0's `devDependencies` and `peerDependencies`. `npm install @xpayeg/sdk` and `npm install @xpayeg/react` now work cleanly.
+  
+  **Migration:** replace `elements.create("card")` with `elements.create("payment")`. If you previously rendered `<CardElement>` only when the user selected "Card" from your own picker, switch to `<PaymentElement>` which provides both the picker and the card form together.
+  
+  ```ts
+  // Before
+  const cardElement = elements.create("card");
+  cardElement.mount("#card");
+  
+  // After
+  const paymentElement = elements.create("payment");
+  paymentElement.mount("#payment");
+  ```
+
 ## 1.0.0
 ### Major Changes
 

package/README.md

@@ -189,17 +189,6 @@ paymentElement.on('change', (event) => {
 });
 ```
 
-### Card Element (card form only -- you handle method selection)
-
-```javascript
-const cardElement = elements.create('card');
-cardElement.mount('#card-form');
-
-cardElement.on('change', (event) => {
-  console.log(event.complete, event.value.brand);
-});
-```
-
 ## Step 4: Confirm the Payment
 
 `confirm()` returns a tagged union -- check `type` to determine the outcome.

package/dist/index.d.cts

@@ -3406,7 +3406,7 @@ interface XPayError {
 interface XPayInstance {
     /**
      * Create an Elements instance for custom checkout UI.
-     * Use with `PaymentElement` or `CardElement` to render payment forms.
+     * Use with `PaymentElement` to render the payment form.
      *
      * @param options - Must include `clientSecret` from a checkout session
      * @returns An Elements instance for creating and managing payment elements
@@ -3456,7 +3456,7 @@ interface ElementsOptions {
     locale?: "en" | "ar";
 }
 /**
- * Manages the lifecycle of payment elements (PaymentElement, CardElement).
+ * Manages the lifecycle of the PaymentElement.
  *
  * A single Elements instance manages one embed iframe shared by all elements.
  * Provides session management methods (promo codes, quantities, etc.) and
@@ -3465,12 +3465,8 @@ interface ElementsOptions {
 interface Elements {
     /** Create a PaymentElement (full payment method selector + card form) */
     create(type: "payment", options?: PaymentElementOptions): PaymentElement;
-    /** Create a CardElement (card form only — merchant handles method selection) */
-    create(type: "card", options?: CardElementOptions): CardElement;
     /** Get an existing element by type, or null if not created */
     getElement(type: "payment"): PaymentElement | null;
-    /** Get an existing element by type, or null if not created */
-    getElement(type: "card"): CardElement | null;
     /** Fetch available payment methods for this session */
     fetchPaymentMethods(): Promise<PaymentMethodInfo[]>;
     /**
@@ -3536,11 +3532,6 @@ interface PaymentElementOptions {
     /** Custom ordering of payment methods by type */
     paymentMethodOrder?: string[];
 }
-/** Options for creating a CardElement */
-interface CardElementOptions {
-    /** Whether to show the cardholder name input */
-    showCardholderName?: boolean;
-}
 /**
  * Change event from a PaymentElement.
  * Fires on payment method selection, card field changes, and session updates.
@@ -3570,22 +3561,6 @@ interface PaymentElementChangeEvent {
     /** Full session data including updated amounts, fees, and discounts */
     session: CheckoutSession;
 }
-/**
- * Change event from a CardElement.
- * Fires when card fields change (input, validation, completion).
- */
-interface CardElementChangeEvent {
-    elementType: "card";
-    /** Whether all card fields are empty */
-    empty: boolean;
-    /** Whether all card fields are filled and valid */
-    complete: boolean;
-    /** Detected card details (available as user types) */
-    value: {
-        /** Card brand (e.g., "visa", "mastercard") — null until detected */
-        brand: string | null;
-    };
-}
 /** Base interface shared by all element types */
 interface BaseElement {
     /** Mount the element into a DOM container (CSS selector or HTMLElement) */
@@ -3614,11 +3589,6 @@ interface PaymentElement extends BaseElement {
     /** Update element options at runtime */
     update(options: Partial<PaymentElementOptions>): void;
 }
-/** CardElement — card-only form (merchant handles payment method selection) */
-interface CardElement extends BaseElement {
-    /** Update element options at runtime */
-    update(options: Partial<CardElementOptions>): void;
-}
 /**
  * Options for `confirmPayment()` or `checkout.confirm()`.
  *
@@ -3871,4 +3841,4 @@ declare global {
 declare function loadXPay(publishableKey: string): Promise<XPayInstance | null>;
 
 export { loadXPay };
-export type { ActionResult, Address, Appearance, BaseElement, CardElement, CardElementChangeEvent, CardElementOptions, CheckoutActions, CheckoutCompleteResult, DiscountResponseDto as CheckoutDiscount, CheckoutError, FeesResponseDto as CheckoutFees, CheckoutInstance, LineItemDto as CheckoutLineItem, CheckoutOptions, CheckoutSession, TotalDetailsResponseDto as CheckoutTotalDetails, ConfirmPaymentOptions, CustomerDetails, Elements, ElementsLoadErrorEvent, ElementsOptions, ElementsReadyEvent, InitCheckoutOptions, InitCheckoutResult, PaymentElement, PaymentElementChangeEvent, PaymentElementOptions, PaymentMethodInfo, SessionStatus, XPayError, XPayInstance };
+export type { ActionResult, Address, Appearance, BaseElement, CheckoutActions, CheckoutCompleteResult, DiscountResponseDto as CheckoutDiscount, CheckoutError, FeesResponseDto as CheckoutFees, CheckoutInstance, LineItemDto as CheckoutLineItem, CheckoutOptions, CheckoutSession, TotalDetailsResponseDto as CheckoutTotalDetails, ConfirmPaymentOptions, CustomerDetails, Elements, ElementsLoadErrorEvent, ElementsOptions, ElementsReadyEvent, InitCheckoutOptions, InitCheckoutResult, PaymentElement, PaymentElementChangeEvent, PaymentElementOptions, PaymentMethodInfo, SessionStatus, XPayError, XPayInstance };

package/dist/index.d.mts

@@ -3406,7 +3406,7 @@ interface XPayError {
 interface XPayInstance {
     /**
      * Create an Elements instance for custom checkout UI.
-     * Use with `PaymentElement` or `CardElement` to render payment forms.
+     * Use with `PaymentElement` to render the payment form.
      *
      * @param options - Must include `clientSecret` from a checkout session
      * @returns An Elements instance for creating and managing payment elements
@@ -3456,7 +3456,7 @@ interface ElementsOptions {
     locale?: "en" | "ar";
 }
 /**
- * Manages the lifecycle of payment elements (PaymentElement, CardElement).
+ * Manages the lifecycle of the PaymentElement.
  *
  * A single Elements instance manages one embed iframe shared by all elements.
  * Provides session management methods (promo codes, quantities, etc.) and
@@ -3465,12 +3465,8 @@ interface ElementsOptions {
 interface Elements {
     /** Create a PaymentElement (full payment method selector + card form) */
     create(type: "payment", options?: PaymentElementOptions): PaymentElement;
-    /** Create a CardElement (card form only — merchant handles method selection) */
-    create(type: "card", options?: CardElementOptions): CardElement;
     /** Get an existing element by type, or null if not created */
     getElement(type: "payment"): PaymentElement | null;
-    /** Get an existing element by type, or null if not created */
-    getElement(type: "card"): CardElement | null;
     /** Fetch available payment methods for this session */
     fetchPaymentMethods(): Promise<PaymentMethodInfo[]>;
     /**
@@ -3536,11 +3532,6 @@ interface PaymentElementOptions {
     /** Custom ordering of payment methods by type */
     paymentMethodOrder?: string[];
 }
-/** Options for creating a CardElement */
-interface CardElementOptions {
-    /** Whether to show the cardholder name input */
-    showCardholderName?: boolean;
-}
 /**
  * Change event from a PaymentElement.
  * Fires on payment method selection, card field changes, and session updates.
@@ -3570,22 +3561,6 @@ interface PaymentElementChangeEvent {
     /** Full session data including updated amounts, fees, and discounts */
     session: CheckoutSession;
 }
-/**
- * Change event from a CardElement.
- * Fires when card fields change (input, validation, completion).
- */
-interface CardElementChangeEvent {
-    elementType: "card";
-    /** Whether all card fields are empty */
-    empty: boolean;
-    /** Whether all card fields are filled and valid */
-    complete: boolean;
-    /** Detected card details (available as user types) */
-    value: {
-        /** Card brand (e.g., "visa", "mastercard") — null until detected */
-        brand: string | null;
-    };
-}
 /** Base interface shared by all element types */
 interface BaseElement {
     /** Mount the element into a DOM container (CSS selector or HTMLElement) */
@@ -3614,11 +3589,6 @@ interface PaymentElement extends BaseElement {
     /** Update element options at runtime */
     update(options: Partial<PaymentElementOptions>): void;
 }
-/** CardElement — card-only form (merchant handles payment method selection) */
-interface CardElement extends BaseElement {
-    /** Update element options at runtime */
-    update(options: Partial<CardElementOptions>): void;
-}
 /**
  * Options for `confirmPayment()` or `checkout.confirm()`.
  *
@@ -3871,4 +3841,4 @@ declare global {
 declare function loadXPay(publishableKey: string): Promise<XPayInstance | null>;
 
 export { loadXPay };
-export type { ActionResult, Address, Appearance, BaseElement, CardElement, CardElementChangeEvent, CardElementOptions, CheckoutActions, CheckoutCompleteResult, DiscountResponseDto as CheckoutDiscount, CheckoutError, FeesResponseDto as CheckoutFees, CheckoutInstance, LineItemDto as CheckoutLineItem, CheckoutOptions, CheckoutSession, TotalDetailsResponseDto as CheckoutTotalDetails, ConfirmPaymentOptions, CustomerDetails, Elements, ElementsLoadErrorEvent, ElementsOptions, ElementsReadyEvent, InitCheckoutOptions, InitCheckoutResult, PaymentElement, PaymentElementChangeEvent, PaymentElementOptions, PaymentMethodInfo, SessionStatus, XPayError, XPayInstance };
+export type { ActionResult, Address, Appearance, BaseElement, CheckoutActions, CheckoutCompleteResult, DiscountResponseDto as CheckoutDiscount, CheckoutError, FeesResponseDto as CheckoutFees, CheckoutInstance, LineItemDto as CheckoutLineItem, CheckoutOptions, CheckoutSession, TotalDetailsResponseDto as CheckoutTotalDetails, ConfirmPaymentOptions, CustomerDetails, Elements, ElementsLoadErrorEvent, ElementsOptions, ElementsReadyEvent, InitCheckoutOptions, InitCheckoutResult, PaymentElement, PaymentElementChangeEvent, PaymentElementOptions, PaymentMethodInfo, SessionStatus, XPayError, XPayInstance };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xpayeg/sdk",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "XPay JavaScript SDK — loader and TypeScript types for embedding XPay payments",
   "license": "MIT",
   "type": "module",
@@ -32,21 +32,16 @@
     "CHANGELOG.md",
     "LICENSE"
   ],
-  "scripts": {
-    "build": "tsdown && rollup -c rollup.dts.config.mjs",
-    "lint:pkg": "publint && attw --pack .",
-    "typecheck": "tsc --noEmit"
-  },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.2",
     "@rollup/plugin-node-resolve": "^16.0.3",
-    "@xpay/checkout-api": "workspace:*",
-    "@xpay/tsconfig": "workspace:*",
     "publint": "^0.3.21",
     "rollup": "^4.60.4",
     "rollup-plugin-dts": "^6.4.1",
     "tsdown": "^0.22.0",
-    "typescript": "catalog:"
+    "typescript": "5.9.3",
+    "@xpay/checkout-api": "0.0.0",
+    "@xpay/tsconfig": "0.0.0"
   },
   "repository": {
     "type": "git",
@@ -62,5 +57,10 @@
     "egypt",
     "checkout",
     "sdk"
-  ]
-}
+  ],
+  "scripts": {
+    "build": "tsdown && rollup -c rollup.dts.config.mjs",
+    "lint:pkg": "publint && attw --pack .",
+    "typecheck": "tsc --noEmit"
+  }
+}