@glomopay/react-native-sdk 3.0.1 → 4.0.0

package/lib/glomo-checkout.js

@@ -1,7 +1,8 @@
 "use strict";
 /**
- * The unified GlomoPay Checkout Component (v3).
+ * The unified GlomoPay Checkout Component (v4).
  * Detects order type (LRS vs Standard) and delegates rendering to the appropriate inner component.
+ * Enforces error handling via `onSdkError()` as a mandatory prop.
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -40,23 +41,44 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.GlomoCheckout = void 0;
 const react_1 = __importStar(require("react"));
 const use_glomo_checkout_1 = require("./use-glomo-checkout");
+const analytics_1 = require("./utils/analytics");
 const glomo_lrs_checkout_1 = require("./glomo-lrs-checkout");
 const glomo_standard_checkout_1 = require("./glomo-standard-checkout");
+const glomo_subscriptions_checkout_1 = require("./glomo-subscriptions-checkout");
 function GlomoCheckoutComponent(props, ref) {
+    var _a;
     // useGlomoCheckout handles order type detection and exposes start/getStatus for the ref
-    const { orderType, start, getStatus, innerLrsRef, innerStandardRef, props: passedProps } = (0, use_glomo_checkout_1.useGlomoCheckout)(props);
+    const { orderType, start, getStatus, innerLrsRef, innerStandardRef, innerSubscriptionsRef, props: passedProps, } = (0, use_glomo_checkout_1.useGlomoCheckout)(props, { _suppressDeprecationWarning: true });
     // Exposing start() and getStatus() via the forwarded ref for the merchant to call
     (0, react_1.useImperativeHandle)(ref, () => ({
         start,
         getStatus,
     }));
+    // Tracking unsupported callback props on subscription flows (fires once per mount)
+    const hasTrackedUnsupportedRef = (0, react_1.useRef)(false);
+    const devMode = (_a = passedProps.devMode) !== null && _a !== void 0 ? _a : false;
+    const mockMode = (0, react_1.useMemo)(() => { var _a, _b; return (_b = (_a = passedProps.publicKey) === null || _a === void 0 ? void 0 : _a.toLowerCase().startsWith("test_")) !== null && _b !== void 0 ? _b : false; }, [passedProps.publicKey]);
+    // Extracting stable boolean for the tracking effect to avoid depending on passedProps object
+    const hasUserJourneyCallback = !!passedProps.onUserJourneyCompleted;
+    (0, react_1.useEffect)(() => {
+        if (orderType !== "subscriptions" || hasTrackedUnsupportedRef.current)
+            return;
+        hasTrackedUnsupportedRef.current = true;
+        if (hasUserJourneyCallback) {
+            (0, analytics_1.trackUseOfUnsupportedFunctionality)("onUserJourneyCompleted", passedProps.subscriptionId, passedProps.publicKey, devMode, mockMode, "");
+        }
+    }, [orderType, hasUserJourneyCallback, passedProps.subscriptionId, passedProps.publicKey, devMode, mockMode]);
     // Delegating to the LRS checkout component once order type is resolved as LRS
     if (orderType === "lrs") {
         return (<glomo_lrs_checkout_1.GlomoLrsCheckout ref={innerLrsRef} server={passedProps.server} publicKey={passedProps.publicKey} orderId={passedProps.orderId} onPaymentSuccess={passedProps.onPaymentSuccess} onPaymentFailure={passedProps.onPaymentFailure} onConnectionError={passedProps.onConnectionError} onPaymentTerminate={passedProps.onPaymentTerminate} onSdkError={passedProps.onSdkError} devMode={passedProps.devMode}/>);
     }
     // Delegating to the Standard checkout component once order type is resolved as Standard
     if (orderType === "standard") {
-        return (<glomo_standard_checkout_1.GlomoStandardCheckout ref={innerStandardRef} server={passedProps.server} publicKey={passedProps.publicKey} orderId={passedProps.orderId} onPaymentSuccess={passedProps.onPaymentSuccess} onPaymentFailure={passedProps.onPaymentFailure} onConnectionError={passedProps.onConnectionError} onPaymentTerminate={passedProps.onPaymentTerminate} onSdkError={passedProps.onSdkError} onBankTransferSubmitted={passedProps.onBankTransferSubmitted} onPayViaBankCompleted={passedProps.onPayViaBankCompleted} onPayViaBankBankConnectionSuccessful={passedProps.onPayViaBankBankConnectionSuccessful} onUserRefusedCameraPermissions={passedProps.onUserRefusedCameraPermissions} devMode={passedProps.devMode}/>);
+        return (<glomo_standard_checkout_1.GlomoStandardCheckout ref={innerStandardRef} server={passedProps.server} publicKey={passedProps.publicKey} orderId={passedProps.orderId} onPaymentSuccess={passedProps.onPaymentSuccess} onPaymentFailure={passedProps.onPaymentFailure} onConnectionError={passedProps.onConnectionError} onPaymentTerminate={passedProps.onPaymentTerminate} onSdkError={passedProps.onSdkError} onUserJourneyCompleted={passedProps.onUserJourneyCompleted} onUserRefusedCameraPermissions={passedProps.onUserRefusedCameraPermissions} devMode={passedProps.devMode}/>);
+    }
+    // Delegating to the Subscriptions checkout component when subscriptionId is provided (no API call)
+    if (orderType === "subscriptions") {
+        return (<glomo_subscriptions_checkout_1.GlomoSubscriptionsCheckout ref={innerSubscriptionsRef} server={passedProps.server} publicKey={passedProps.publicKey} subscriptionId={passedProps.subscriptionId} onPaymentSuccess={passedProps.onPaymentSuccess} onPaymentFailure={passedProps.onPaymentFailure} onConnectionError={passedProps.onConnectionError} onPaymentTerminate={passedProps.onPaymentTerminate} onSdkError={passedProps.onSdkError} onUserJourneyCompleted={passedProps.onUserJourneyCompleted} onUserRefusedCameraPermissions={passedProps.onUserRefusedCameraPermissions} devMode={passedProps.devMode}/>);
     }
     /**
      * No modal for detecting state - avoids iOS pageSheet conflict where

package/lib/glomo-lrs-checkout.d.ts

@@ -4,7 +4,7 @@ import { type UseLrsCheckoutOptions, type LrsCheckoutStatus } from "./use-lrs-ch
 import { type SdkError } from "./utils/analytics";
 export interface GlomoLrsCheckoutProps extends UseLrsCheckoutOptions {
     visible?: boolean;
-    onSdkError?: (error: Array<SdkError>) => void;
+    onSdkError: (error: Array<SdkError>) => void;
 }
 export interface GlomoLrsCheckoutRef {
     start: () => boolean;

package/lib/glomo-lrs-checkout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"glomo-lrs-checkout.d.ts","sourceRoot":"","sources":["../src/glomo-lrs-checkout.tsx"],"names":[],"mappings":"AAAA,0CAA0C;AAE1C,OAAO,KAAmD,MAAM,OAAO,CAAC;AAIxE,OAAO,EAAkB,KAAK,qBAAqB,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACxG,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGlD,MAAM,WAAW,qBAAsB,SAAQ,qBAAqB;IAChE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,mBAAmB;IAChC,KAAK,EAAE,MAAM,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,iBAAiB,CAAC;CACtC;AA2WD,eAAO,MAAM,gBAAgB,mGAAoF,CAAC"}
+{"version":3,"file":"glomo-lrs-checkout.d.ts","sourceRoot":"","sources":["../src/glomo-lrs-checkout.tsx"],"names":[],"mappings":"AAAA,0CAA0C;AAE1C,OAAO,KAAmD,MAAM,OAAO,CAAC;AAIxE,OAAO,EAAkB,KAAK,qBAAqB,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACxG,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGlD,MAAM,WAAW,qBAAsB,SAAQ,qBAAqB;IAChE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;CAChD;AAED,MAAM,WAAW,mBAAmB;IAChC,KAAK,EAAE,MAAM,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,iBAAiB,CAAC;CACtC;AA2WD,eAAO,MAAM,gBAAgB,mGAAoF,CAAC"}

package/lib/glomo-standard-checkout.d.ts

@@ -1,5 +1,25 @@
 /** The GlomoPay Standard Checkout Component */
 import React from "react";
 import { type GlomoStandardCheckoutRef, type GlomoStandardCheckoutProps } from "./types/standard-checkout";
+import { type CheckoutAnalyticsTrackers } from "./utils/analytics";
+/**
+ * Internal-only props for GlomoStandardCheckout.
+ * Used by GlomoSubscriptionsCheckout to inject subscription analytics trackers.
+ * Not exported to merchants via index.ts.
+ */
+export interface GlomoStandardCheckoutInternalProps extends GlomoStandardCheckoutProps {
+    _analyticsTrackers?: CheckoutAnalyticsTrackers;
+    _skipOrderIdValidation?: boolean;
+}
+/**
+ * Widening the internal type to GlomoStandardCheckoutInternalProps for internal SDK use,
+ * then narrowing the public export to GlomoStandardCheckoutProps so merchants cannot
+ * pass internal-only props like _analyticsTrackers.
+ */
 export declare const GlomoStandardCheckout: React.ForwardRefExoticComponent<GlomoStandardCheckoutProps & React.RefAttributes<GlomoStandardCheckoutRef>>;
+/**
+ * Internal reference - accepts GlomoStandardCheckoutInternalProps.
+ * Not re-exported from index.ts.
+ */
+export declare const GlomoStandardCheckoutInternal: React.ForwardRefExoticComponent<GlomoStandardCheckoutInternalProps & React.RefAttributes<GlomoStandardCheckoutRef>>;
 //# sourceMappingURL=glomo-standard-checkout.d.ts.map

package/lib/glomo-standard-checkout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"glomo-standard-checkout.d.ts","sourceRoot":"","sources":["../src/glomo-standard-checkout.tsx"],"names":[],"mappings":"AAAA,+CAA+C;AAE/C,OAAO,KAAmD,MAAM,OAAO,CAAC;AAKxE,OAAO,EAAE,KAAK,wBAAwB,EAAE,KAAK,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAiQ3G,eAAO,MAAM,qBAAqB,6GAEjC,CAAC"}
+{"version":3,"file":"glomo-standard-checkout.d.ts","sourceRoot":"","sources":["../src/glomo-standard-checkout.tsx"],"names":[],"mappings":"AAAA,+CAA+C;AAE/C,OAAO,KAAmD,MAAM,OAAO,CAAC;AAKxE,OAAO,EAAE,KAAK,wBAAwB,EAAE,KAAK,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAC3G,OAAO,EAAE,KAAK,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAGnE;;;;GAIG;AACH,MAAM,WAAW,kCAAmC,SAAQ,0BAA0B;IAClF,kBAAkB,CAAC,EAAE,yBAAyB,CAAC;IAC/C,sBAAsB,CAAC,EAAE,OAAO,CAAC;CACpC;AA+PD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAiD,KAAK,CAAC,yBAAyB,CAC9G,0BAA0B,GAAG,KAAK,CAAC,aAAa,CAAC,wBAAwB,CAAC,CAC7E,CAAC;AAIF;;;GAGG;AACH,eAAO,MAAM,6BAA6B,qHAEzC,CAAC"}

package/lib/glomo-standard-checkout.js

@@ -34,7 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GlomoStandardCheckout = void 0;
+exports.GlomoStandardCheckoutInternal = exports.GlomoStandardCheckout = void 0;
 const react_1 = __importStar(require("react"));
 const react_native_1 = require("react-native");
 const react_native_webview_1 = require("react-native-webview");
@@ -57,7 +57,7 @@ const validation_1 = require("./utils/validation");
  * @param ref - The ref for the component
  * @param devMode - Turn on to see all logs, warnings, and errors in the console. Off by default
  */
-function GlomoStandardCheckoutComponent({ server, publicKey, orderId, onPaymentSuccess, onPaymentFailure, onConnectionError, onPaymentTerminate, onSdkError, onBankTransferSubmitted, onPayViaBankCompleted, onPayViaBankBankConnectionSuccessful, onUserRefusedCameraPermissions, devMode = false, }, ref) {
+function GlomoStandardCheckoutComponent({ server, publicKey, orderId, onPaymentSuccess, onPaymentFailure, onConnectionError, onPaymentTerminate, onSdkError, onUserJourneyCompleted, onUserRefusedCameraPermissions, devMode = false, _analyticsTrackers, _skipOrderIdValidation, }, ref) {
     // Computing mockMode based on the publicKey prefix
     const mockMode = (0, react_1.useMemo)(() => {
         var _a;
@@ -76,12 +76,10 @@ function GlomoStandardCheckoutComponent({ server, publicKey, orderId, onPaymentS
         onConnectionError,
         onPaymentTerminate,
         onSdkError,
-        onBankTransferSubmitted,
-        onPayViaBankCompleted,
-        onPayViaBankBankConnectionSuccessful,
+        onUserJourneyCompleted,
         onUserRefusedCameraPermissions,
         devMode,
-    }, mockMode);
+    }, mockMode, { analyticsTrackers: _analyticsTrackers, _skipOrderIdValidation });
     // Exposing the start() and getStatus() methods via the ref
     (0, react_1.useImperativeHandle)(ref, () => ({
         start,
@@ -160,8 +158,19 @@ function GlomoStandardCheckoutComponent({ server, publicKey, orderId, onPaymentS
             </react_native_1.View>
         </ModalComponent>);
 }
+/**
+ * Widening the internal type to GlomoStandardCheckoutInternalProps for internal SDK use,
+ * then narrowing the public export to GlomoStandardCheckoutProps so merchants cannot
+ * pass internal-only props like _analyticsTrackers.
+ */
 exports.GlomoStandardCheckout = (0, react_1.forwardRef)(GlomoStandardCheckoutComponent);
 exports.GlomoStandardCheckout.displayName = "GlomoStandardCheckout";
+/**
+ * Internal reference - accepts GlomoStandardCheckoutInternalProps.
+ * Not re-exported from index.ts.
+ */
+exports.GlomoStandardCheckoutInternal = (0, react_1.forwardRef)(GlomoStandardCheckoutComponent);
+exports.GlomoStandardCheckoutInternal.displayName = "GlomoStandardCheckoutInternal";
 const styles = react_native_1.StyleSheet.create({
     modalContainer: {
         flex: 1,

package/lib/glomo-subscriptions-checkout.d.ts

@@ -0,0 +1,8 @@
+/**
+ * GlomoSubscriptionsCheckout - thin wrapper around GlomoStandardCheckout
+ * that accepts a subscriptionId (sub_*) instead of an orderId (order_*).
+ */
+import React from "react";
+import { type GlomoSubscriptionsCheckoutProps, type GlomoSubscriptionsCheckoutRef } from "./types/subscriptions-checkout";
+export declare const GlomoSubscriptionsCheckout: React.ForwardRefExoticComponent<GlomoSubscriptionsCheckoutProps & React.RefAttributes<GlomoSubscriptionsCheckoutRef>>;
+//# sourceMappingURL=glomo-subscriptions-checkout.d.ts.map

package/lib/glomo-subscriptions-checkout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glomo-subscriptions-checkout.d.ts","sourceRoot":"","sources":["../src/glomo-subscriptions-checkout.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAA6D,MAAM,OAAO,CAAC;AAIlF,OAAO,EACH,KAAK,+BAA+B,EACpC,KAAK,6BAA6B,EACrC,MAAM,gCAAgC,CAAC;AAkExC,eAAO,MAAM,0BAA0B,uHAEtC,CAAC"}

package/lib/glomo-subscriptions-checkout.js

@@ -0,0 +1,85 @@
+"use strict";
+/**
+ * GlomoSubscriptionsCheckout - thin wrapper around GlomoStandardCheckout
+ * that accepts a subscriptionId (sub_*) instead of an orderId (order_*).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GlomoSubscriptionsCheckout = void 0;
+const react_1 = __importStar(require("react"));
+const glomo_standard_checkout_1 = require("./glomo-standard-checkout");
+const analytics_1 = require("./utils/analytics");
+const validation_1 = require("./utils/validation");
+function GlomoSubscriptionsCheckoutComponent(props, ref) {
+    const { subscriptionId: rawSubscriptionId, onSdkError, devMode = false, ...rest } = props;
+    const innerRef = (0, react_1.useRef)(null);
+    const onSdkErrorRef = (0, react_1.useRef)(onSdkError);
+    onSdkErrorRef.current = onSdkError;
+    const subscriptionId = rawSubscriptionId.trim();
+    /** Validating subscriptionId - firing onSdkError via useEffect to avoid side effects during render */
+    const validationError = (() => {
+        if (subscriptionId.length === 0) {
+            return "subscriptionId must not be empty";
+        }
+        if (!subscriptionId.startsWith("sub_")) {
+            return "subscriptionId must start with 'sub_'";
+        }
+        return null;
+    })();
+    (0, react_1.useEffect)(() => {
+        if (validationError) {
+            (0, validation_1.safeCallback)(onSdkErrorRef.current, [[{ type: "validation_error", message: validationError }]], "onSdkError", devMode);
+        }
+    }, [validationError, devMode]);
+    (0, react_1.useImperativeHandle)(ref, () => ({
+        start: () => {
+            var _a, _b;
+            if (validationError) {
+                return false;
+            }
+            return (_b = (_a = innerRef.current) === null || _a === void 0 ? void 0 : _a.start()) !== null && _b !== void 0 ? _b : false;
+        },
+        getStatus: () => {
+            var _a, _b;
+            return (_b = (_a = innerRef.current) === null || _a === void 0 ? void 0 : _a.getStatus()) !== null && _b !== void 0 ? _b : "ready";
+        },
+    }));
+    if (validationError) {
+        return null;
+    }
+    return (<glomo_standard_checkout_1.GlomoStandardCheckoutInternal ref={innerRef} {...rest} orderId={subscriptionId} onSdkError={onSdkError} devMode={devMode} _analyticsTrackers={analytics_1.subscriptionCheckoutTrackers} _skipOrderIdValidation={true}/>);
+}
+exports.GlomoSubscriptionsCheckout = (0, react_1.forwardRef)(GlomoSubscriptionsCheckoutComponent);
+exports.GlomoSubscriptionsCheckout.displayName = "GlomoSubscriptionsCheckout";

package/lib/index.d.ts

@@ -1,7 +1,7 @@
-/** The GlomoPay RN SDK v3 exports */
+/** The GlomoPay RN SDK v4 exports */
 export { GlomoCheckout } from "./glomo-checkout";
-export { type GlomoCheckoutRef, type GlomoCheckoutProps, type GlomoCheckoutPayload, type CheckoutStatus, type GlomoBankTransferPayload, type GlomoPayViaBankConnectionPayload, } from "./types/checkout";
+export { type GlomoCheckoutRef, type GlomoCheckoutProps, type GlomoCheckoutPayload, type CheckoutStatus, type GlomoUserJourneyCompletedPayload, ASYNC_PAYMENT_EVENTS, } from "./types/checkout";
 export { type GlomoServer } from "./config/base";
 export { type SdkError } from "./utils/analytics";
-export { useGlomoCheckout } from "./use-glomo-checkout";
+export { useGlomoCheckout, type UseGlomoCheckoutReturn } from "./use-glomo-checkout";
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,qCAAqC;AAGrC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EACH,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,wBAAwB,EAC7B,KAAK,gCAAgC,GACxC,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,qCAAqC;AAGrC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EACH,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,gCAAgC,EACrC,oBAAoB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,MAAM,sBAAsB,CAAC"}

package/lib/index.js

@@ -1,9 +1,11 @@
 "use strict";
-/** The GlomoPay RN SDK v3 exports */
+/** The GlomoPay RN SDK v4 exports */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useGlomoCheckout = exports.GlomoCheckout = void 0;
-// v3 public API - unified checkout
+exports.useGlomoCheckout = exports.ASYNC_PAYMENT_EVENTS = exports.GlomoCheckout = void 0;
+// v4 public API - unified checkout
 var glomo_checkout_1 = require("./glomo-checkout");
 Object.defineProperty(exports, "GlomoCheckout", { enumerable: true, get: function () { return glomo_checkout_1.GlomoCheckout; } });
+var checkout_1 = require("./types/checkout");
+Object.defineProperty(exports, "ASYNC_PAYMENT_EVENTS", { enumerable: true, get: function () { return checkout_1.ASYNC_PAYMENT_EVENTS; } });
 var use_glomo_checkout_1 = require("./use-glomo-checkout");
 Object.defineProperty(exports, "useGlomoCheckout", { enumerable: true, get: function () { return use_glomo_checkout_1.useGlomoCheckout; } });

package/lib/types/checkout.d.ts

@@ -1,4 +1,4 @@
-/** Unified v3 type definitions for GlomoCheckout */
+/** Unified v4 type definitions for GlomoCheckout */
 import { type GlomoServer } from "../config/base";
 import { type SdkError } from "../utils/analytics";
 /** The payload for a successful or failed payment (unified across LRS and standard) */
@@ -7,19 +7,22 @@ export interface GlomoCheckoutPayload {
     paymentId: string;
     signature: string;
 }
-/** The payload for a bank transfer submission */
-export interface GlomoBankTransferPayload {
-    orderId: string;
-    senderAccountNumber: string;
-    transactionReference: string;
+/**
+ * Enum of asynchronous payment events that trigger the
+ * onUserJourneyCompleted callback. New events will be added
+ * here as additional flows are supported.
+ */
+export declare enum ASYNC_PAYMENT_EVENTS {
+    BANK_TRANSFER_SUBMITTED = "bank_transfer_submitted",
+    PAY_VIA_BANK_COMPLETED = "pay_via_bank_completed"
 }
-/** The payload for a pay via bank - bank connection successful event */
-export interface GlomoPayViaBankConnectionPayload {
-    bankIdentifier: string;
-    cooldownPeriodInMinutes: number;
-    bankName: string;
-    bankImageSrc: string;
-    bankImageAlt: string;
+/** The payload for the onUserJourneyCompleted callback */
+export interface GlomoUserJourneyCompletedPayload {
+    journeyType: ASYNC_PAYMENT_EVENTS;
+    orderId?: string;
+    status?: string;
+    senderAccountNumber?: string;
+    transactionReference?: string;
 }
 /** Unified checkout statuses - superset of LRS + standard statuses */
 export type CheckoutStatus = "ready" | "detecting_order_type" | "payment_in_progress" | "payment_successful" | "payment_failed" | "payment_cancelled" | "bank_transfer_submitted" | "pay_via_bank_completed";
@@ -32,22 +35,30 @@ export interface GlomoCheckoutRef {
     start: () => Promise<boolean>;
     getStatus: () => CheckoutStatus;
 }
-/** Props for the unified checkout component */
-export interface GlomoCheckoutProps {
+/** Shared callback and configuration props for the unified checkout component */
+interface GlomoCheckoutBaseProps {
     server?: GlomoServer;
     publicKey: string;
-    orderId: string;
     onPaymentSuccess: (payload: GlomoCheckoutPayload) => void;
     onPaymentFailure: (payload: GlomoCheckoutPayload) => void;
     onConnectionError?: (error: unknown) => void;
     onPaymentTerminate?: () => void;
-    onSdkError?: (error: Array<SdkError>) => void;
-    onBankTransferSubmitted?: (payload: GlomoBankTransferPayload | null | undefined) => void;
-    onPayViaBankCompleted?: (payload: {
-        status: string;
-    }) => void;
-    onPayViaBankBankConnectionSuccessful?: (payload: GlomoPayViaBankConnectionPayload | null | undefined) => void;
+    onSdkError: (error: Array<SdkError>) => void;
+    onUserJourneyCompleted?: (payload: GlomoUserJourneyCompletedPayload) => void;
     onUserRefusedCameraPermissions?: () => void;
     devMode?: boolean;
 }
+/**
+ * Props for the unified checkout component.
+ * Exactly one of orderId or subscriptionId must be provided.
+ * TypeScript enforces this at compile time; a runtime guard in useGlomoCheckout catches JS consumers.
+ */
+export type GlomoCheckoutProps = GlomoCheckoutBaseProps & ({
+    orderId: string;
+    subscriptionId?: never;
+} | {
+    subscriptionId: string;
+    orderId?: never;
+});
+export {};
 //# sourceMappingURL=checkout.d.ts.map

package/lib/types/checkout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checkout.d.ts","sourceRoot":"","sources":["../../src/types/checkout.ts"],"names":[],"mappings":"AAAA,oDAAoD;AAEpD,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,uFAAuF;AACvF,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,iDAAiD;AACjD,MAAM,WAAW,wBAAwB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,oBAAoB,EAAE,MAAM,CAAC;CAChC;AAED,wEAAwE;AACxE,MAAM,WAAW,gCAAgC;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,uBAAuB,EAAE,MAAM,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,sEAAsE;AACtE,MAAM,MAAM,cAAc,GACpB,OAAO,GACP,sBAAsB,GACtB,qBAAqB,GACrB,oBAAoB,GACpB,gBAAgB,GAChB,mBAAmB,GACnB,yBAAyB,GACzB,wBAAwB,CAAC;AAE/B;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,cAAc,CAAC;CACnC;AAED,+CAA+C;AAC/C,MAAM,WAAW,kBAAkB;IAC/B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC1D,gBAAgB,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC1D,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;IAChC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;IAC9C,uBAAuB,CAAC,EAAE,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI,GAAG,SAAS,KAAK,IAAI,CAAC;IACzF,qBAAqB,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC9D,oCAAoC,CAAC,EAAE,CAAC,OAAO,EAAE,gCAAgC,GAAG,IAAI,GAAG,SAAS,KAAK,IAAI,CAAC;IAC9G,8BAA8B,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB"}
+{"version":3,"file":"checkout.d.ts","sourceRoot":"","sources":["../../src/types/checkout.ts"],"names":[],"mappings":"AAAA,oDAAoD;AAEpD,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,uFAAuF;AACvF,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,oBAAY,oBAAoB;IAC5B,uBAAuB,4BAA4B;IACnD,sBAAsB,2BAA2B;CACpD;AAED,0DAA0D;AAC1D,MAAM,WAAW,gCAAgC;IAC7C,WAAW,EAAE,oBAAoB,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,sEAAsE;AACtE,MAAM,MAAM,cAAc,GACpB,OAAO,GACP,sBAAsB,GACtB,qBAAqB,GACrB,oBAAoB,GACpB,gBAAgB,GAChB,mBAAmB,GACnB,yBAAyB,GACzB,wBAAwB,CAAC;AAE/B;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,cAAc,CAAC;CACnC;AAED,iFAAiF;AACjF,UAAU,sBAAsB;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC1D,gBAAgB,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC1D,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;IAChC,UAAU,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;IAC7C,sBAAsB,CAAC,EAAE,CAAC,OAAO,EAAE,gCAAgC,KAAK,IAAI,CAAC;IAC7E,8BAA8B,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,sBAAsB,GACnD,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC,CAAC"}

package/lib/types/checkout.js

@@ -1,3 +1,14 @@
 "use strict";
-/** Unified v3 type definitions for GlomoCheckout */
+/** Unified v4 type definitions for GlomoCheckout */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ASYNC_PAYMENT_EVENTS = void 0;
+/**
+ * Enum of asynchronous payment events that trigger the
+ * onUserJourneyCompleted callback. New events will be added
+ * here as additional flows are supported.
+ */
+var ASYNC_PAYMENT_EVENTS;
+(function (ASYNC_PAYMENT_EVENTS) {
+    ASYNC_PAYMENT_EVENTS["BANK_TRANSFER_SUBMITTED"] = "bank_transfer_submitted";
+    ASYNC_PAYMENT_EVENTS["PAY_VIA_BANK_COMPLETED"] = "pay_via_bank_completed";
+})(ASYNC_PAYMENT_EVENTS || (exports.ASYNC_PAYMENT_EVENTS = ASYNC_PAYMENT_EVENTS = {}));

package/lib/types/standard-checkout.d.ts

@@ -1,7 +1,7 @@
 /** Type definitions for the Standard Checkout flow */
 import { type GlomoServer } from "../config/base";
 import { type SdkError } from "../utils/analytics";
-import { type GlomoBankTransferPayload, type GlomoPayViaBankConnectionPayload } from "./checkout";
+import { type GlomoUserJourneyCompletedPayload } from "./checkout";
 /** Standard checkout statuses */
 export type StandardCheckoutStatus = "ready" | "payment_in_progress" | "payment_successful" | "payment_failed" | "payment_cancelled" | "bank_transfer_submitted" | "pay_via_bank_completed";
 /** The payload for a successful or failed standard payment */
@@ -28,12 +28,8 @@ export interface GlomoStandardCheckoutProps {
     onPaymentFailure: (payload: GlomoStandardCheckoutPayload) => void;
     onConnectionError?: (error: unknown) => void;
     onPaymentTerminate?: () => void;
-    onSdkError?: (error: Array<SdkError>) => void;
-    onBankTransferSubmitted?: (payload: GlomoBankTransferPayload | null | undefined) => void;
-    onPayViaBankCompleted?: (payload: {
-        status: string;
-    }) => void;
-    onPayViaBankBankConnectionSuccessful?: (payload: GlomoPayViaBankConnectionPayload | null | undefined) => void;
+    onSdkError: (error: Array<SdkError>) => void;
+    onUserJourneyCompleted?: (payload: GlomoUserJourneyCompletedPayload) => void;
     onUserRefusedCameraPermissions?: () => void;
     devMode?: boolean;
 }

package/lib/types/standard-checkout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"standard-checkout.d.ts","sourceRoot":"","sources":["../../src/types/standard-checkout.ts"],"names":[],"mappings":"AAAA,sDAAsD;AAEtD,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,KAAK,wBAAwB,EAAE,KAAK,gCAAgC,EAAE,MAAM,YAAY,CAAC;AAElG,iCAAiC;AACjC,MAAM,MAAM,sBAAsB,GAC5B,OAAO,GACP,qBAAqB,GACrB,oBAAoB,GACpB,gBAAgB,GAChB,mBAAmB,GACnB,yBAAyB,GACzB,wBAAwB,CAAC;AAE/B,8DAA8D;AAC9D,MAAM,WAAW,4BAA4B;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACrC,KAAK,EAAE,MAAM,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,sBAAsB,CAAC;CAC3C;AAED,gDAAgD;AAChD,MAAM,WAAW,0BAA0B;IACvC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,CAAC,OAAO,EAAE,4BAA4B,KAAK,IAAI,CAAC;IAClE,gBAAgB,EAAE,CAAC,OAAO,EAAE,4BAA4B,KAAK,IAAI,CAAC;IAClE,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;IAChC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;IAC9C,uBAAuB,CAAC,EAAE,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI,GAAG,SAAS,KAAK,IAAI,CAAC;IACzF,qBAAqB,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC9D,oCAAoC,CAAC,EAAE,CAAC,OAAO,EAAE,gCAAgC,GAAG,IAAI,GAAG,SAAS,KAAK,IAAI,CAAC;IAC9G,8BAA8B,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB"}
+{"version":3,"file":"standard-checkout.d.ts","sourceRoot":"","sources":["../../src/types/standard-checkout.ts"],"names":[],"mappings":"AAAA,sDAAsD;AAEtD,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,KAAK,gCAAgC,EAAE,MAAM,YAAY,CAAC;AAEnE,iCAAiC;AACjC,MAAM,MAAM,sBAAsB,GAC5B,OAAO,GACP,qBAAqB,GACrB,oBAAoB,GACpB,gBAAgB,GAChB,mBAAmB,GACnB,yBAAyB,GACzB,wBAAwB,CAAC;AAE/B,8DAA8D;AAC9D,MAAM,WAAW,4BAA4B;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACrC,KAAK,EAAE,MAAM,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,sBAAsB,CAAC;CAC3C;AAED,gDAAgD;AAChD,MAAM,WAAW,0BAA0B;IACvC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,CAAC,OAAO,EAAE,4BAA4B,KAAK,IAAI,CAAC;IAClE,gBAAgB,EAAE,CAAC,OAAO,EAAE,4BAA4B,KAAK,IAAI,CAAC;IAClE,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;IAChC,UAAU,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;IAC7C,sBAAsB,CAAC,EAAE,CAAC,OAAO,EAAE,gCAAgC,KAAK,IAAI,CAAC;IAC7E,8BAA8B,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB"}

package/lib/types/subscriptions-checkout.d.ts

@@ -0,0 +1,29 @@
+/** Type definitions for the Subscriptions Checkout flow */
+import { type GlomoServer } from "../config/base";
+import { type SdkError } from "../utils/analytics";
+import { type GlomoCheckoutPayload, type GlomoUserJourneyCompletedPayload } from "./checkout";
+import { type StandardCheckoutStatus } from "./standard-checkout";
+/** Props for the subscriptions checkout component */
+export interface GlomoSubscriptionsCheckoutProps {
+    server?: GlomoServer;
+    publicKey: string;
+    subscriptionId: string;
+    onPaymentSuccess: (payload: GlomoCheckoutPayload) => void;
+    onPaymentFailure: (payload: GlomoCheckoutPayload) => void;
+    onConnectionError?: (error: unknown) => void;
+    onPaymentTerminate?: () => void;
+    onSdkError: (error: Array<SdkError>) => void;
+    onUserJourneyCompleted?: (payload: GlomoUserJourneyCompletedPayload) => void;
+    onUserRefusedCameraPermissions?: () => void;
+    devMode?: boolean;
+}
+/**
+ * Ref handle for the subscriptions checkout component.
+ * Same type as GlomoStandardCheckoutRef - start() is async at the unified level
+ * but delegates to the synchronous standard checkout start() internally.
+ */
+export interface GlomoSubscriptionsCheckoutRef {
+    start: () => boolean;
+    getStatus: () => StandardCheckoutStatus;
+}
+//# sourceMappingURL=subscriptions-checkout.d.ts.map

package/lib/types/subscriptions-checkout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions-checkout.d.ts","sourceRoot":"","sources":["../../src/types/subscriptions-checkout.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAE3D,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,KAAK,oBAAoB,EAAE,KAAK,gCAAgC,EAAE,MAAM,YAAY,CAAC;AAC9F,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,qDAAqD;AACrD,MAAM,WAAW,+BAA+B;IAC5C,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC1D,gBAAgB,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC1D,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;IAChC,UAAU,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;IAC7C,sBAAsB,CAAC,EAAE,CAAC,OAAO,EAAE,gCAAgC,KAAK,IAAI,CAAC;IAC7E,8BAA8B,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,6BAA6B;IAC1C,KAAK,EAAE,MAAM,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,sBAAsB,CAAC;CAC3C"}

package/lib/types/subscriptions-checkout.js

@@ -0,0 +1,3 @@
+"use strict";
+/** Type definitions for the Subscriptions Checkout flow */
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/use-glomo-checkout.d.ts

@@ -5,20 +5,50 @@
 import { type GlomoCheckoutProps, type CheckoutStatus } from "./types/checkout";
 import { type GlomoLrsCheckoutRef } from "./glomo-lrs-checkout";
 import { type GlomoStandardCheckoutRef } from "./types/standard-checkout";
+import { type GlomoSubscriptionsCheckoutRef } from "./types/subscriptions-checkout";
 import { type OrderType } from "./services/order-type-fetcher";
-/** The return values for the useGlomoCheckout hook */
+/** Extended order type including subscriptions */
+type ExtendedOrderType = OrderType | "subscriptions";
+/**
+ * Public return type for useGlomoCheckout.
+ * Exposes only start() and getStatus() - no internal refs or state.
+ */
 export interface UseGlomoCheckoutReturn {
-    orderType: OrderType | null;
+    start: () => Promise<boolean>;
+    getStatus: () => CheckoutStatus;
+}
+/**
+ * Internal return type - used by GlomoCheckout component.
+ * Not exported from the public API.
+ */
+export interface UseGlomoCheckoutInternalReturn {
+    orderType: ExtendedOrderType | null;
     detecting: boolean;
     start: () => Promise<boolean>;
     getStatus: () => CheckoutStatus;
     innerLrsRef: React.RefObject<GlomoLrsCheckoutRef>;
     innerStandardRef: React.RefObject<GlomoStandardCheckoutRef>;
+    innerSubscriptionsRef: React.RefObject<GlomoSubscriptionsCheckoutRef>;
     props: GlomoCheckoutProps;
 }
 /**
- * The main unified checkout hook.
- * Validates inputs, detects order type via API, then auto-starts the resolved inner component.
+ * @deprecated Legacy hook - will be removed in a future major version.
+ *
+ * This hook does not provide reactive state. `getStatus()` returns a
+ * point-in-time snapshot and does not trigger re-renders on status changes.
+ * `start()` returns a promise identical to `GlomoCheckoutRef.start()`.
+ *
+ * Use the `GlomoCheckout` component with a ref instead:
+ *
+ * ```tsx
+ * const ref = useRef<GlomoCheckoutRef>(null);
+ * const started = await ref.current?.start();
+ * const status = ref.current?.getStatus();
+ * ```
  */
 export declare function useGlomoCheckout(props: GlomoCheckoutProps): UseGlomoCheckoutReturn;
+export declare function useGlomoCheckout(props: GlomoCheckoutProps, internalOptions: {
+    _suppressDeprecationWarning: true;
+}): UseGlomoCheckoutInternalReturn;
+export {};
 //# sourceMappingURL=use-glomo-checkout.d.ts.map

package/lib/use-glomo-checkout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-glomo-checkout.d.ts","sourceRoot":"","sources":["../src/use-glomo-checkout.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,KAAK,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EAAE,KAAK,SAAS,EAAkB,MAAM,+BAA+B,CAAC;AAS/E,sDAAsD;AACtD,MAAM,WAAW,sBAAsB;IACnC,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,cAAc,CAAC;IAChC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;IAClD,gBAAgB,EAAE,KAAK,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC;IAC5D,KAAK,EAAE,kBAAkB,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,GAAG,sBAAsB,CAiMlF"}
+{"version":3,"file":"use-glomo-checkout.d.ts","sourceRoot":"","sources":["../src/use-glomo-checkout.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,KAAK,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EAAE,KAAK,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AACpF,OAAO,EAAE,KAAK,SAAS,EAAkB,MAAM,+BAA+B,CAAC;AAU/E,kDAAkD;AAClD,KAAK,iBAAiB,GAAG,SAAS,GAAG,eAAe,CAAC;AAErD;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACnC,KAAK,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,cAAc,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC3C,SAAS,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,cAAc,CAAC;IAChC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;IAClD,gBAAgB,EAAE,KAAK,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC;IAC5D,qBAAqB,EAAE,KAAK,CAAC,SAAS,CAAC,6BAA6B,CAAC,CAAC;IACtE,KAAK,EAAE,kBAAkB,CAAC;CAC7B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,GAAG,sBAAsB,CAAC;AACpF,wBAAgB,gBAAgB,CAC5B,KAAK,EAAE,kBAAkB,EACzB,eAAe,EAAE;IAAE,2BAA2B,EAAE,IAAI,CAAA;CAAE,GACvD,8BAA8B,CAAC"}