heartraite 1.0.222 → 1.0.224

package/dist/types/request.types.d.ts

@@ -64,9 +64,10 @@ export type SetEventInterestRequest = {
 };
 export type CreateCheckoutRequest = {
     eventId: string;
+    termsVersion: string;
 };
 export type ConfirmOrderRequest = {
-    sessionId: string;
+    eventId: string;
 };
 export type AbandonOrderRequest = {
     eventId: string;

package/dist/types/response.types.d.ts

@@ -52,8 +52,9 @@ export type GetPublicEventsResponse = EventOffer[];
 export type SetEventInterestResponse = EventInterestView | null;
 export type CreateCheckoutResponse = {
     orderId: string;
-    checkoutUrl: string;
     expiresAt: string;
+    clientSecret: string;
+    publishableKey: string;
 };
 export type ConfirmOrderResponse = EventOrderView;
 export type AbandonOrderResponse = void;

package/dist/types/ticket.types.d.ts

@@ -17,6 +17,10 @@ export type EventOrderBuyerSnapshot = {
     firstName: string;
     email: string;
 };
+export type EventOrderTerms = {
+    version: string;
+    acceptedAt: string;
+};
 export type EventOrder = {
     id: string;
     eventId: string;
@@ -27,8 +31,6 @@ export type EventOrder = {
     amountOre: number;
     currency: EventCurrency;
     priceSnapshotOre: number;
-    stripeProductId?: string;
-    stripeCheckoutSessionId?: string;
     stripePaymentIntentId?: string;
     createdAt: string;
     expiresAt?: string;
@@ -37,9 +39,41 @@ export type EventOrder = {
     refund?: EventOrderRefund;
     messages?: Record<string, Partial<Record<EventOrderMessageChannel, string>>>;
     buyerSnapshot: EventOrderBuyerSnapshot;
+    terms?: EventOrderTerms;
     deletedUser?: boolean;
 };
 export type EventOrderRefundView = Pick<EventOrderRefund, "amountOre" | "status" | "requestedAt">;
 export type EventOrderView = Pick<EventOrder, "id" | "eventId" | "kind" | "status" | "amountOre" | "currency" | "createdAt" | "expiresAt" | "paidAt" | "cancelledAt"> & {
     refund?: EventOrderRefundView;
 };
+export type TicketErrorReason = "sold_out" | "checkout_expired" | "already_ticketed" | "sales_closed" | "sales_not_open" | "refund_on_record" | "event_cancelled" | "payment_incomplete" | "payment_mismatch" | "quota_exceeded";
+export type AdminRefundReason = Extract<EventOrderRefundReason, "user_cancel" | "admin">;
+export type EventOrderAdminRow = {
+    orderId: string;
+    userId: string;
+    firstName: string;
+    email: string;
+    gender: Gender;
+    kind: EventOrderKind;
+    status: EventOrderStatus;
+    amountOre: number;
+    createdAt: string;
+    paidAt?: string;
+    refund?: EventOrderRefundView;
+    stripePaymentIntentId?: string;
+    checkedInAt?: string;
+};
+export type EventCancellationSummary = {
+    refunded: number;
+    released: number;
+    failed: number;
+    skipped: number;
+};
+export type TicketCheckIn = {
+    eventId: string;
+    userId: string;
+    checkedInAt?: string;
+};
+export type TicketingConfig = {
+    enabled: boolean;
+};

package/dist/types/ticket.types.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/ticket.types.test.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const assertType = (_value) => undefined;
+describe("paymentsheet ticket types", () => {
+    it("CreateCheckoutRequest carries eventId and termsVersion", () => {
+        assertType();
+        const request = {
+            eventId: "e1",
+            termsVersion: "2026-11-01",
+        };
+        expect(Object.keys(request).sort()).toEqual(["eventId", "termsVersion"]);
+    });
+    it("CreateCheckoutResponse exposes the sheet secrets and no checkoutUrl", () => {
+        assertType();
+        const freeClaim = {
+            orderId: "e1_u1",
+            expiresAt: "2026-11-01T10:00:00.000Z",
+            clientSecret: "",
+            publishableKey: "",
+        };
+        expect(freeClaim.clientSecret).toBe("");
+    });
+    it("ConfirmOrderRequest is keyed by eventId", () => {
+        assertType();
+        expect({ eventId: "e1" }).toEqual({
+            eventId: "e1",
+        });
+    });
+    it("EventOrder records optional terms and drops the Checkout Session fields", () => {
+        assertType();
+        assertType();
+        assertType();
+        assertType();
+        assertType();
+        expect(true).toBe(true);
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "heartraite",
-  "version": "1.0.222",
+  "version": "1.0.224",
   "description": "Heartraite npm package for common functionality",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/types/request.types.ts

@@ -90,9 +90,10 @@ export type SetEventInterestRequest = {
 };
 export type CreateCheckoutRequest = {
   eventId: string;
+  termsVersion: string;
 };
 export type ConfirmOrderRequest = {
-  sessionId: string;
+  eventId: string;
 };
 export type AbandonOrderRequest = {
   eventId: string;

package/src/types/response.types.ts

@@ -71,8 +71,9 @@ export type GetPublicEventsResponse = EventOffer[];
 export type SetEventInterestResponse = EventInterestView | null;
 export type CreateCheckoutResponse = {
   orderId: string;
-  checkoutUrl: string;
   expiresAt: string;
+  clientSecret: string;
+  publishableKey: string;
 };
 export type ConfirmOrderResponse = EventOrderView;
 export type AbandonOrderResponse = void;

package/src/types/ticket.types.test.ts

@@ -0,0 +1,66 @@
+import {
+  ConfirmOrderRequest,
+  CreateCheckoutRequest,
+} from "./request.types";
+import { CreateCheckoutResponse } from "./response.types";
+import { EventOrder, EventOrderTerms } from "./ticket.types";
+
+type Equal<A, B> =
+  (<T>() => T extends A ? 1 : 2) extends <T>() => T extends B ? 1 : 2
+    ? true
+    : false;
+const assertType = <T extends true>(_value?: T) => undefined;
+
+describe("paymentsheet ticket types", () => {
+  it("CreateCheckoutRequest carries eventId and termsVersion", () => {
+    assertType<
+      Equal<CreateCheckoutRequest, { eventId: string; termsVersion: string }>
+    >();
+    const request: CreateCheckoutRequest = {
+      eventId: "e1",
+      termsVersion: "2026-11-01",
+    };
+    expect(Object.keys(request).sort()).toEqual(["eventId", "termsVersion"]);
+  });
+
+  it("CreateCheckoutResponse exposes the sheet secrets and no checkoutUrl", () => {
+    assertType<
+      Equal<
+        CreateCheckoutResponse,
+        {
+          orderId: string;
+          expiresAt: string;
+          clientSecret: string;
+          publishableKey: string;
+        }
+      >
+    >();
+    const freeClaim: CreateCheckoutResponse = {
+      orderId: "e1_u1",
+      expiresAt: "2026-11-01T10:00:00.000Z",
+      clientSecret: "",
+      publishableKey: "",
+    };
+    expect(freeClaim.clientSecret).toBe("");
+  });
+
+  it("ConfirmOrderRequest is keyed by eventId", () => {
+    assertType<Equal<ConfirmOrderRequest, { eventId: string }>>();
+    expect({ eventId: "e1" } satisfies ConfirmOrderRequest).toEqual({
+      eventId: "e1",
+    });
+  });
+
+  it("EventOrder records optional terms and drops the Checkout Session fields", () => {
+    assertType<
+      Equal<EventOrder["terms"], EventOrderTerms | undefined>
+    >();
+    assertType<
+      Equal<EventOrderTerms, { version: string; acceptedAt: string }>
+    >();
+    assertType<Equal<"stripeCheckoutSessionId" extends keyof EventOrder ? 1 : 0, 0>>();
+    assertType<Equal<"stripeProductId" extends keyof EventOrder ? 1 : 0, 0>>();
+    assertType<Equal<"stripePaymentIntentId" extends keyof EventOrder ? 1 : 0, 1>>();
+    expect(true).toBe(true);
+  });
+});

package/src/types/ticket.types.ts

@@ -38,6 +38,11 @@ export type EventOrderBuyerSnapshot = {
   email: string;
 };
 
+export type EventOrderTerms = {
+  version: string;
+  acceptedAt: string;
+};
+
 export type EventOrder = {
   id: string;
   eventId: string;
@@ -48,8 +53,6 @@ export type EventOrder = {
   amountOre: number;
   currency: EventCurrency;
   priceSnapshotOre: number;
-  stripeProductId?: string;
-  stripeCheckoutSessionId?: string;
   stripePaymentIntentId?: string;
   createdAt: string;
   expiresAt?: string;
@@ -58,6 +61,7 @@ export type EventOrder = {
   refund?: EventOrderRefund;
   messages?: Record<string, Partial<Record<EventOrderMessageChannel, string>>>;
   buyerSnapshot: EventOrderBuyerSnapshot;
+  terms?: EventOrderTerms;
   deletedUser?: boolean;
 };
 
@@ -81,3 +85,53 @@ export type EventOrderView = Pick<
 > & {
   refund?: EventOrderRefundView;
 };
+
+export type TicketErrorReason =
+  | "sold_out"
+  | "checkout_expired"
+  | "already_ticketed"
+  | "sales_closed"
+  | "sales_not_open"
+  | "refund_on_record"
+  | "event_cancelled"
+  | "payment_incomplete"
+  | "payment_mismatch"
+  | "quota_exceeded";
+
+export type AdminRefundReason = Extract<
+  EventOrderRefundReason,
+  "user_cancel" | "admin"
+>;
+
+export type EventOrderAdminRow = {
+  orderId: string;
+  userId: string;
+  firstName: string;
+  email: string;
+  gender: Gender;
+  kind: EventOrderKind;
+  status: EventOrderStatus;
+  amountOre: number;
+  createdAt: string;
+  paidAt?: string;
+  refund?: EventOrderRefundView;
+  stripePaymentIntentId?: string;
+  checkedInAt?: string;
+};
+
+export type EventCancellationSummary = {
+  refunded: number;
+  released: number;
+  failed: number;
+  skipped: number;
+};
+
+export type TicketCheckIn = {
+  eventId: string;
+  userId: string;
+  checkedInAt?: string;
+};
+
+export type TicketingConfig = {
+  enabled: boolean;
+};