@bondsports/types 2.4.84 → 2.4.85

package/dist/types/terminal/types/enums/terminal-readers.enums.d.ts

@@ -0,0 +1,47 @@
+export declare enum TerminalReaderDeviceTypeEnum {
+    BBPOS_WISEPAD3 = "bbpos_wisepad3",
+    STRIPE_M2 = "stripe_m2",
+    STRIPE_S700 = "stripe_s700",
+    BBPOS_CHIPPER2X = "bbpos_chipper2x",
+    BBPOS_WISEPOS_E = "bbpos_wisepos_e",
+    VERIFONE_P400 = "verifone_P400",
+    SIMULATED_WISEPOS_E = "simulated_wisepos_e",
+    SIMULATED_STRIPE_S700 = "simulated_stripe_s700",
+    MOBILE_PHONE_READER = "mobile_phone_reader",
+    STRIPE_S710 = "stripe_s710",
+    VERIFONE_V660P = "verifone_v660p",
+    VERIFONE_UX700 = "verifone_ux700",
+    VERIFONE_P630 = "verifone_p630",
+    VERIFONE_M425 = "verifone_m425",
+    SIMULATED_STRIPE_S710 = "simulated_stripe_s710",
+    SIMULATED_VERIFONE_V660P = "simulated_verifone_v660p",
+    SIMULATED_VERIFONE_UX700 = "simulated_verifone_ux700",
+    SIMULATED_VERIFONE_P630 = "simulated_verifone_p630",
+    SIMULATED_VERIFONE_M425 = "simulated_verifone_m425"
+}
+export declare enum SimulatedTerminalReaderDeviceTypeEnum {
+    SIMULATED_WISEPOS_E = "simulated_wisepos_e",
+    SIMULATED_STRIPE_S700 = "simulated_stripe_s700",
+    SIMULATED_STRIPE_S710 = "simulated_stripe_s710",
+    SIMULATED_VERIFONE_V660P = "simulated_verifone_v660p",
+    SIMULATED_VERIFONE_UX700 = "simulated_verifone_ux700",
+    SIMULATED_VERIFONE_P630 = "simulated_verifone_p630",
+    SIMULATED_VERIFONE_M425 = "simulated_verifone_m425"
+}
+export declare enum TerminalReaderStatusEnum {
+    OFFLINE = "offline",
+    ONLINE = "online"
+}
+export declare enum TerminalReaderActionStatusEnum {
+    FAILED = "failed",
+    IN_PROGRESS = "in_progress",
+    SUCCEEDED = "succeeded"
+}
+export declare enum TerminalReaderActionTypeEnum {
+    COLLECT_INPUTS = "collect_inputs",
+    PROCESS_PAYMENT_INTENT = "process_payment_intent",
+    PROCESS_SETUP_INTENT = "process_setup_intent",
+    PRESENT_PAYMENT_METHOD = "present_payment_method",
+    REFUND_PAYMENT = "refund_payment",
+    SET_READER_DISPLAY = "set_reader_display"
+}

package/dist/types/terminal/types/enums/terminal-readers.enums.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TerminalReaderActionTypeEnum = exports.TerminalReaderActionStatusEnum = exports.TerminalReaderStatusEnum = exports.SimulatedTerminalReaderDeviceTypeEnum = exports.TerminalReaderDeviceTypeEnum = void 0;
+var TerminalReaderDeviceTypeEnum;
+(function (TerminalReaderDeviceTypeEnum) {
+    TerminalReaderDeviceTypeEnum["BBPOS_WISEPAD3"] = "bbpos_wisepad3";
+    TerminalReaderDeviceTypeEnum["STRIPE_M2"] = "stripe_m2";
+    TerminalReaderDeviceTypeEnum["STRIPE_S700"] = "stripe_s700";
+    TerminalReaderDeviceTypeEnum["BBPOS_CHIPPER2X"] = "bbpos_chipper2x";
+    TerminalReaderDeviceTypeEnum["BBPOS_WISEPOS_E"] = "bbpos_wisepos_e";
+    TerminalReaderDeviceTypeEnum["VERIFONE_P400"] = "verifone_P400";
+    TerminalReaderDeviceTypeEnum["SIMULATED_WISEPOS_E"] = "simulated_wisepos_e";
+    TerminalReaderDeviceTypeEnum["SIMULATED_STRIPE_S700"] = "simulated_stripe_s700";
+    TerminalReaderDeviceTypeEnum["MOBILE_PHONE_READER"] = "mobile_phone_reader";
+    TerminalReaderDeviceTypeEnum["STRIPE_S710"] = "stripe_s710";
+    TerminalReaderDeviceTypeEnum["VERIFONE_V660P"] = "verifone_v660p";
+    TerminalReaderDeviceTypeEnum["VERIFONE_UX700"] = "verifone_ux700";
+    TerminalReaderDeviceTypeEnum["VERIFONE_P630"] = "verifone_p630";
+    TerminalReaderDeviceTypeEnum["VERIFONE_M425"] = "verifone_m425";
+    TerminalReaderDeviceTypeEnum["SIMULATED_STRIPE_S710"] = "simulated_stripe_s710";
+    TerminalReaderDeviceTypeEnum["SIMULATED_VERIFONE_V660P"] = "simulated_verifone_v660p";
+    TerminalReaderDeviceTypeEnum["SIMULATED_VERIFONE_UX700"] = "simulated_verifone_ux700";
+    TerminalReaderDeviceTypeEnum["SIMULATED_VERIFONE_P630"] = "simulated_verifone_p630";
+    TerminalReaderDeviceTypeEnum["SIMULATED_VERIFONE_M425"] = "simulated_verifone_m425";
+})(TerminalReaderDeviceTypeEnum = exports.TerminalReaderDeviceTypeEnum || (exports.TerminalReaderDeviceTypeEnum = {}));
+var SimulatedTerminalReaderDeviceTypeEnum;
+(function (SimulatedTerminalReaderDeviceTypeEnum) {
+    SimulatedTerminalReaderDeviceTypeEnum["SIMULATED_WISEPOS_E"] = "simulated_wisepos_e";
+    SimulatedTerminalReaderDeviceTypeEnum["SIMULATED_STRIPE_S700"] = "simulated_stripe_s700";
+    SimulatedTerminalReaderDeviceTypeEnum["SIMULATED_STRIPE_S710"] = "simulated_stripe_s710";
+    SimulatedTerminalReaderDeviceTypeEnum["SIMULATED_VERIFONE_V660P"] = "simulated_verifone_v660p";
+    SimulatedTerminalReaderDeviceTypeEnum["SIMULATED_VERIFONE_UX700"] = "simulated_verifone_ux700";
+    SimulatedTerminalReaderDeviceTypeEnum["SIMULATED_VERIFONE_P630"] = "simulated_verifone_p630";
+    SimulatedTerminalReaderDeviceTypeEnum["SIMULATED_VERIFONE_M425"] = "simulated_verifone_m425";
+})(SimulatedTerminalReaderDeviceTypeEnum = exports.SimulatedTerminalReaderDeviceTypeEnum || (exports.SimulatedTerminalReaderDeviceTypeEnum = {}));
+var TerminalReaderStatusEnum;
+(function (TerminalReaderStatusEnum) {
+    TerminalReaderStatusEnum["OFFLINE"] = "offline";
+    TerminalReaderStatusEnum["ONLINE"] = "online";
+})(TerminalReaderStatusEnum = exports.TerminalReaderStatusEnum || (exports.TerminalReaderStatusEnum = {}));
+var TerminalReaderActionStatusEnum;
+(function (TerminalReaderActionStatusEnum) {
+    TerminalReaderActionStatusEnum["FAILED"] = "failed";
+    TerminalReaderActionStatusEnum["IN_PROGRESS"] = "in_progress";
+    TerminalReaderActionStatusEnum["SUCCEEDED"] = "succeeded";
+})(TerminalReaderActionStatusEnum = exports.TerminalReaderActionStatusEnum || (exports.TerminalReaderActionStatusEnum = {}));
+var TerminalReaderActionTypeEnum;
+(function (TerminalReaderActionTypeEnum) {
+    TerminalReaderActionTypeEnum["COLLECT_INPUTS"] = "collect_inputs";
+    TerminalReaderActionTypeEnum["PROCESS_PAYMENT_INTENT"] = "process_payment_intent";
+    TerminalReaderActionTypeEnum["PROCESS_SETUP_INTENT"] = "process_setup_intent";
+    TerminalReaderActionTypeEnum["PRESENT_PAYMENT_METHOD"] = "present_payment_method";
+    TerminalReaderActionTypeEnum["REFUND_PAYMENT"] = "refund_payment";
+    TerminalReaderActionTypeEnum["SET_READER_DISPLAY"] = "set_reader_display";
+})(TerminalReaderActionTypeEnum = exports.TerminalReaderActionTypeEnum || (exports.TerminalReaderActionTypeEnum = {}));
+//# sourceMappingURL=terminal-readers.enums.js.map

package/dist/types/terminal/types/enums/terminal-readers.enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-readers.enums.js","sourceRoot":"","sources":["../../../../../src/types/terminal/types/enums/terminal-readers.enums.ts"],"names":[],"mappings":";;;AAAA,IAAY,4BAoBX;AApBD,WAAY,4BAA4B;IACvC,iEAAiC,CAAA;IACjC,uDAAuB,CAAA;IACvB,2DAA2B,CAAA;IAC3B,mEAAmC,CAAA;IACnC,mEAAmC,CAAA;IACnC,+DAA+B,CAAA;IAC/B,2EAA2C,CAAA;IAC3C,+EAA+C,CAAA;IAC/C,2EAA2C,CAAA;IAC3C,2DAA2B,CAAA;IAC3B,iEAAiC,CAAA;IACjC,iEAAiC,CAAA;IACjC,+DAA+B,CAAA;IAC/B,+DAA+B,CAAA;IAC/B,+EAA+C,CAAA;IAC/C,qFAAqD,CAAA;IACrD,qFAAqD,CAAA;IACrD,mFAAmD,CAAA;IACnD,mFAAmD,CAAA;AACpD,CAAC,EApBW,4BAA4B,GAA5B,oCAA4B,KAA5B,oCAA4B,QAoBvC;AAED,IAAY,qCAQX;AARD,WAAY,qCAAqC;IAChD,oFAA2C,CAAA;IAC3C,wFAA+C,CAAA;IAC/C,wFAA+C,CAAA;IAC/C,8FAAqD,CAAA;IACrD,8FAAqD,CAAA;IACrD,4FAAmD,CAAA;IACnD,4FAAmD,CAAA;AACpD,CAAC,EARW,qCAAqC,GAArC,6CAAqC,KAArC,6CAAqC,QAQhD;AAED,IAAY,wBAGX;AAHD,WAAY,wBAAwB;IACnC,+CAAmB,CAAA;IACnB,6CAAiB,CAAA;AAClB,CAAC,EAHW,wBAAwB,GAAxB,gCAAwB,KAAxB,gCAAwB,QAGnC;AAED,IAAY,8BAIX;AAJD,WAAY,8BAA8B;IACzC,mDAAiB,CAAA;IACjB,6DAA2B,CAAA;IAC3B,yDAAuB,CAAA;AACxB,CAAC,EAJW,8BAA8B,GAA9B,sCAA8B,KAA9B,sCAA8B,QAIzC;AAED,IAAY,4BAOX;AAPD,WAAY,4BAA4B;IACvC,iEAAiC,CAAA;IACjC,iFAAiD,CAAA;IACjD,6EAA6C,CAAA;IAC7C,iFAAiD,CAAA;IACjD,iEAAiC,CAAA;IACjC,yEAAyC,CAAA;AAC1C,CAAC,EAPW,4BAA4B,GAA5B,oCAA4B,KAA5B,oCAA4B,QAOvC"}

package/dist/types/terminal/types/enums/terminal-webhook.enums.d.ts

@@ -0,0 +1,15 @@
+export declare enum TerminalWebhookEventTypeEnum {
+    ACTION_SUCCEEDED = "action_succeeded",
+    ACTION_FAILED = "action_failed",
+    ACTION_UPDATED = "action_updated"
+}
+export declare enum TerminalWebhookActionTypeEnum {
+    PROCESS_PAYMENT_INTENT = "process_payment_intent",
+    PROCESS_SETUP_INTENT = "process_setup_intent",
+    REFUND_PAYMENT = "refund_payment",
+    COLLECT_INPUTS = "collect_inputs",
+    SET_READER_DISPLAY = "set_reader_display"
+}
+export declare enum TerminalReaderSseEventTypeEnum {
+    READER_STATE = "reader_state"
+}

package/dist/types/terminal/types/enums/terminal-webhook.enums.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TerminalReaderSseEventTypeEnum = exports.TerminalWebhookActionTypeEnum = exports.TerminalWebhookEventTypeEnum = void 0;
+var TerminalWebhookEventTypeEnum;
+(function (TerminalWebhookEventTypeEnum) {
+    TerminalWebhookEventTypeEnum["ACTION_SUCCEEDED"] = "action_succeeded";
+    TerminalWebhookEventTypeEnum["ACTION_FAILED"] = "action_failed";
+    TerminalWebhookEventTypeEnum["ACTION_UPDATED"] = "action_updated";
+})(TerminalWebhookEventTypeEnum = exports.TerminalWebhookEventTypeEnum || (exports.TerminalWebhookEventTypeEnum = {}));
+var TerminalWebhookActionTypeEnum;
+(function (TerminalWebhookActionTypeEnum) {
+    TerminalWebhookActionTypeEnum["PROCESS_PAYMENT_INTENT"] = "process_payment_intent";
+    TerminalWebhookActionTypeEnum["PROCESS_SETUP_INTENT"] = "process_setup_intent";
+    TerminalWebhookActionTypeEnum["REFUND_PAYMENT"] = "refund_payment";
+    TerminalWebhookActionTypeEnum["COLLECT_INPUTS"] = "collect_inputs";
+    TerminalWebhookActionTypeEnum["SET_READER_DISPLAY"] = "set_reader_display";
+})(TerminalWebhookActionTypeEnum = exports.TerminalWebhookActionTypeEnum || (exports.TerminalWebhookActionTypeEnum = {}));
+var TerminalReaderSseEventTypeEnum;
+(function (TerminalReaderSseEventTypeEnum) {
+    TerminalReaderSseEventTypeEnum["READER_STATE"] = "reader_state";
+})(TerminalReaderSseEventTypeEnum = exports.TerminalReaderSseEventTypeEnum || (exports.TerminalReaderSseEventTypeEnum = {}));
+//# sourceMappingURL=terminal-webhook.enums.js.map

package/dist/types/terminal/types/enums/terminal-webhook.enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-webhook.enums.js","sourceRoot":"","sources":["../../../../../src/types/terminal/types/enums/terminal-webhook.enums.ts"],"names":[],"mappings":";;;AAAA,IAAY,4BAIX;AAJD,WAAY,4BAA4B;IACvC,qEAAqC,CAAA;IACrC,+DAA+B,CAAA;IAC/B,iEAAiC,CAAA;AAClC,CAAC,EAJW,4BAA4B,GAA5B,oCAA4B,KAA5B,oCAA4B,QAIvC;AAED,IAAY,6BAMX;AAND,WAAY,6BAA6B;IACxC,kFAAiD,CAAA;IACjD,8EAA6C,CAAA;IAC7C,kEAAiC,CAAA;IACjC,kEAAiC,CAAA;IACjC,0EAAyC,CAAA;AAC1C,CAAC,EANW,6BAA6B,GAA7B,qCAA6B,KAA7B,qCAA6B,QAMxC;AAED,IAAY,8BAEX;AAFD,WAAY,8BAA8B;IACzC,+DAA6B,CAAA;AAC9B,CAAC,EAFW,8BAA8B,GAA9B,sCAA8B,KAA9B,sCAA8B,QAEzC"}

package/dist/types/terminal/types/index.d.ts

@@ -0,0 +1,4 @@
+export * from './classes';
+export * from './consts';
+export * from './enums';
+export * from './interfaces';

package/dist/types/terminal/types/index.js

@@ -0,0 +1,21 @@
+"use strict";
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./classes"), exports);
+__exportStar(require("./consts"), exports);
+__exportStar(require("./enums"), exports);
+__exportStar(require("./interfaces"), exports);
+//# sourceMappingURL=index.js.map

package/dist/types/terminal/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/types/terminal/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,2CAAyB;AACzB,0CAAwB;AACxB,+CAA6B"}

package/dist/types/terminal/types/interfaces/index.d.ts

@@ -0,0 +1,3 @@
+export * from './terminal-action-service.interfaces';
+export * from './terminal-action.interfaces';
+export * from './terminal-webhook.interfaces';

package/dist/types/terminal/types/interfaces/index.js

@@ -0,0 +1,20 @@
+"use strict";
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./terminal-action-service.interfaces"), exports);
+__exportStar(require("./terminal-action.interfaces"), exports);
+__exportStar(require("./terminal-webhook.interfaces"), exports);
+//# sourceMappingURL=index.js.map

package/dist/types/terminal/types/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/types/terminal/types/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uEAAqD;AACrD,+DAA6C;AAC7C,gEAA8C"}

package/dist/types/terminal/types/interfaces/terminal-action-service.interfaces.d.ts

@@ -0,0 +1,82 @@
+import Stripe from 'stripe';
+import { TerminalActionResponseDto } from '../../dto/terminal-actions.dto';
+import { TerminalReaderActionTypeEnum, TerminalReaderStatusEnum } from '../enums/terminal-readers.enums';
+import { ITerminalActionInitiatedBy, ITerminalActiveAction, ITerminalGhostCancel } from './terminal-action.interfaces';
+export type StripeReaderAction = (Stripe.Terminal.Reader.Action & {
+    id?: string;
+}) | null;
+export interface IBusyState {
+    actionId: string | null;
+    busy: boolean;
+    initiatedBy: ITerminalActionInitiatedBy | null;
+    type: TerminalReaderActionTypeEnum | null;
+}
+export interface IBusyStateSnapshot {
+    liveActionTargetId: string | null;
+    busyState: IBusyState;
+    ghostCancel: ITerminalGhostCancel | null;
+    previous: ITerminalActiveAction | null;
+    readerStatus: TerminalReaderStatusEnum | null;
+}
+export interface ITriggerDecisionDispatch {
+    actionDispatchedLogMeta: {
+        forced: boolean;
+        wasBusy: false;
+    };
+    kind: 'dispatch';
+}
+export interface ITriggerDecisionRejectBusy {
+    busyState: IBusyState;
+    kind: 'reject_busy';
+    staleGhostCancelMarker: boolean;
+}
+export interface ITriggerDecisionRejectOffline {
+    kind: 'reject_offline';
+}
+export interface ITriggerDecisionForceOverride {
+    forceParams: IForceActionTriggerParams;
+    kind: 'force_override';
+}
+export interface ITriggerDecisionReclaimGhostAction {
+    forceParams: IForceActionTriggerParams;
+    kind: 'reclaim_ghost_action';
+}
+export type TTriggerDecision = ITriggerDecisionDispatch | ITriggerDecisionRejectBusy | ITriggerDecisionRejectOffline | ITriggerDecisionForceOverride | ITriggerDecisionReclaimGhostAction;
+export interface IActionRejectionLogMeta {
+    organizationId: number;
+    readerId: string;
+    actionType: TerminalReaderActionTypeEnum;
+    ghostCancelAgeMs: number | null;
+    ghostCancelStripeCode: string | null;
+    hasGhostCancelMarker: boolean;
+    hasRegistryEntry: boolean;
+    latencyMs: number;
+    readerStatus: TerminalReaderStatusEnum | null;
+}
+export interface IActionLogTemplates {
+    actionDispatched: string;
+    dispatchContention: string;
+    dispatchFollowupFailed: string;
+    forceOverrideInFlightAction: string;
+    ghostActionReclaimed: string;
+    overrideContention: string;
+    readerBusyRejected: string;
+    readerOfflineRejected: string;
+}
+export interface IExecuteActionTriggerParams {
+    organizationId: number;
+    readerId: string;
+    actionType: TerminalReaderActionTypeEnum;
+    dispatch: (readerId: string) => Promise<TerminalActionResponseDto>;
+    force?: boolean;
+    logTemplates: IActionLogTemplates;
+}
+export interface IForceActionTriggerParams extends IExecuteActionTriggerParams {
+    startedAt: number;
+}
+export interface IDispatchAndRegisterParams extends IForceActionTriggerParams {
+    actionDispatchedLogMeta?: {
+        forced: boolean;
+        wasBusy?: boolean;
+    };
+}

package/dist/types/terminal/types/interfaces/terminal-action-service.interfaces.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=terminal-action-service.interfaces.js.map

package/dist/types/terminal/types/interfaces/terminal-action-service.interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-action-service.interfaces.js","sourceRoot":"","sources":["../../../../../src/types/terminal/types/interfaces/terminal-action-service.interfaces.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,71 @@
+import { TerminalActionCancelReasonEnum, TerminalReaderEventTypeEnum } from '../enums/terminal-action.enums';
+import { TerminalReaderActionTypeEnum } from '../enums/terminal-readers.enums';
+/**
+ * Entry stored in the Redis action registry (`terminal:reader:<id>:active`) when an
+ * action is successfully dispatched. Cleared by the webhook handler on
+ * `action_succeeded` / `action_failed`, and by this service on synthetic `action_canceled`.
+ */
+export interface ITerminalActiveAction {
+    organizationId: number;
+    actionId: string | null;
+    userId: number | null;
+    displayName: string | null;
+    startedAt: number;
+    type: TerminalReaderActionTypeEnum;
+}
+/**
+ * Identity of a reader action believed to be stuck: either one whose cancel Stripe did not confirm,
+ * leaving it a ghost, or one an owner's retry presumes stuck after it has been in flight too long.
+ * Stripe's `Terminal.Reader.Action` has no id, so the action is keyed by the object it targets.
+ */
+export interface ITerminalPendingCancel {
+    bondActionId: string | null;
+    targetId: string;
+    actionType: TerminalReaderActionTypeEnum | null;
+}
+/**
+ * Short-lived Redis marker recording that a cancel or dispatch failed and may have left a ghost
+ * action running on the reader. Written whenever Stripe returns `terminal_reader_offline` /
+ * `terminal_reader_timeout`, and refreshed with whatever code a failed ghost-reclaim cancel returned.
+ *
+ * `stripeCode` therefore says why the cancel failed, not that the reader is unreachable: only the
+ * offline and timeout codes prove that, which is why the offline reclassification is gated on
+ * `isReaderUnreachableStripeCode` rather than on the marker's mere presence.
+ *
+ * When `pendingCancel` names the action the reader is currently running, the marker is proof about the
+ * reader itself and outranks the active-action registry entry: a cancel Stripe failed on that exact
+ * action means the reader is gone no matter which cashier owns it. A marker naming no action is weaker
+ * — it could describe work the reader has since finished — so it only reclassifies an untracked action.
+ *
+ * The TTL only has to outlive Stripe's heartbeat lag: once the heartbeat itself reports `offline`,
+ * `readerStatus` carries the reclassification and the marker is redundant. Every failed cancel
+ * refreshes it, so a reader that stays unreachable keeps a live marker.
+ */
+export interface ITerminalGhostCancel {
+    at: number;
+    lastCancelAttemptAt: number;
+    pendingCancel: ITerminalPendingCancel | null;
+    stripeCode: string;
+}
+/**
+ * Identity of the user who initiated the in-flight action, surfaced to the frontend so it can
+ * render the Take-over modal. Null when the originator is unknown (e.g. live Stripe-state fallback).
+ */
+export interface ITerminalActionInitiatedBy {
+    userId: number | null;
+    displayName: string | null;
+    startedAt: number;
+}
+/**
+ * Synthetic `action_canceled` message published to the reader's Redis channel after a programmatic
+ * cancel (override or explicit cancel-action), since Stripe fires no webhook for programmatic cancels.
+ */
+export interface ITerminalSyntheticCancelMessage {
+    actionId: string | null;
+    readerId: string;
+    at: number;
+    canceledBy: {
+        reason: TerminalActionCancelReasonEnum;
+    };
+    type: TerminalReaderEventTypeEnum.ACTION_CANCELED;
+}

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

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=terminal-action.interfaces.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-action.interfaces.js","sourceRoot":"","sources":["../../../../../src/types/terminal/types/interfaces/terminal-action.interfaces.ts"],"names":[],"mappings":""}

package/dist/types/terminal/types/interfaces/terminal-webhook.interfaces.d.ts

@@ -0,0 +1,52 @@
+import { TerminalReaderActionStatusEnum } from '../enums/terminal-readers.enums';
+import { TerminalReaderSseEventTypeEnum, TerminalWebhookActionTypeEnum, TerminalWebhookEventTypeEnum } from '../enums/terminal-webhook.enums';
+import { ITerminalSyntheticCancelMessage } from './terminal-action.interfaces';
+export interface ITerminalWebhookFailure {
+    failureCode: string | null;
+    failureMessage: string | null;
+}
+export interface ITerminalWebhookCollectInputs {
+    inputs: unknown;
+}
+export interface ITerminalWebhookNormalizedAction {
+    id: string | null;
+    paymentIntentId?: string | null;
+    refundId?: string | null;
+    setupIntentId?: string | null;
+    collectInputs?: ITerminalWebhookCollectInputs | null;
+    failure?: ITerminalWebhookFailure | null;
+    status: TerminalReaderActionStatusEnum;
+    type: TerminalWebhookActionTypeEnum | null;
+}
+export interface ITerminalWebhookInitiatedBy {
+    userId: number | null;
+    displayName: string | null;
+    startedAt: string;
+}
+export interface ITerminalWebhookActiveActionContext {
+    organizationId: number | null;
+    initiatedBy: ITerminalWebhookInitiatedBy | null;
+}
+export interface ITerminalWebhookChannelMessage {
+    id: string;
+    organizationId: number | null;
+    readerId: string;
+    action: ITerminalWebhookNormalizedAction;
+    initiatedBy: ITerminalWebhookInitiatedBy | null;
+    occurredAt: string;
+    publishedAtMs: number;
+    type: TerminalWebhookEventTypeEnum;
+}
+export type TTerminalReaderStateAction = Required<ITerminalWebhookNormalizedAction>;
+export interface ITerminalReaderStateChannelMessage {
+    organizationId: number;
+    readerId: string;
+    action: TTerminalReaderStateAction | null;
+    occurredAt: string;
+    publishedAtMs: number;
+    type: TerminalReaderSseEventTypeEnum.READER_STATE;
+}
+export interface IScopedTerminalSyntheticCancelMessage extends ITerminalSyntheticCancelMessage {
+    organizationId?: number | null;
+}
+export type TTerminalReaderChannelMessage = ITerminalWebhookChannelMessage | IScopedTerminalSyntheticCancelMessage | ITerminalReaderStateChannelMessage;

package/dist/types/terminal/types/interfaces/terminal-webhook.interfaces.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=terminal-webhook.interfaces.js.map

package/dist/types/terminal/types/interfaces/terminal-webhook.interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-webhook.interfaces.js","sourceRoot":"","sources":["../../../../../src/types/terminal/types/interfaces/terminal-webhook.interfaces.ts"],"names":[],"mappings":""}

package/dist/types/waitlist/dto/waitlist.dto.d.ts

@@ -66,6 +66,7 @@ export declare class WaitlistEntryRowDto extends OrganizationBaseEntityDto {
 }
 export declare class WaitlistEntrySummaryDto extends WaitlistEntryRowDto {
     addons?: SimpleCartItemDto[];
+    errors?: string[];
 }
 export declare class ResourcesOptionsDto extends SelectOptionsDto {
     startDate?: Date;

package/dist/types/waitlist/dto/waitlist.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"waitlist.dto.js","sourceRoot":"","sources":["../../../../src/types/waitlist/dto/waitlist.dto.ts"],"names":[],"mappings":";;;AAGA,uDAAqG;AACrG,8EAAyG;AAGzG,4DAKiC;AAGjC,MAAa,sBAAsB;CAMlC;AAND,wDAMC;AAED,MAAa,gBAAiB,SAAQ,4CAAyB;CAY9D;AAZD,4CAYC;AAED,MAAa,gBAAiB,SAAQ,4CAAyB;CAQ9D;AARD,4CAQC;AAED,MAAa,oBAAqB,SAAQ,sCAAmB;CAI5D;AAJD,oDAIC;AAED,MAAa,wBAAyB,SAAQ,oBAAoB;CAEjE;AAFD,4DAEC;AAED,MAAa,0BACZ,SAAQ,mCAA2C;CAQnD;AATD,gEASC;AALC,yCAAwB,CAAC,WAAW,EAEpC,yCAAwB,CAAC,SAAS;AAKpC,MAAa,4BAA6B,SAAQ,iCAAmB;CAIpE;AAJD,oEAIC;AAHC,yCAAwB,CAAC,WAAW,EAEpC,yCAAwB,CAAC,SAAS;AAGpC,MAAa,gBAAgB;CAU5B;AAVD,4CAUC;AAED,MAAa,mBAAoB,SAAQ,4CAAyB;CAYjE;AAZD,kDAYC;AAED,MAAa,mBAAoB,SAAQ,4CAAyB;CAYjE;AAZD,kDAYC;AAED,MAAa,uBAAwB,SAAQ,mBAAmB;CAE/D;AAFD,0DAEC;AAED,MAAa,mBAAoB,SAAQ,8BAAgB;CAIxD;AAJD,kDAIC;AAED,MAAa,yBAAyB;CAIrC;AAJD,8DAIC;AAHC,0CAAyB,CAAC,YAAY,EAEtC,0CAAyB,CAAC,aAAa"}
+{"version":3,"file":"waitlist.dto.js","sourceRoot":"","sources":["../../../../src/types/waitlist/dto/waitlist.dto.ts"],"names":[],"mappings":";;;AAGA,uDAAqG;AACrG,8EAAyG;AAGzG,4DAKiC;AAGjC,MAAa,sBAAsB;CAMlC;AAND,wDAMC;AAED,MAAa,gBAAiB,SAAQ,4CAAyB;CAY9D;AAZD,4CAYC;AAED,MAAa,gBAAiB,SAAQ,4CAAyB;CAQ9D;AARD,4CAQC;AAED,MAAa,oBAAqB,SAAQ,sCAAmB;CAI5D;AAJD,oDAIC;AAED,MAAa,wBAAyB,SAAQ,oBAAoB;CAEjE;AAFD,4DAEC;AAED,MAAa,0BACZ,SAAQ,mCAA2C;CAQnD;AATD,gEASC;AALC,yCAAwB,CAAC,WAAW,EAEpC,yCAAwB,CAAC,SAAS;AAKpC,MAAa,4BAA6B,SAAQ,iCAAmB;CAIpE;AAJD,oEAIC;AAHC,yCAAwB,CAAC,WAAW,EAEpC,yCAAwB,CAAC,SAAS;AAGpC,MAAa,gBAAgB;CAU5B;AAVD,4CAUC;AAED,MAAa,mBAAoB,SAAQ,4CAAyB;CAYjE;AAZD,kDAYC;AAED,MAAa,mBAAoB,SAAQ,4CAAyB;CAYjE;AAZD,kDAYC;AAED,MAAa,uBAAwB,SAAQ,mBAAmB;CAI/D;AAJD,0DAIC;AAED,MAAa,mBAAoB,SAAQ,8BAAgB;CAIxD;AAJD,kDAIC;AAED,MAAa,yBAAyB;CAIrC;AAJD,8DAIC;AAHC,0CAAyB,CAAC,YAAY,EAEtC,0CAAyB,CAAC,aAAa"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@bondsports/types",
-	"version": "2.4.84",
+	"version": "2.4.85",
 	"description": "backend types module for Bond-Sports",
 	"main": "./dist/index.js",
 	"scripts": {
@@ -37,7 +37,7 @@
 		"@bondsports/notifications-sdk": "^0.0.8",
 		"moment": "^2.29.1",
 		"rimraf": "^3.0.2",
-		"stripe": "9.1.0",
+		"stripe": "^18.2.0",
 		"typeorm": "^0.2.32",
 		"zod": "^3.25.49",
 		"@types/lodash": "^4.17.24"