@alphawebai/hs-prism 0.1.0-rc.49 → 0.1.0-rc.50

package/dist/src/alphaweb/manifest.d.ts

@@ -1,7 +1,7 @@
 export declare const ALPHAWEB_STRIPE_WEBHOOK_EVENTS: readonly ["charge.dispute.closed", "charge.dispute.created", "charge.dispute.funds_reinstated", "charge.dispute.funds_withdrawn", "charge.dispute.updated", "mandate.updated", "payment_intent.amount_capturable_updated", "payment_intent.canceled", "payment_intent.payment_failed", "payment_intent.processing", "payment_intent.requires_action", "payment_intent.succeeded", "payment_method.attached", "payment_method.automatically_updated", "payment_method.detached", "payment_method.updated", "refund.created", "refund.failed", "refund.updated", "setup_intent.canceled", "setup_intent.requires_action", "setup_intent.setup_failed", "setup_intent.succeeded"];
 export declare const ALPHAWEB_PAYPAL_WEBHOOK_EVENTS: readonly ["CHECKOUT.ORDER.APPROVED", "CHECKOUT.ORDER.COMPLETED", "CHECKOUT.ORDER.PROCESSED", "CHECKOUT.PAYMENT-APPROVAL.REVERSED", "CUSTOMER.DISPUTE.CREATED", "CUSTOMER.DISPUTE.RESOLVED", "CUSTOMER.DISPUTE.UPDATED", "PAYMENT.AUTHORIZATION.CREATED", "PAYMENT.AUTHORIZATION.VOIDED", "PAYMENT.CAPTURE.COMPLETED", "PAYMENT.CAPTURE.DECLINED", "PAYMENT.CAPTURE.PENDING", "PAYMENT.CAPTURE.REFUNDED", "PAYMENT.CAPTURE.REVERSED", "PAYMENT.REFUND.FAILED", "PAYMENT.REFUND.PENDING", "RISK.DISPUTE.CREATED", "VAULT.PAYMENT-TOKEN.CREATED", "VAULT.PAYMENT-TOKEN.DELETED", "VAULT.PAYMENT-TOKEN.DELETION-INITIATED"];
 export declare const ALPHAWEB_PRISM_COMPATIBILITY_MANIFEST: Readonly<{
-    readonly release: "0.1.0-rc.49";
+    readonly release: "0.1.0-rc.50";
     readonly upstreamCommit: "b07af7d9dac271de729548e74217ddcf895c602b";
     readonly medusaRange: ">=2.17.2 <2.18.0";
     readonly stripeApiVersion: "2026-06-24.dahlia";

package/dist/src/alphaweb/manifest.js

@@ -49,7 +49,7 @@ exports.ALPHAWEB_PAYPAL_WEBHOOK_EVENTS = Object.freeze([
     'VAULT.PAYMENT-TOKEN.DELETION-INITIATED',
 ]);
 exports.ALPHAWEB_PRISM_COMPATIBILITY_MANIFEST = Object.freeze({
-    release: '0.1.0-rc.49',
+    release: '0.1.0-rc.50',
     upstreamCommit: 'b07af7d9dac271de729548e74217ddcf895c602b',
     medusaRange: '>=2.17.2 <2.18.0',
     stripeApiVersion: '2026-06-24.dahlia',

package/dist/src/alphaweb/paypal-connector.js

@@ -5,6 +5,7 @@ exports.verifyPrismPayPalRuntimeCredential = verifyPrismPayPalRuntimeCredential;
 const node_crypto_1 = require("node:crypto");
 const _generated_connector_client_flows_1 = require("../payments/_generated_connector_client_flows");
 const proto_1 = require("../payments/generated/proto");
+const errors_1 = require("../payments/errors");
 const error_1 = require("./error");
 const manifest_1 = require("./manifest");
 const money_1 = require("./money");
@@ -27,6 +28,29 @@ function readSecret(value) {
 function secret(value) {
     return { value };
 }
+function shippingAddressMessage(input) {
+    if (input.shippingAddress === undefined)
+        return undefined;
+    const address = recordOf(input.shippingAddress);
+    const country = typeof address.countryCode === 'string' ? address.countryCode.trim().toUpperCase() : '';
+    const countryCode = proto_1.types.CountryAlpha2[country];
+    if (!/^[A-Z]{2}$/.test(country) || typeof countryCode !== 'number' ||
+        typeof address.line1 !== 'string' || !address.line1.trim()) {
+        throw validationError('The delivery address is incomplete.', 'PRISM_SHIPPING_ADDRESS');
+    }
+    const fields = ['firstName', 'lastName', 'line1', 'line2', 'city', 'state', 'postalCode'];
+    const shippingAddress = { countryAlpha2Code: countryCode };
+    for (const field of fields) {
+        const value = address[field];
+        if (value === undefined || value === '')
+            continue;
+        if (typeof value !== 'string') {
+            throw validationError('The delivery address is invalid.', 'PRISM_SHIPPING_ADDRESS');
+        }
+        shippingAddress[field === 'postalCode' ? 'zipCode' : field] = secret(value.trim());
+    }
+    return { shippingAddress };
+}
 function configurationError(safeMessage, code) {
     return new error_1.PrismOperationError({
         category: 'configuration',
@@ -939,6 +963,7 @@ class PrismPayPalConnector {
             const setupFutureUsage = futureUseRequested(input);
             const recurringAgreement = recurringAgreementMessage(input);
             const continuation = browserContinuation(input);
+            const address = shippingAddressMessage(input);
             const state = await this.connectorState();
             const captureMethod = input.metadata.alphaweb_capture_method === 'manual'
                 ? proto_1.types.CaptureMethod.MANUAL
@@ -959,6 +984,7 @@ class PrismPayPalConnector {
                     : proto_1.types.MitCategory.MIT_CATEGORY_UNSPECIFIED,
                 ...(recurringAgreement ? { recurringAgreement } : {}),
                 ...(continuation ?? {}),
+                ...(address ? { address } : {}),
             });
             const orderId = stringOf(order.connectorOrderId);
             if (!orderId) {
@@ -980,6 +1006,24 @@ class PrismPayPalConnector {
             };
         }
         catch (error) {
+            const details = error instanceof errors_1.ConnectorError
+                ? error.proto.errorInfo?.connectorDetails ?? error.proto.error_info?.connector_details
+                : undefined;
+            const providerCode = details?.code;
+            const shippingRejected = ['SHIPPING_ADDRESS_INVALID', 'CITY_REQUIRED', 'POSTAL_CODE_REQUIRED']
+                .includes(providerCode ?? '');
+            // Only these explicit Orders v2 creation rejections prove no order was
+            // created. Never apply this classification to approval/capture or timeouts.
+            if (error instanceof errors_1.ConnectorError && error.httpStatusCode === 422 &&
+                error.errorCode === 'CONNECTOR_ERROR_RESPONSE' &&
+                (providerCode === 'CURRENCY_NOT_SUPPORTED' || shippingRejected)) {
+                throw new error_1.PrismOperationError({ category: 'validation', providerCode,
+                    retryable: false, outcome: 'definitely_not_applied',
+                    safeMessage: shippingRejected
+                        ? 'Please check your delivery address, then try PayPal again.'
+                        : 'PayPal is unavailable for this currency. Please choose another payment method.',
+                }, { cause: error });
+            }
             throw (0, error_1.normalizePrismError)(error);
         }
     }
@@ -1050,6 +1094,7 @@ class PrismPayPalConnector {
             throw validationError('PayPal reusable payment reference is incomplete.', 'PRISM_REFERENCE_NOT_READY');
         }
         try {
+            const address = shippingAddressMessage(input);
             const state = await this.connectorState();
             const response = await this.dependencies.recurringPayments.charge({
                 merchantChargeId: input.idempotencyKey,
@@ -1070,6 +1115,7 @@ class PrismPayPalConnector {
                 paymentMethodType: proto_1.types.PaymentMethodType.PAY_PAL,
                 offSession: true,
                 mitCategory: repeatPaymentMitCategory(input),
+                ...(address ? { address } : {}),
                 state,
                 testMode: this.options.environment === 'test',
             });

package/dist/src/alphaweb/types.d.ts

@@ -10,6 +10,17 @@ export interface PrismMoney {
     amountMinor: string;
     currency: string;
 }
+/** Merchant-collected delivery address, independent of the wallet's saved address. */
+export interface PrismShippingAddress {
+    firstName?: string;
+    lastName?: string;
+    line1: string;
+    line2?: string;
+    city?: string;
+    state?: string;
+    postalCode?: string;
+    countryCode: string;
+}
 export type PrismReusableCapability = 'off_session' | 'post_purchase' | 'manual_capture' | 'subscription';
 export type PrismFutureUsePurpose = 'post_purchase' | 'subscription';
 export type PrismRecurringIntervalUnit = 'day' | 'week' | 'month' | 'year';
@@ -102,6 +113,7 @@ export interface PrismMerchantOperation {
     kind: PrismOperationKind;
     money: PrismMoney;
     customerReference?: string;
+    shippingAddress?: PrismShippingAddress;
     reusableReference?: PrismReusablePaymentReference;
     futureUse?: PrismFutureUseIntent;
     browserContinuation?: PrismBrowserContinuation;

package/dist/src/payments/generated/libconnector_service_ffi.so

@@ -1,4 +1,4 @@
 [diffend] Oversized file quarantined before diffing.
 name: package/dist/src/payments/generated/libconnector_service_ffi.so
-size: 105624624 bytes
-sha256: 02988fe20af64d5bbbcde81861e2592b66fad08f80680b5a7382026df9e0e382
+size: 105631296 bytes
+sha256: db5dcad8916768dbd4a2e2c5949baeffdfc852421d73bbd5e1e572ac1d8d25ae

package/dist/src/payments/generated/proto.d.ts

@@ -15336,6 +15336,9 @@ export namespace types {
 
         /** PaymentServiceCreateOrderRequest cancelUrl */
         cancelUrl?: (string|null);
+
+        /** Merchant-collected delivery/billing details. Existing callers may omit it. */
+        address?: (types.IPaymentAddress|null);
     }
 
     /** Request message for creating an order */
@@ -15405,6 +15408,9 @@ export namespace types {
         /** PaymentServiceCreateOrderRequest cancelUrl. */
         public cancelUrl?: (string|null);
 
+        /** Merchant-collected delivery/billing details. Existing callers may omit it. */
+        public address?: (types.IPaymentAddress|null);
+
         /**
          * Creates a new PaymentServiceCreateOrderRequest instance using the specified properties.
          * @param [properties] Properties to set

package/dist/src/payments/generated/proto.js

@@ -48196,6 +48196,7 @@ $root.types = (function() {
          * @property {string|null} [returnUrl] Provider-owned buyer continuation URLs for approval flows. Connectors that
          * require future-use approval must fail closed when either URL is absent.
          * @property {string|null} [cancelUrl] PaymentServiceCreateOrderRequest cancelUrl
+         * @property {types.IPaymentAddress|null} [address] Merchant-collected delivery/billing details. Existing callers may omit it.
          */
 
         /**
@@ -48331,6 +48332,14 @@ $root.types = (function() {
          */
         PaymentServiceCreateOrderRequest.prototype.cancelUrl = null;
 
+        /**
+         * Merchant-collected delivery/billing details. Existing callers may omit it.
+         * @member {types.IPaymentAddress|null|undefined} address
+         * @memberof types.PaymentServiceCreateOrderRequest
+         * @instance
+         */
+        PaymentServiceCreateOrderRequest.prototype.address = null;
+
         // OneOf field names bound to virtual getters and setters
         var $oneOfFields;
 
@@ -48412,6 +48421,12 @@ $root.types = (function() {
             set: $util.oneOfSetter($oneOfFields)
         });
 
+        // Virtual OneOf for proto3 optional field
+        Object.defineProperty(PaymentServiceCreateOrderRequest.prototype, "_address", {
+            get: $util.oneOfGetter($oneOfFields = ["address"]),
+            set: $util.oneOfSetter($oneOfFields)
+        });
+
         /**
          * Creates a new PaymentServiceCreateOrderRequest instance using the specified properties.
          * @function create
@@ -48468,6 +48483,8 @@ $root.types = (function() {
                 writer.uint32(/* id 13, wireType 2 =*/106).string(message.returnUrl);
             if (message.cancelUrl != null && Object.hasOwnProperty.call(message, "cancelUrl"))
                 writer.uint32(/* id 14, wireType 2 =*/114).string(message.cancelUrl);
+            if (message.address != null && Object.hasOwnProperty.call(message, "address"))
+                $root.types.PaymentAddress.encode(message.address, writer.uint32(/* id 15, wireType 2 =*/122).fork(), q + 1).ldelim();
             return writer;
         };
 
@@ -48551,6 +48568,10 @@ $root.types = (function() {
                         message.cancelUrl = reader.string();
                         break;
                     }
+                case 15: {
+                        message.address = $root.types.PaymentAddress.decode(reader, reader.uint32(), undefined, long + 1);
+                        break;
+                    }
                 default:
                     reader.skipType(tag & 7, long);
                     break;
@@ -48798,6 +48819,14 @@ $root.types = (function() {
                 if (!$util.isString(message.cancelUrl))
                     return "cancelUrl: string expected";
             }
+            if (message.address != null && Object.hasOwnProperty.call(message, "address")) {
+                properties._address = 1;
+                {
+                    var error = $root.types.PaymentAddress.verify(message.address, long + 1);
+                    if (error)
+                        return "address." + error;
+                }
+            }
             return null;
         };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alphawebai/hs-prism",
-  "version": "0.1.0-rc.49",
+  "version": "0.1.0-rc.50",
   "description": "Hyperswitch Payments SDK — Node.js client for connector integrations via UniFFI FFI",
   "main": "dist/src/index.js",
   "exports": {