storefront-layouts-staging 1.0.0-staging.0

package/dist/lib/order-success-cart.d.ts

@@ -0,0 +1,5 @@
+export declare function setOrderSuccessJustCompleted(orderId: string): void;
+/** True while a checkout flow is navigating to success/callback (cart may already be cleared). */
+export declare function isOrderSuccessPending(): boolean;
+export declare function consumeOrderSuccessJustCompleted(orderId: string, alternateOrderIds?: string[]): boolean;
+//# sourceMappingURL=order-success-cart.d.ts.map

package/dist/lib/order-success-cart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order-success-cart.d.ts","sourceRoot":"","sources":["../../src/lib/order-success-cart.ts"],"names":[],"mappings":"AAOA,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAOlE;AAED,kGAAkG;AAClG,wBAAgB,qBAAqB,IAAI,OAAO,CAW/C;AAED,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,MAAM,EACf,iBAAiB,GAAE,MAAM,EAAO,GAC/B,OAAO,CAcT"}

package/dist/lib/order-success-cart.js

@@ -0,0 +1,50 @@
+/**
+ * Marker used to distinguish "user just completed this order" (remove purchased items from cart)
+ * from "user is viewing a past order / re-added same items to buy again" (do not remove).
+ */
+const KEY = 'order_success_just_completed';
+const TTL_MS = 2 * 60 * 1000; // 2 minutes
+export function setOrderSuccessJustCompleted(orderId) {
+    if (typeof window === 'undefined')
+        return;
+    try {
+        window.sessionStorage.setItem(KEY, `${orderId}|${Date.now()}`);
+    }
+    catch {
+        // ignore
+    }
+}
+/** True while a checkout flow is navigating to success/callback (cart may already be cleared). */
+export function isOrderSuccessPending() {
+    if (typeof window === 'undefined')
+        return false;
+    try {
+        const raw = window.sessionStorage.getItem(KEY);
+        if (!raw)
+            return false;
+        const [, tsStr] = raw.split('|');
+        const ts = tsStr ? parseInt(tsStr, 10) : 0;
+        return !isNaN(ts) && Date.now() - ts < TTL_MS;
+    }
+    catch {
+        return false;
+    }
+}
+export function consumeOrderSuccessJustCompleted(orderId, alternateOrderIds = []) {
+    if (typeof window === 'undefined')
+        return false;
+    try {
+        const raw = window.sessionStorage.getItem(KEY);
+        if (!raw)
+            return false;
+        const [storedOrderId, tsStr] = raw.split('|');
+        const ts = tsStr ? parseInt(tsStr, 10) : 0;
+        const candidates = new Set([orderId, ...alternateOrderIds].filter(Boolean));
+        const valid = candidates.has(storedOrderId) && !isNaN(ts) && Date.now() - ts < TTL_MS;
+        window.sessionStorage.removeItem(KEY);
+        return valid;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/lib/payaza-checkout.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Payaza Checkout SDK Integration
+ * Based on Payaza Web SDK documentation: https://docs.payaza.africa/developers/apis/sdks/web-sdk
+ *
+ * Implementation uses npm package: payaza_staging_sdk
+ * Method: setup(config).showPopup()
+ */
+export type PayazaConnectionMode = 'Live' | 'Test';
+/** Map backend payazaConnectionMode (or legacy environment values) to SDK connection mode. */
+export declare function normalizeConnectionMode(value?: string | null): PayazaConnectionMode;
+export interface PayazaCheckoutConfig {
+    publicKey?: string;
+    /** Payaza SDK connection mode — from backend payazaConnectionMode when available. */
+    connectionMode?: 'Live' | 'Test';
+    amount: number;
+    currency?: string;
+    email: string;
+    firstName?: string;
+    lastName?: string;
+    phone?: string;
+    reference?: string;
+    description?: string;
+    callbackUrl?: string;
+    storeId?: string;
+    orderId?: string;
+    orderNumber?: string;
+    /** Exact order reference sent to Payaza as merchant_reference (no TRX prefix). */
+    merchantReference?: string;
+    shippingAddress?: {
+        firstName?: string;
+        lastName?: string;
+        address?: string;
+        city?: string;
+        state?: string;
+        country?: string;
+        zipCode?: string;
+    };
+    metadata?: Record<string, unknown>;
+    onSuccess?: (response: PayazaCheckoutResponse) => void;
+    onError?: (error: string) => void;
+    onClose?: () => void;
+    /** Called when the checkout iframe has loaded; use to cancel any loading timeout so the user can complete payment without time limit. */
+    onCheckoutLoaded?: () => void;
+}
+export interface PayazaCurrency {
+    name: string;
+    code: string;
+    unicode: string;
+    html_value: string;
+    enabled: boolean;
+}
+export interface PayazaCustomer {
+    customer_id: string;
+    email_address: string;
+    first_name: string;
+    last_name: string;
+    mobile_number: string;
+}
+export interface PayazaSuccessData {
+    message: string;
+    payaza_reference: string;
+    transaction_reference: string;
+    transaction_fee: number;
+    transaction_total_amount: number;
+    currency: PayazaCurrency;
+    customer: PayazaCustomer;
+    /** Echoed from checkout config so backend can match pending payments */
+    merchant_reference?: string;
+    additional_details?: Record<string, unknown>;
+}
+export interface PayazaSuccessCallback {
+    type: 'success';
+    status: number;
+    data: PayazaSuccessData;
+}
+export interface PayazaCheckoutResponse {
+    status: 'success' | 'error';
+    message?: string;
+    transactionRef?: string;
+    checkoutUrl?: string;
+    callbackData?: PayazaSuccessCallback;
+}
+export declare function validateAndNormalizeCurrency(currency: string | null | undefined): string;
+/**
+ * Validate and normalize currency with fallback
+ * @param currency - Currency code to validate
+ * @param fallback - Fallback currency if validation fails (default: 'USD')
+ * @returns Validated uppercase ISO 4217 currency code or fallback
+ */
+export declare function validateAndNormalizeCurrencyWithFallback(currency: string | null | undefined, fallback?: string): string;
+/**
+ * Extract currency from items with fallback logic
+ * Handles mixed currencies by using the most common currency, or first item's currency
+ * All currencies are validated and normalized to ISO 4217 format
+ */
+export declare function getCurrencyFromItems(items: Array<{
+    product?: {
+        currency?: string;
+    };
+}>, fallbackCurrency?: string): string;
+/**
+ * Remove all Payaza SDK DOM nodes (loader overlay + invisible iframe).
+ * The SDK appends a fullscreen fixed iframe at max z-index; if checkout never
+ * loads, only the spinner is removed and the invisible iframe blocks all clicks.
+ */
+export declare function teardownPayazaCheckoutDom(): void;
+/**
+ * Initialize Payaza checkout using SDK
+ * Uses setup() function from payaza-web-sdk npm package as per official documentation
+ */
+export declare const initiatePayazaCheckout: (config: PayazaCheckoutConfig) => Promise<PayazaCheckoutResponse>;
+/**
+ * Generate checkout config from cart items
+ */
+export declare const generateCheckoutConfig: (items: Array<{
+    product: {
+        name: string;
+        price: number;
+        currency?: string;
+    };
+    quantity: number;
+    price: number;
+}>, customerEmail: string, publicKey: string, options?: {
+    firstName?: string;
+    lastName?: string;
+    phone?: string;
+    callbackUrl?: string;
+    currency?: string;
+    storeId?: string;
+    orderId?: string;
+    orderNumber?: string;
+    /** Exact order reference for Payaza merchant_reference (no TRX prefix). */
+    merchantReference?: string;
+    /** Full amount to charge (subtotal + tax + shipping + service charge). When set, customer is debited this amount; otherwise amount is derived from items only. */
+    totalAmount?: number;
+    connectionMode?: PayazaConnectionMode;
+    shippingAddress?: {
+        firstName?: string;
+        lastName?: string;
+        address?: string;
+        city?: string;
+        state?: string;
+        country?: string;
+        zipCode?: string;
+    };
+}) => PayazaCheckoutConfig;
+//# sourceMappingURL=payaza-checkout.d.ts.map

package/dist/lib/payaza-checkout.d.ts.map

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