wedance-shared 1.0.210 → 1.0.212

package/dist/types/index.d.ts

@@ -15,4 +15,5 @@ export * from "./poll.js";
 export * from "./privateClass.js";
 export * from "./revenue.js";
 export * from "./school.js";
+export * from "./transaction.js";
 export * from "./festivals/index.js";

package/dist/types/index.js

@@ -16,6 +16,7 @@ export * from "./poll.js";
 export * from "./privateClass.js";
 export * from "./revenue.js";
 export * from "./school.js";
+export * from "./transaction.js";
 // Re-export from subdirectories
 export * from "./festivals/index.js";
 //# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAE5B,gCAAgC;AAChC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AAEjC,gCAAgC;AAChC,cAAc,sBAAsB,CAAC"}

package/dist/types/pass.d.ts

@@ -1,5 +1,5 @@
 import { EventSummary } from "./event.js";
-import { MonetaryAmount, ProductType, TicketStatus, TicketTypeSummary } from "./ticket.js";
+import { MonetaryAmount, PassAccessScope, ProductType, TicketStatus, TicketTypeSummary } from "./ticket.js";
 type PaymentMethod = "stripe" | "cash" | "card_in_person" | "bank_transfer" | "comp";
 export interface Pass {
     id: string;
@@ -37,6 +37,7 @@ export interface Pass {
     partnerFullName: string | null;
     createdAt: string;
     updatedAt: string;
+    accessScope: PassAccessScope;
     /**
      * For users without an account, the guest email and full name are stored here.
      */

package/dist/types/ticket.d.ts

@@ -127,6 +127,7 @@ export type TicketTypeBase = {
      * For the school classes, the id of the class
      */
     classId?: string | null;
+    accessScope: PassAccessScope;
 };
 /**
  * A ticket sold for one specific event. The only variant currently written in
@@ -139,6 +140,7 @@ export type EventTicketType = TicketTypeBase & {
     validityDays?: never;
     validFrom?: never;
     validUntil?: never;
+    accessScope: "event";
     /**
      * @deprecated Replaced by name
      */
@@ -215,6 +217,7 @@ export type TicketType = EventTicketType | DropInTicketType | PassTicketType | M
  */
 export type EventTicket = EventTicketType;
 export type ProductType = "event" | "drop_in" | "pass" | "membership" | "course";
+export type PassAccessScope = "event" | "event_series" | "specific_class" | "school_classes";
 /**
  * Lightweight ticket-type projection for joins (e.g. on a Pass) where the full
  * {@link TicketType} is not needed.

package/dist/types/transaction.d.ts

@@ -0,0 +1,54 @@
+import type { Pass } from "./pass.js";
+/**
+ * A row in the money ledger. One per movement of money, never updated in place
+ * except to settle `status`. Every amount is in MINOR units (cents), in the
+ * transaction's own `currency`.
+ */
+export type TransactionType = "payment" | "refund";
+export type TransactionStatus = "pending" | "succeeded" | "failed";
+/** Where the record came from: Stripe's API, or a staff member keying it in. */
+export type TransactionSource = "stripe" | "manual";
+/**
+ * The pass payment methods plus `mobilepay`, which Stripe offers at checkout but
+ * `passes.payment_method` has never been able to represent.
+ */
+export type TransactionPaymentMethod = Pass["paymentMethod"] | "mobilepay";
+export interface Transaction {
+    id: string;
+    organizerId: string;
+    /** Firebase uid of the payer, when they have an account. */
+    userId: string | null;
+    studentId: string | null;
+    passId: string | null;
+    /**
+     * The payment a refund reverses. Always set on a refund, always null on a
+     * payment.
+     */
+    parentTransactionId: string | null;
+    recordedByStaffId: string | null;
+    /** Firebase uid of whoever recorded it, for admins who are not school staff. */
+    recordedByUserId: string | null;
+    type: TransactionType;
+    status: TransactionStatus;
+    /** MINOR units, always positive. Direction comes from `type`. */
+    amount: number;
+    /**
+     * On a payment, the WeDance fee charged. On a refund, the fee returned to the
+     * payer — 0 in both refund modes, because WeDance always keeps its fee.
+     */
+    applicationFeeAmount: number;
+    /** `amount - applicationFeeAmount`. Derived in the database. */
+    netAmount: number;
+    currency: string;
+    source: TransactionSource;
+    paymentMethod: TransactionPaymentMethod;
+    paymentIntentId: string | null;
+    refundId: string | null;
+    checkoutSessionId: string | null;
+    /** Written by the test-mode Stripe webhook. Excluded from revenue. */
+    test: boolean;
+    description: string | null;
+    metadata: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}

package/dist/types/transaction.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transaction.js.map

package/dist/types/transaction.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wedance-shared",
-  "version": "1.0.210",
+  "version": "1.0.212",
   "description": "This repository contains shared TypeScript types and interfaces used across multiple WeDance applications:",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",