@bondsports/types 2.4.88 → 2.4.89

package/dist/types/terminal/dto/terminal-actions.dto.d.ts

@@ -4,6 +4,7 @@ import { PlatformsEnum } from '../../services/enums.service';
 import { TerminalActionCancelRequestReasonEnum } from '../types/enums/terminal-action.enums';
 import { TerminalReaderActionStatusEnum, TerminalReaderActionTypeEnum } from '../types/enums/terminal-readers.enums';
 import { TerminalPresentPaymentMethodTypeEnum } from './terminal-actions.enums';
+export declare const TERMINAL_IDEMPOTENCY_KEY_MAX_LENGTH = 128;
 export declare class TerminalPaymentIntentDto {
     amount: number;
     customer: string;
@@ -23,7 +24,8 @@ export declare class TerminalProcessSetupIntentOverrideConfigDto {
     allow_redisplay: 'always' | 'limited' | 'unspecified';
 }
 export declare class ProcessTerminalPaymentDto {
-    paymentIntent: TerminalPaymentIntentDto;
+    paymentIntent?: TerminalPaymentIntentDto;
+    paymentIntentId?: string;
     force?: boolean;
     overrideConfig?: TerminalProcessPaymentOverrideConfigDto;
     idempotencyKey?: string;

package/dist/types/terminal/dto/terminal-actions.dto.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TerminalCancelActionResponseDto = exports.TerminalActionResponseDto = exports.TerminalOverrideResultDto = exports.TerminalOverridePreviousActionDto = exports.TerminalActionInitiatedByDto = exports.TerminalActionStateDto = exports.ProcessTerminalRefundDto = exports.ProcessTerminalSetupIntentDto = exports.PresentTerminalPaymentMethodDto = exports.CollectTerminalInputsDto = exports.TerminalCollectInputTypeEnum = exports.CancelTerminalActionDto = exports.ProcessTerminalPaymentDto = exports.TerminalProcessSetupIntentOverrideConfigDto = exports.TerminalProcessPaymentOverrideConfigDto = exports.TerminalProcessPaymentTippingDto = exports.TerminalPaymentIntentDto = void 0;
+exports.TerminalCancelActionResponseDto = exports.TerminalActionResponseDto = exports.TerminalOverrideResultDto = exports.TerminalOverridePreviousActionDto = exports.TerminalActionInitiatedByDto = exports.TerminalActionStateDto = exports.ProcessTerminalRefundDto = exports.ProcessTerminalSetupIntentDto = exports.PresentTerminalPaymentMethodDto = exports.CollectTerminalInputsDto = exports.TerminalCollectInputTypeEnum = exports.CancelTerminalActionDto = exports.ProcessTerminalPaymentDto = exports.TerminalProcessSetupIntentOverrideConfigDto = exports.TerminalProcessPaymentOverrideConfigDto = exports.TerminalProcessPaymentTippingDto = exports.TerminalPaymentIntentDto = exports.TERMINAL_IDEMPOTENCY_KEY_MAX_LENGTH = void 0;
 const TERMINAL_PAYMENT_METHOD_TYPES_MAX = 10;
-const TERMINAL_IDEMPOTENCY_KEY_MAX_LENGTH = 128;
+exports.TERMINAL_IDEMPOTENCY_KEY_MAX_LENGTH = 128;
 const TERMINAL_CARD_NUMBER_MAX_LENGTH = 19;
 class TerminalPaymentIntentDto {
 }
@@ -16,6 +16,13 @@ exports.TerminalProcessPaymentOverrideConfigDto = TerminalProcessPaymentOverride
 class TerminalProcessSetupIntentOverrideConfigDto {
 }
 exports.TerminalProcessSetupIntentOverrideConfigDto = TerminalProcessSetupIntentOverrideConfigDto;
+/**
+ * Whether `idempotencyKey`'s validators should run on a process-payment body. They always run when the
+ * client supplied a key, and additionally when `paymentIntentId` is set, which makes the key mandatory:
+ * a reserved intent id holds the rest of the Stripe key steady across attempts, so without a rotating
+ * client key Stripe replays the first attempt's cached response — including its error — for 24 hours.
+ */
+const requiresIdempotencyKeyValidation = (dto) => Boolean(dto.paymentIntentId) || dto.idempotencyKey !== undefined;
 class ProcessTerminalPaymentDto {
 }
 exports.ProcessTerminalPaymentDto = ProcessTerminalPaymentDto;

package/dist/types/terminal/dto/terminal-actions.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"terminal-actions.dto.js","sourceRoot":"","sources":["../../../../src/types/terminal/dto/terminal-actions.dto.ts"],"names":[],"mappings":";;;AASA,MAAM,iCAAiC,GAAG,EAAE,CAAC;AAC7C,MAAM,mCAAmC,GAAG,GAAG,CAAC;AAChD,MAAM,+BAA+B,GAAG,EAAE,CAAC;AAE3C,MAAa,wBAAwB;CAYpC;AAZD,4DAYC;AAED,MAAa,gCAAgC;CAE5C;AAFD,4EAEC;AAED,MAAa,uCAAuC;CAInD;AAJD,0FAIC;AAED,MAAa,2CAA2C;CAEvD;AAFD,kGAEC;AAED,MAAa,yBAAyB;CAQrC;AARD,8DAQC;AAED,MAAa,uBAAuB;CAEnC;AAFD,0DAEC;AAED,IAAY,4BAGX;AAHD,WAAY,4BAA4B;IACvC,uEAAuC,CAAA;IACvC,+DAA+B,CAAA;AAChC,CAAC,EAHW,4BAA4B,GAA5B,oCAA4B,KAA5B,oCAA4B,QAGvC;AAED,MAAa,wBAAwB;CAIpC;AAJD,4DAIC;AAED,MAAa,+BAA+B;CAM3C;AAND,0EAMC;AAED,MAAa,6BAA6B;CAQzC;AARD,sEAQC;AAED,MAAa,wBAAwB;CAQpC;AARD,4DAQC;AAED,MAAa,sBAAsB;CAIlC;AAJD,wDAIC;AAED,MAAa,4BAA4B;CAMxC;AAND,oEAMC;AAED,MAAa,iCAAiC;CAI7C;AAJD,8EAIC;AAED,MAAa,yBAAyB;CAIrC;AAJD,8DAIC;AAED,MAAa,yBAAyB;CAcrC;AAdD,8DAcC;AAED,MAAa,+BAA+B;CAM3C;AAND,0EAMC"}
+{"version":3,"file":"terminal-actions.dto.js","sourceRoot":"","sources":["../../../../src/types/terminal/dto/terminal-actions.dto.ts"],"names":[],"mappings":";;;AASA,MAAM,iCAAiC,GAAG,EAAE,CAAC;AAChC,QAAA,mCAAmC,GAAG,GAAG,CAAC;AACvD,MAAM,+BAA+B,GAAG,EAAE,CAAC;AAE3C,MAAa,wBAAwB;CAYpC;AAZD,4DAYC;AAED,MAAa,gCAAgC;CAE5C;AAFD,4EAEC;AAED,MAAa,uCAAuC;CAInD;AAJD,0FAIC;AAED,MAAa,2CAA2C;CAEvD;AAFD,kGAEC;AAED;;;;;GAKG;AACH,MAAM,gCAAgC,GAAG,CAAC,GAA8B,EAAW,EAAE,CACpF,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,GAAG,CAAC,cAAc,KAAK,SAAS,CAAC;AAElE,MAAa,yBAAyB;CAUrC;AAVD,8DAUC;AAED,MAAa,uBAAuB;CAEnC;AAFD,0DAEC;AAED,IAAY,4BAGX;AAHD,WAAY,4BAA4B;IACvC,uEAAuC,CAAA;IACvC,+DAA+B,CAAA;AAChC,CAAC,EAHW,4BAA4B,GAA5B,oCAA4B,KAA5B,oCAA4B,QAGvC;AAED,MAAa,wBAAwB;CAIpC;AAJD,4DAIC;AAED,MAAa,+BAA+B;CAM3C;AAND,0EAMC;AAED,MAAa,6BAA6B;CAQzC;AARD,sEAQC;AAED,MAAa,wBAAwB;CAQpC;AARD,4DAQC;AAED,MAAa,sBAAsB;CAIlC;AAJD,wDAIC;AAED,MAAa,4BAA4B;CAMxC;AAND,oEAMC;AAED,MAAa,iCAAiC;CAI7C;AAJD,8EAIC;AAED,MAAa,yBAAyB;CAIrC;AAJD,8DAIC;AAED,MAAa,yBAAyB;CAcrC;AAdD,8DAcC;AAED,MAAa,+BAA+B;CAM3C;AAND,0EAMC"}

package/dist/types/terminal/types/consts/terminal-action.consts.d.ts

@@ -1,3 +1,4 @@
+import Stripe from 'stripe';
 export declare const ACTIVE_ACTION_TTL_SECONDS = 300;
 export declare const GHOST_CANCEL_TTL_SECONDS = 300;
 export declare const GHOST_CANCEL_RETRY_COOLDOWN_MS = 30000;
@@ -6,3 +7,10 @@ export declare const STRIPE_PAYMENT_INTENT_UNEXPECTED_STATE_CODE = "payment_inte
 export declare const STRIPE_TERMINAL_READER_BUSY_CODE = "terminal_reader_busy";
 export declare const STRIPE_TERMINAL_READER_OFFLINE_CODE = "terminal_reader_offline";
 export declare const STRIPE_TERMINAL_READER_TIMEOUT_CODE = "terminal_reader_timeout";
+/**
+ * Statuses a PaymentIntent may hold when it is handed to a reader for `process_payment_intent`.
+ * A declined charge returns the intent to `requires_payment_method`, so retries stay dispatchable,
+ * while `processing`, `requires_capture`, `succeeded`, and `canceled` are all past the point where
+ * another reader charge is safe.
+ */
+export declare const DISPATCHABLE_PAYMENT_INTENT_STATUSES: ReadonlySet<Stripe.PaymentIntent.Status>;

package/dist/types/terminal/types/consts/terminal-action.consts.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.STRIPE_TERMINAL_READER_TIMEOUT_CODE = exports.STRIPE_TERMINAL_READER_OFFLINE_CODE = exports.STRIPE_TERMINAL_READER_BUSY_CODE = exports.STRIPE_PAYMENT_INTENT_UNEXPECTED_STATE_CODE = exports.LOCK_TTL_MS = exports.GHOST_CANCEL_RETRY_COOLDOWN_MS = exports.GHOST_CANCEL_TTL_SECONDS = exports.ACTIVE_ACTION_TTL_SECONDS = void 0;
+exports.DISPATCHABLE_PAYMENT_INTENT_STATUSES = exports.STRIPE_TERMINAL_READER_TIMEOUT_CODE = exports.STRIPE_TERMINAL_READER_OFFLINE_CODE = exports.STRIPE_TERMINAL_READER_BUSY_CODE = exports.STRIPE_PAYMENT_INTENT_UNEXPECTED_STATE_CODE = exports.LOCK_TTL_MS = exports.GHOST_CANCEL_RETRY_COOLDOWN_MS = exports.GHOST_CANCEL_TTL_SECONDS = exports.ACTIVE_ACTION_TTL_SECONDS = void 0;
 exports.ACTIVE_ACTION_TTL_SECONDS = 300;
 exports.GHOST_CANCEL_TTL_SECONDS = 300;
 exports.GHOST_CANCEL_RETRY_COOLDOWN_MS = 30000;
@@ -9,4 +9,14 @@ exports.STRIPE_PAYMENT_INTENT_UNEXPECTED_STATE_CODE = 'payment_intent_unexpected
 exports.STRIPE_TERMINAL_READER_BUSY_CODE = 'terminal_reader_busy';
 exports.STRIPE_TERMINAL_READER_OFFLINE_CODE = 'terminal_reader_offline';
 exports.STRIPE_TERMINAL_READER_TIMEOUT_CODE = 'terminal_reader_timeout';
+/**
+ * Statuses a PaymentIntent may hold when it is handed to a reader for `process_payment_intent`.
+ * A declined charge returns the intent to `requires_payment_method`, so retries stay dispatchable,
+ * while `processing`, `requires_capture`, `succeeded`, and `canceled` are all past the point where
+ * another reader charge is safe.
+ */
+exports.DISPATCHABLE_PAYMENT_INTENT_STATUSES = new Set([
+    'requires_payment_method',
+    'requires_confirmation',
+]);
 //# sourceMappingURL=terminal-action.consts.js.map

package/dist/types/terminal/types/consts/terminal-action.consts.js.map

@@ -1 +1 @@
-{"version":3,"file":"terminal-action.consts.js","sourceRoot":"","sources":["../../../../../src/types/terminal/types/consts/terminal-action.consts.ts"],"names":[],"mappings":";;;AAAa,QAAA,yBAAyB,GAAG,GAAG,CAAC;AAEhC,QAAA,wBAAwB,GAAG,GAAG,CAAC;AAE/B,QAAA,8BAA8B,GAAG,KAAM,CAAC;AAExC,QAAA,WAAW,GAAG,KAAM,CAAC;AAErB,QAAA,2CAA2C,GAAG,iCAAiC,CAAC;AAEhF,QAAA,gCAAgC,GAAG,sBAAsB,CAAC;AAE1D,QAAA,mCAAmC,GAAG,yBAAyB,CAAC;AAEhE,QAAA,mCAAmC,GAAG,yBAAyB,CAAC"}
+{"version":3,"file":"terminal-action.consts.js","sourceRoot":"","sources":["../../../../../src/types/terminal/types/consts/terminal-action.consts.ts"],"names":[],"mappings":";;;AAEa,QAAA,yBAAyB,GAAG,GAAG,CAAC;AAEhC,QAAA,wBAAwB,GAAG,GAAG,CAAC;AAE/B,QAAA,8BAA8B,GAAG,KAAM,CAAC;AAExC,QAAA,WAAW,GAAG,KAAM,CAAC;AAErB,QAAA,2CAA2C,GAAG,iCAAiC,CAAC;AAEhF,QAAA,gCAAgC,GAAG,sBAAsB,CAAC;AAE1D,QAAA,mCAAmC,GAAG,yBAAyB,CAAC;AAEhE,QAAA,mCAAmC,GAAG,yBAAyB,CAAC;AAE7E;;;;;GAKG;AACU,QAAA,oCAAoC,GAA6C,IAAI,GAAG,CAAC;IACrG,yBAAyB;IACzB,uBAAuB;CACvB,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@bondsports/types",
-	"version": "2.4.88",
+	"version": "2.4.89",
 	"description": "backend types module for Bond-Sports",
 	"main": "./dist/index.js",
 	"scripts": {