@glomopay/react-native-sdk 3.0.1 → 3.1.0

package/lib/index.d.ts

@@ -3,5 +3,5 @@ export { GlomoCheckout } from "./glomo-checkout";
 export { type GlomoCheckoutRef, type GlomoCheckoutProps, type GlomoCheckoutPayload, type CheckoutStatus, type GlomoBankTransferPayload, type GlomoPayViaBankConnectionPayload, } 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,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,KAAK,sBAAsB,EAAE,MAAM,sBAAsB,CAAC"}

package/lib/types/checkout.d.ts

@@ -32,11 +32,10 @@ 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;
@@ -50,4 +49,17 @@ export interface GlomoCheckoutProps {
     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,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,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,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;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/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 GlomoPayViaBankConnectionPayload } 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;
+    onPayViaBankBankConnectionSuccessful?: (payload: GlomoPayViaBankConnectionPayload | null | undefined) => 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,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;IAC9C,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;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"}

package/lib/use-glomo-checkout.js

@@ -9,19 +9,51 @@ const react_1 = require("react");
 const order_type_fetcher_1 = require("./services/order-type-fetcher");
 const validation_1 = require("./utils/validation");
 const analytics_1 = require("./utils/analytics");
-/**
- * The main unified checkout hook.
- * Validates inputs, detects order type via API, then auto-starts the resolved inner component.
- */
-function useGlomoCheckout(props) {
-    const { server, publicKey, orderId, onSdkError, devMode = false } = props;
+function useGlomoCheckout(props, internalOptions) {
+    var _a, _b;
+    const { server, publicKey, orderId, subscriptionId, onSdkError, devMode = false } = props;
     // Order type resolved from the API - null until detection completes
     const [orderType, setOrderType] = (0, react_1.useState)(null);
     // Whether order type detection is in progress
     const [detecting, setDetecting] = (0, react_1.useState)(false);
-    // Refs for the inner LRS and Standard checkout components
+    // Whether the props have a mutual exclusion error
+    const [propsError, setPropsError] = (0, react_1.useState)(false);
+    // Stabilizing onSdkError ref to avoid re-running effects on inline callback changes
+    const onSdkErrorRef = (0, react_1.useRef)(onSdkError);
+    onSdkErrorRef.current = onSdkError;
+    // One-time deprecation warning for direct merchant usage
+    const suppressWarning = (_a = internalOptions === null || internalOptions === void 0 ? void 0 : internalOptions._suppressDeprecationWarning) !== null && _a !== void 0 ? _a : false;
+    const mockMode = (_b = publicKey === null || publicKey === void 0 ? void 0 : publicKey.toLowerCase().startsWith("test_")) !== null && _b !== void 0 ? _b : false;
+    const hasWarnedRef = (0, react_1.useRef)(false);
+    (0, react_1.useEffect)(() => {
+        if (!hasWarnedRef.current && !suppressWarning) {
+            hasWarnedRef.current = true;
+            console.warn("[Glomo-RN-SDK] useGlomoCheckout is deprecated and will be removed in a future major version. " +
+                "Use the GlomoCheckout component with a ref instead. " +
+                "This hook does not provide reactive state - getStatus() is a point-in-time snapshot, not a reactive value.");
+            (0, analytics_1.trackUseOfUnsupportedFunctionality)("useGlomoCheckout", orderId !== null && orderId !== void 0 ? orderId : subscriptionId, publicKey, devMode, mockMode, "");
+        }
+    }, [suppressWarning, orderId, subscriptionId, publicKey, devMode, mockMode]);
+    // Refs for the inner LRS, Standard, and Subscriptions checkout components
     const innerLrsRef = (0, react_1.useRef)(null);
     const innerStandardRef = (0, react_1.useRef)(null);
+    const innerSubscriptionsRef = (0, react_1.useRef)(null);
+    /** Mutual exclusion guard - firing onSdkError if both or neither id is provided */
+    (0, react_1.useEffect)(() => {
+        const hasBoth = Boolean(orderId) && Boolean(subscriptionId);
+        const hasNeither = !orderId && !subscriptionId;
+        if (hasBoth) {
+            setPropsError(true);
+            (0, validation_1.safeCallback)(onSdkErrorRef.current, [[{ type: "validation_error", message: "Provide either orderId or subscriptionId, not both" }]], "onSdkError", devMode);
+        }
+        else if (hasNeither) {
+            setPropsError(true);
+            (0, validation_1.safeCallback)(onSdkErrorRef.current, [[{ type: "validation_error", message: "Provide orderId or subscriptionId" }]], "onSdkError", devMode);
+        }
+        else {
+            setPropsError(false);
+        }
+    }, [orderId, subscriptionId, devMode]);
     /**
      * Tracking whether start() has been called and the inner component needs to be auto-started.
      * This bridges the gap between order type resolution (async) and inner component mount (next render).
@@ -51,6 +83,9 @@ function useGlomoCheckout(props) {
         if (orderType === "standard" && innerStandardRef.current) {
             return innerStandardRef.current.getStatus();
         }
+        if (orderType === "subscriptions" && innerSubscriptionsRef.current) {
+            return innerSubscriptionsRef.current.getStatus();
+        }
         return "ready";
     }, [detecting, orderType]);
     /**
@@ -66,6 +101,13 @@ function useGlomoCheckout(props) {
         if (devMode) {
             console.log("[Glomo-RN-SDK] start() called");
         }
+        // Aborting if mutual exclusion guard detected a props error
+        if (propsError) {
+            if (devMode) {
+                console.error("[Glomo-RN-SDK] start() aborted: invalid orderId/subscriptionId combination");
+            }
+            return false;
+        }
         // Validating inputs before making the API call
         const errors = [];
         if (!(0, validation_1.isValidPublicKey)(publicKey)) {
@@ -75,7 +117,11 @@ function useGlomoCheckout(props) {
                 field: "publicKey",
             });
         }
-        if (!(0, validation_1.isValidOrderId)(orderId)) {
+        /**
+         * For subscriptions flow, skipping orderId validation entirely - GlomoSubscriptionsCheckout
+         * owns subscriptionId validation (trim, empty, prefix). For order flow, validating orderId.
+         */
+        if (!subscriptionId && !(0, validation_1.isValidOrderId)(orderId)) {
             errors.push({
                 type: "validation_error",
                 message: "Invalid orderId: must start with 'order_' and be a valid string",
@@ -90,6 +136,23 @@ function useGlomoCheckout(props) {
             (0, validation_1.safeCallback)(onSdkError, [errors], "onSdkError", devMode);
             return false;
         }
+        /**
+         * For subscriptions, orderType is already "subscriptions" and the inner component is mounted.
+         * Calling start() directly - no promise/effect bridge needed since no async detection occurs.
+         */
+        if (subscriptionId) {
+            if (innerSubscriptionsRef.current) {
+                const started = innerSubscriptionsRef.current.start();
+                if (devMode) {
+                    console.log(`[Glomo-RN-SDK] Subscriptions inner start() returned: ${started}`);
+                }
+                return started;
+            }
+            if (devMode) {
+                console.error("[Glomo-RN-SDK] Subscriptions component not mounted");
+            }
+            return false;
+        }
         // Detecting order type via the API
         setDetecting(true);
         const thisGeneration = ++fetchGenerationRef.current;
@@ -97,7 +160,7 @@ function useGlomoCheckout(props) {
             console.log("[Glomo-RN-SDK] Detecting order type...");
         }
         (0, analytics_1.trackOrderTypeDetectionStarted)(orderId, publicKey, devMode);
-        const result = await (0, order_type_fetcher_1.fetchOrderType)({ orderId, publicKey, server, devMode });
+        const result = await (0, order_type_fetcher_1.fetchOrderType)({ orderId: orderId, publicKey, server, devMode });
         // Discarding stale result if props changed while the fetch was in flight
         if (thisGeneration !== fetchGenerationRef.current) {
             if (devMode) {
@@ -126,7 +189,7 @@ function useGlomoCheckout(props) {
             pendingStartResolveRef.current = resolve;
             pendingStartRef.current = true;
         });
-    }, [devMode, publicKey, orderId, server, onSdkError]);
+    }, [devMode, publicKey, orderId, subscriptionId, server, onSdkError, propsError]);
     /**
      * Auto-starting the inner component after order type is resolved and the component has rendered.
      * The pendingStartRef bridges the async gap: start() sets it, and this effect fires after
@@ -152,13 +215,23 @@ function useGlomoCheckout(props) {
                 console.log(`[Glomo-RN-SDK] Standard inner start() returned: ${started}`);
             }
         }
+        else if (orderType === "subscriptions") {
+            // No-op: subscription start() calls the inner component directly (not via this effect bridge).
+            // If we reach here, pendingStartRef was set unexpectedly - resolve false defensively.
+            pendingStartRef.current = false;
+        }
         // Resolving the merchant's awaited start() promise with the inner component's result
         if (pendingStartResolveRef.current) {
             pendingStartResolveRef.current(started);
             pendingStartResolveRef.current = null;
         }
     }, [orderType, devMode]);
-    // Resetting order type state when orderId or publicKey changes to force re-detection
+    /**
+     * Resetting order type state when orderId, subscriptionId, or publicKey changes.
+     * For subscriptions, setting orderType to "subscriptions" directly (no API call needed).
+     * For orders, resetting to null to force re-detection on next start().
+     * Single effect owns all orderType transitions to avoid race conditions.
+     */
     (0, react_1.useEffect)(() => {
         // Invalidating any in-flight fetchOrderType call so its stale result is discarded
         fetchGenerationRef.current++;
@@ -166,10 +239,15 @@ function useGlomoCheckout(props) {
             pendingStartResolveRef.current(false);
             pendingStartResolveRef.current = null;
         }
-        setOrderType(null);
         setDetecting(false);
         pendingStartRef.current = false;
-    }, [orderId, publicKey]);
+        if (subscriptionId && !orderId) {
+            setOrderType("subscriptions");
+        }
+        else {
+            setOrderType(null);
+        }
+    }, [orderId, subscriptionId, publicKey]);
     return {
         orderType,
         detecting,
@@ -177,6 +255,7 @@ function useGlomoCheckout(props) {
         getStatus,
         innerLrsRef,
         innerStandardRef,
+        innerSubscriptionsRef,
         props,
     };
 }

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

@@ -3,7 +3,7 @@ import React from "react";
 import { type NativeSyntheticEvent } from "react-native";
 import { type WebViewNavigation, type WebViewMessageEvent, type WebView } from "react-native-webview";
 import { type GlomoServer } from "./config/base";
-import { type SdkError } from "./utils/analytics";
+import { type SdkError, type CheckoutAnalyticsTrackers } from "./utils/analytics";
 import { type GlomoBankTransferPayload, type GlomoPayViaBankConnectionPayload } from "./types/checkout";
 import { type StandardCheckoutStatus, type GlomoStandardCheckoutPayload } from "./types/standard-checkout";
 /** Android-only WebView permission request, not yet in react-native-webview type definitions */
@@ -60,6 +60,15 @@ export interface UseStandardCheckoutReturn {
     injectedMain?: string;
     injectedFlow?: string;
 }
+/**
+ * Internal options for useStandardCheckout.
+ * Used by subscription checkout to inject subscription-specific analytics trackers.
+ * Not exported to merchants.
+ */
+export interface UseStandardCheckoutInternalOptions {
+    analyticsTrackers?: CheckoutAnalyticsTrackers;
+    _skipOrderIdValidation?: boolean;
+}
 /** The main SDK hook for the GlomoPay Standard Checkout flow */
-export declare function useStandardCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymentFailure, onConnectionError, onPaymentTerminate, onSdkError, onBankTransferSubmitted, onPayViaBankCompleted, onPayViaBankBankConnectionSuccessful, onUserRefusedCameraPermissions, devMode, }: UseStandardCheckoutOptions, mockMode: boolean): UseStandardCheckoutReturn;
+export declare function useStandardCheckout({ server, publicKey, orderId, onPaymentSuccess, onPaymentFailure, onConnectionError, onPaymentTerminate, onSdkError, onBankTransferSubmitted, onPayViaBankCompleted, onPayViaBankBankConnectionSuccessful, onUserRefusedCameraPermissions, devMode, }: UseStandardCheckoutOptions, mockMode: boolean, internalOptions?: UseStandardCheckoutInternalOptions): UseStandardCheckoutReturn;
 //# sourceMappingURL=use-standard-checkout.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"use-standard-checkout.d.ts","sourceRoot":"","sources":["../src/use-standard-checkout.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"use-standard-checkout.d.ts","sourceRoot":"","sources":["../src/use-standard-checkout.tsx"],"names":[],"mappings":"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"}