@cohostvip/cohost-node 0.0.8 → 0.0.10

package/dist/index.d.mts

@@ -1,48 +1,3 @@
-/**
- * Supported HTTP methods.
- */
-type RequestMethod = "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
-/**
- * A function that performs a request to the Cohost API.
- * The generic <T> allows you to specify the expected response type.
- */
-type RequestFn = <T = any>(path: string, options?: {
-    method?: RequestMethod;
-    data?: any;
-    query?: Record<string, string | number | boolean | undefined>;
-    headers?: Record<string, string>;
-}) => Promise<T>;
-
-/**
- * Optional settings for customizing the behavior of the CohostClient.
- */
-interface CohostClientSettings {
-    /** Enable verbose debug output for all API requests. */
-    debug?: boolean;
-    /** Override the default API base URL (defaults to apiBaseUrl). */
-    apiUrl?: string;
-}
-
-/**
- * Base class for all API endpoint groups within the Cohost SDK.
- * Provides shared access to the configured request function and settings.
- */
-declare class CohostEndpoint {
-    /** Shared request function injected from the client */
-    protected request: RequestFn;
-    /** Client settings passed during instantiation */
-    protected settings: CohostClientSettings;
-    /**
-     * Constructs a new endpoint group.
-     *
-     * @param request - The shared request function for performing API calls
-     * @param settings - The client-wide settings passed from the parent client
-     */
-    constructor(request: RequestFn, settings: CohostClientSettings);
-}
-
-// Generated by dts-bundle-generator v9.5.1
-
 /**
  * A namespaced identifier representing the entity an order is associated with.
  *
@@ -63,55 +18,76 @@ type ApiVersion = "2025-04-15";
  * A rich content object that supports multiple representations of text.
  */
 interface MultipartText {
-	/** HTML version of the content. */
-	html?: string;
-	/** Plain text version of the content. */
-	text?: string;
-	/** Markdown version of the content. */
-	md?: string;
-	/** Optional rich editor blocks (if structured editing is supported). */
-	blocks?: any[] | null;
+    /** HTML version of the content. */
+    html?: string;
+    /** Plain text version of the content. */
+    text?: string;
+    /** Markdown version of the content. */
+    md?: string;
+    /** Optional rich editor blocks (if structured editing is supported). */
+    blocks?: any[] | null;
 }
 /**
  * A photo object with resolution options and optional metadata.
  */
 interface Photo {
-	/** High-resolution (2x) image URL. */
-	"2x"?: string;
-	/** Internal photo ID, if stored in a media system. */
-	id?: string;
-	/**
-	 * Primary image URL.
-	 * This is the default image URL to be used when no other resolution is specified.
-	 *
-	 * @example "https://picsum.photos/500"
-	 *
-	 *
-	 * @x-faker image.imageUrl
-	 */
-	url: string;
-	/** Width of the image in pixels. */
-	width?: number;
-	/** Height of the image in pixels. */
-	height?: number;
-	/** Optional caption for the image. */
-	caption?: string;
+    /** High-resolution (2x) image URL. */
+    "2x"?: string;
+    /** Internal photo ID, if stored in a media system. */
+    id?: string;
+    /**
+     * Primary image URL.
+     * This is the default image URL to be used when no other resolution is specified.
+     *
+     * @example "https://picsum.photos/500"
+     *
+     *
+     * @x-faker image.imageUrl
+     */
+    url: string;
+    /** Width of the image in pixels. */
+    width?: number;
+    /** Height of the image in pixels. */
+    height?: number;
+    /** Optional caption for the image. */
+    caption?: string;
 }
 /**
  * A repeating or structured date schedule for an event or item.
  */
 interface Schedule {
-	/** Days of the week (0 = Sunday, 6 = Saturday). */
-	daysOfWeek?: number[];
-	/** ISO-formatted UTC start datetime. */
-	start: string;
-	/** ISO-formatted UTC end datetime. */
-	end: string;
-	/** Specific dates to exclude in "YYYY-MM-DD" format. */
-	excludeDates?: string[];
-	/** Specific dates to include in "YYYY-MM-DD" format. */
-	includeDates?: string[];
+    /** Days of the week (0 = Sunday, 6 = Saturday). */
+    daysOfWeek?: number[];
+    /** ISO-formatted UTC start datetime. */
+    start: string;
+    /** ISO-formatted UTC end datetime. */
+    end: string;
+    /** Specific dates to exclude in "YYYY-MM-DD" format. */
+    excludeDates?: string[];
+    /** Specific dates to include in "YYYY-MM-DD" format. */
+    includeDates?: string[];
+}
+/**
+ * Pagination parameters for a paginated API request.
+ */
+interface Pagination$1 {
+    /** Number of results per page. */
+    size: number;
+    /** Page number (starting from 1). */
+    page: number;
+    /** Continuation */
+    continuation?: string;
+}
+interface PaginationResponse extends Pagination$1 {
+    /** Total number of results available. */
+    total: number;
 }
+type PaginatedResponse<T> = {
+    /** Array of results. */
+    results: T[];
+    /** Pagination metadata. */
+    pagination: PaginationResponse;
+};
 /**
  * Base metadata for any record stored in the system.
  * Includes an ID and timestamps for creation and optional updates.
@@ -119,21 +95,21 @@ interface Schedule {
  * @export
  */
 interface DataRecord {
-	/**
-	 * Unique identifier for the record.
-	 * @example "rec_123abc"
-	 */
-	id: string;
-	/**
-	 * ISO 8601 timestamp indicating when the record was created.
-	 * @example "2025-04-16T10:15:00Z"
-	 */
-	created: string;
-	/**
-	 * ISO 8601 timestamp indicating when the record was last updated, if applicable.
-	 * @example "2025-04-18T08:00:00Z"
-	 */
-	changed?: string;
+    /**
+     * Unique identifier for the record.
+     * @example "rec_123abc"
+     */
+    id: string;
+    /**
+     * ISO 8601 timestamp indicating when the record was created.
+     * @example "2025-04-16T10:15:00Z"
+     */
+    created: string;
+    /**
+     * ISO 8601 timestamp indicating when the record was last updated, if applicable.
+     * @example "2025-04-18T08:00:00Z"
+     */
+    changed?: string;
 }
 /**
  * Extension of `DataRecord` for resources returned from RESTful APIs.
@@ -142,15 +118,15 @@ interface DataRecord {
  * @export
  */
 interface VersionedDataRecord extends DataRecord {
-	/**
-	 * Schema version identifier for this record.
-	 * Helps manage compatibility across client-server contracts.
-	 * @example "2025-01-10"
-	 */
-	version: ApiVersion;
+    /**
+     * Schema version identifier for this record.
+     * Helps manage compatibility across client-server contracts.
+     * @example "2025-01-10"
+     */
+    version: ApiVersion;
 }
 interface VCDataRecord extends VersionedDataRecord {
-	companyId: string;
+    companyId: string;
 }
 /**
  * Represents either an absolute or a relative time constraint.
@@ -161,19 +137,28 @@ interface VCDataRecord extends VersionedDataRecord {
  * @export
  */
 type TimeOrOffset = {
-	/**
-	 * Absolute time in ISO 8601 format.
-	 * @example "2025-06-30T23:59:59"
-	 */
-	date: string;
-	secondsBefore?: never;
+    /**
+     * Absolute time in ISO 8601 format.
+     * @example "2025-06-30T23:59:59"
+     */
+    date: string;
+    secondsBefore?: never;
 } | {
-	/**
-	 * Relative time before an anchor point (e.g. event start), in seconds.
-	 * @example 3600
-	 */
-	secondsBefore: number;
-	date?: never;
+    /**
+     * Relative time before an anchor point (e.g. event start), in seconds.
+     * @example 3600
+     */
+    secondsBefore: number;
+    date?: never;
+};
+/**
+ * A request structure that includes both query parameters and pagination.
+ *
+ * @ignore
+ */
+type PaginatedRequest<T> = T & {
+    /** Pagination settings. */
+    pagination: Pagination$1;
 };
 /**
  * @description A string representing a currency amount in the format `"USD,1000"` where:
@@ -191,44 +176,44 @@ type TimeOrOffset = {
  */
 type CurrencyAmount = string;
 interface CostBase {
-	/**
-	 * The base value of the cost. This is the value before any operations are applied.
-	 * in OrderItem this is the cost of a single item.
-	 *
-	 * @example "USD,1000"
-	 */
-	cost: CurrencyAmount;
-	/**
-	 * Delivery fee for a single item.
-	 *
-	 * @example "USD,1000"
-	 */
-	delivery: CurrencyAmount;
-	/**
-	 * Fee per item.
-	 * @example "USD,1000"
-	 */
-	fee: CurrencyAmount;
-	/**
-	 * Total discount amount applied to this item.
-	 * @example "USD,1000"
-	 */
-	tax: CurrencyAmount;
+    /**
+     * The base value of the cost. This is the value before any operations are applied.
+     * in OrderItem this is the cost of a single item.
+     *
+     * @example "USD,1000"
+     */
+    cost: CurrencyAmount;
+    /**
+     * Delivery fee for a single item.
+     *
+     * @example "USD,1000"
+     */
+    delivery: CurrencyAmount;
+    /**
+     * Fee per item.
+     * @example "USD,1000"
+     */
+    fee: CurrencyAmount;
+    /**
+     * Total discount amount applied to this item.
+     * @example "USD,1000"
+     */
+    tax: CurrencyAmount;
 }
 interface CostComponentCap {
-	op: "cap";
-	type: "percentage" | "absolute";
-	/**
-	 * The value of the cap. If type is percentage, it is a percentage of the base value.
-	 * If type is absolute, it is an absolute value.
-	 *
-	 * Absolute value is represented in the same denomination as the cost.
-	 * i.e. if the cost is in cents, the absolute value should be in cents.
-	 *
-	 * percentage value is represented as a decimal.
-	 * For example, 10% is represented as 0.1.
-	 */
-	value: number;
+    op: "cap";
+    type: "percentage" | "absolute";
+    /**
+     * The value of the cap. If type is percentage, it is a percentage of the base value.
+     * If type is absolute, it is an absolute value.
+     *
+     * Absolute value is represented in the same denomination as the cost.
+     * i.e. if the cost is in cents, the absolute value should be in cents.
+     *
+     * percentage value is represented as a decimal.
+     * For example, 10% is represented as 0.1.
+     */
+    value: number;
 }
 /**
  * Represents a cost operation to be applied in a pricing formula.
@@ -237,27 +222,27 @@ interface CostComponentCap {
  * { op: '*', value: 0.9 }
  */
 interface CostOp {
-	/**
-	 * The operation to apply to the cost value.
-	 *
-	 * Allowed values:
-	 * - "+" (addition)
-	 * - "-" (subtraction)
-	 * - "*" (multiplication)
-	 * - "/" (division)
-	 * @ignore
-	 * @enum {string}
-	 */
-	op: "+" | "-" | "*" | "/";
-	/**
-	 * The operand value used in the cost operation.
-	 *
-	 * The unit should match the denomination of the cost.
-	 * For example, if cost is expressed in cents, this value should also be in cents.
-	 *
-	 * @example 100
-	 */
-	value: number;
+    /**
+     * The operation to apply to the cost value.
+     *
+     * Allowed values:
+     * - "+" (addition)
+     * - "-" (subtraction)
+     * - "*" (multiplication)
+     * - "/" (division)
+     * @ignore
+     * @enum {string}
+     */
+    op: "+" | "-" | "*" | "/";
+    /**
+     * The operand value used in the cost operation.
+     *
+     * The unit should match the denomination of the cost.
+     * For example, if cost is expressed in cents, this value should also be in cents.
+     *
+     * @example 100
+     */
+    value: number;
 }
 /**
  * A set of comparison operators used for evaluating conditional expressions.
@@ -274,34 +259,34 @@ interface CostOp {
  */
 type EqualOperator = "==" | "!=" | "<" | "<=" | ">" | ">=";
 interface CostComponentRuleCondition {
-	/**
-	 * The field to evaluate the condition against.
-	 * For example, "item.price" or "order.total".
-	 * The field should be a valid path to the field in the cost component base.
-	 */
-	field: string;
-	/**
-	 *
-	 */
-	operator: EqualOperator;
-	/**
-	 * Can be a value such as number, currencyAmount, an ISO date string, etc...
-	 */
-	value: string | number | any;
-	/**
-	 * evaluator, will define a function or endpoint to evaluate the condition.
-	 */
-	eval?: string;
+    /**
+     * The field to evaluate the condition against.
+     * For example, "item.price" or "order.total".
+     * The field should be a valid path to the field in the cost component base.
+     */
+    field: string;
+    /**
+     *
+     */
+    operator: EqualOperator;
+    /**
+     * Can be a value such as number, currencyAmount, an ISO date string, etc...
+     */
+    value: string | number | any;
+    /**
+     * evaluator, will define a function or endpoint to evaluate the condition.
+     */
+    eval?: string;
 }
 interface CostComponentRule {
-	/**
-	 * Friendly name of the rule.
-	 */
-	name: string;
-	/**
-	 * The rule will be applied to the cost component if the conditions are met.
-	 */
-	conditions: CostComponentRuleCondition[];
+    /**
+     * Friendly name of the rule.
+     */
+    name: string;
+    /**
+     * The rule will be applied to the cost component if the conditions are met.
+     */
+    conditions: CostComponentRuleCondition[];
 }
 /**
  * Represents the costs associated with an offering.
@@ -314,43 +299,43 @@ interface CostComponentRule {
  * @property {CurrencyAmount} total - The total cost including tax.
  */
 interface OfferingCosts extends CostBase {
-	/**
-	 * cost + fee - discount , not including tax
-	 *
-	 * In an order item, this is the gross cost of a single item.
-	 *
-	 * @x-faker {"random.arrayElement": ["\"USD,100000\"", "\"USD,25000\""]}
-	 */
-	gross: CurrencyAmount;
-	/**
-	 * total cost including tax
-	 *
-	 * In an order item, this is the total cost * Quantity.
-	 */
-	total: CurrencyAmount;
+    /**
+     * cost + fee - discount , not including tax
+     *
+     * In an order item, this is the gross cost of a single item.
+     *
+     * @x-faker {"random.arrayElement": ["\"USD,100000\"", "\"USD,25000\""]}
+     */
+    gross: CurrencyAmount;
+    /**
+     * total cost including tax
+     *
+     * In an order item, this is the total cost * Quantity.
+     */
+    total: CurrencyAmount;
 }
 type CostBucket = "item" | "fee" | "tax" | "delivery";
 interface CostComponent {
-	id: string;
-	name: string;
-	details?: any;
-	currency: string | "*";
-	base: "order" | "item" | string;
-	bucket: CostBucket;
-	recipient: "organizer" | "platform" | "tax" | string;
-	payer: "attendee" | "organizer";
-	/**
-	 * @ignore
-	 */
-	ops: CostOp[];
-	cap?: CostComponentCap;
-	rules: CostComponentRule[];
-	version: "2025-03-25";
+    id: string;
+    name: string;
+    details?: any;
+    currency: string | "*";
+    base: "order" | "item" | string;
+    bucket: CostBucket;
+    recipient: "organizer" | "platform" | "tax" | string;
+    payer: "attendee" | "organizer";
+    /**
+     * @ignore
+     */
+    ops: CostOp[];
+    cap?: CostComponentCap;
+    rules: CostComponentRule[];
+    version: "2025-03-25";
 }
 interface CalculatedCostComponent extends Omit<CostComponent, "ops" | "cap" | "rules" | "details" | "currency"> {
-	cost: CurrencyAmount;
-	value: number;
-	discount: null;
+    cost: CurrencyAmount;
+    value: number;
+    discount: null;
 }
 /**
  * @zod .string()
@@ -360,126 +345,164 @@ type ActiveOfferingStatus = "live" | "hidden" | "sold-out";
 type OfferingStatus = ActiveOfferingStatus | "draft" | "deleted" | "unavailable";
 type PriceCategory = "donation" | "free" | "paid" | "other";
 interface Offering extends DataRecord {
-	/**
-	 * Offering name, can be ticket name, vaucher name, etc...
-	 * @example "General Admission" (ticket) | "T-shirt" (merch) | "Donation" (donation) | "Membership" (membership) | "Gift Card" (voucher) | "Service Fee" (service) | "Other" (other)
-	 *
-	 * @x-faker commerce.productName
-	 */
-	name: string;
-	type: OfferingType;
-	/**
-	 * @description The maximum number of tickets that can be sold for this offering.
-	 *
-	 * @example 100
-	 *
-	 * @x-faker {"datatype.number": { "min": 10, "max": 100 }}
-	 */
-	capacity: number;
-	quantitySold: number;
-	status: OfferingStatus;
-	priceCategory: PriceCategory;
-	sorting: number;
-	/**
-	 * @ignore
-	 */
-	schedule?: Schedule;
-	description?: string;
-	instructions?: string;
-	/**
-	 * @description Maximum number of tickets that can be purchased in a single order.
-	 *
-	 * @example 10
-	 *
-	 * @x-faker {"datatype.number": { "min": 4, "max": 15 }}
-	 */
-	maximumQuantity: number;
-	/**
-	 * @description Minimum number of tickets that can be purchased in a single order.
-	 *
-	 * @example 1
-	 *
-	 * @x-faker {"datatype.number": { "min": 1, "max": 4 }}
-	 */
-	minimumQuantity: number;
-	package?: boolean;
-	/**
-	 * @description Items, products ,and vouchers included in this offering.
-	 *
-	 *
-	 * @x-faker {"array.length": 0}
-	 */
-	included?: PackageInclude[];
-	/**
-	 * Any constraints that apply to this offering.
-	 * it can be time limit, quantity limit, etc...
-	 */
-	constraints?: any;
-	hidden: boolean;
-	order_confirmation_message?: string | null;
-	costs: OfferingCosts;
-	/**
-	 * Describe fees and other costs associated with purchasing tickets
-	 * to this offering
-	 *
-	 * @ignore
-	 */
-	costComponents?: CostComponent[];
+    /**
+     * Offering name, can be ticket name, vaucher name, etc...
+     * @example "General Admission" (ticket) | "T-shirt" (merch) | "Donation" (donation) | "Membership" (membership) | "Gift Card" (voucher) | "Service Fee" (service) | "Other" (other)
+     *
+     * @x-faker commerce.productName
+     */
+    name: string;
+    type: OfferingType;
+    /**
+     * @description The maximum number of tickets that can be sold for this offering.
+     *
+     * @example 100
+     *
+     * @x-faker {"datatype.number": { "min": 10, "max": 100 }}
+     */
+    capacity: number;
+    quantitySold: number;
+    status: OfferingStatus;
+    priceCategory: PriceCategory;
+    sorting: number;
+    /**
+     * @ignore
+     */
+    schedule?: Schedule;
+    description?: string;
+    instructions?: string;
+    /**
+     * @description Maximum number of tickets that can be purchased in a single order.
+     *
+     * @example 10
+     *
+     * @x-faker {"datatype.number": { "min": 4, "max": 15 }}
+     */
+    maximumQuantity: number;
+    /**
+     * @description Minimum number of tickets that can be purchased in a single order.
+     *
+     * @example 1
+     *
+     * @x-faker {"datatype.number": { "min": 1, "max": 4 }}
+     */
+    minimumQuantity: number;
+    package?: boolean;
+    /**
+     * @description Items, products ,and vouchers included in this offering.
+     *
+     *
+     * @x-faker {"array.length": 0}
+     */
+    included?: PackageInclude[];
+    /**
+     * Any constraints that apply to this offering.
+     * it can be time limit, quantity limit, etc...
+     */
+    constraints?: any;
+    hidden: boolean;
+    order_confirmation_message?: string | null;
+    costs: OfferingCosts;
+    /**
+     * Describe fees and other costs associated with purchasing tickets
+     * to this offering
+     *
+     * @ignore
+     */
+    costComponents?: CostComponent[];
 }
 interface PackageInclude {
-	id: string;
-	quantity: number;
-	type: OfferingType;
-	description: string;
-	ref?: any;
+    id: string;
+    quantity: number;
+    type: OfferingType;
+    description: string;
+    ref?: any;
 }
 interface Ticket extends Omit<Offering, "hidden" | "constraints" | "type"> {
-	category: string;
-	type: "admission" | "package" | "admission.tableCommitment";
-	source: string;
-	display_name?: string;
-	description?: string;
-	ticketParentId?: string;
-	salesEnd: string;
-	salesStart: string;
-	parentId?: string;
-	refId?: string;
+    category: string;
+    type: "admission" | "package" | "admission.tableCommitment";
+    source: string;
+    display_name?: string;
+    description?: string;
+    ticketParentId?: string;
+    salesEnd: string;
+    salesStart: string;
+    parentId?: string;
+    refId?: string;
+}
+/**
+ * Person interface
+ */
+interface Person {
+    name: string;
+    photoURL?: string | null;
+    displayName: string;
+    first: string;
+    last: string;
+    gender: null | string | "male" | "female" | "other";
+    birthdate?: string | null;
+    age?: number;
+}
+interface PersonContact {
+    email: string | null;
+    phone: string | null;
+}
+type Customer = Person & PersonContact & {
+    uid: string | null;
+};
+type AttendeeStatus = "attending" | "checkedIn" | "cancelled" | "refunded" | "noShow" | "unknown" | string;
+interface Attendee3 extends DataRecord {
+    /**
+     * Order ID, from /orders/:orderId
+     */
+    orderId: string;
+    /**
+     * For event it will be the ticket's id
+     */
+    offeringId: string;
+    offeringSnapshot: Partial<Offering>;
+    profile: Customer | null;
+    checkedIn: boolean;
+    barcodes: string[];
+    version: ApiVersion;
+    status: AttendeeStatus | string;
+    index: number;
 }
 interface BuzzBuilder {
-	countLabel: string;
-	profiles: {
-		id: string;
-		name: string;
-		photoURL: string;
-	}[];
+    countLabel: string;
+    profiles: {
+        id: string;
+        name: string;
+        photoURL: string;
+    }[];
 }
 interface EventFeature {
-	id: string;
-	title: string;
-	enabled: boolean;
-	order: number;
-	widgetUri: string;
-	iconName?: string;
-	logoUri?: string;
-	description: string;
-	type: string;
-	version?: string;
-	key: string;
-	meta?: any;
-	data: any;
+    id: string;
+    title: string;
+    enabled: boolean;
+    order: number;
+    widgetUri: string;
+    iconName?: string;
+    logoUri?: string;
+    description: string;
+    type: string;
+    version?: string;
+    key: string;
+    meta?: any;
+    data: any;
 }
 interface Address {
-	address_1: string;
-	address_2?: string;
-	city: string;
-	country: string;
-	premise?: string;
-	formattedAddress?: string;
-	localized_address_display?: string;
-	localized_area_display?: string;
-	localized_multi_line_address_display?: string[];
-	postal_code: string;
-	region: string;
+    address_1: string;
+    address_2?: string;
+    city: string;
+    country: string;
+    premise?: string;
+    formattedAddress?: string;
+    localized_address_display?: string;
+    localized_area_display?: string;
+    localized_multi_line_address_display?: string[];
+    postal_code: string;
+    region: string;
 }
 /**
  * A simple point geometry consisting of latitude and longitude.
@@ -495,8 +518,8 @@ interface Address {
  * }
  */
 interface GeometryPoint {
-	lat: number;
-	lng: number;
+    lat: number;
+    lng: number;
 }
 /**
  * Represents the geometry of a location, including optional viewport and zoom level.
@@ -527,15 +550,15 @@ interface GeometryPoint {
  * }
  */
 interface LocationGeometry extends GeometryPoint {
-	zoom?: number;
-	viewport?: {
-		northeast: GeometryPoint;
-		southwest: GeometryPoint;
-	};
-	vicinity?: string;
-	region?: string;
-	locality?: string;
-	geoHash?: string;
+    zoom?: number;
+    viewport?: {
+        northeast: GeometryPoint;
+        southwest: GeometryPoint;
+    };
+    vicinity?: string;
+    region?: string;
+    locality?: string;
+    geoHash?: string;
 }
 /**
  * A structured representation of a physical location, including address and coordinates.
@@ -573,23 +596,38 @@ interface LocationGeometry extends GeometryPoint {
  * }
  */
 interface Location {
-	venueId: string | null;
-	placeId: string | null;
-	name: string;
-	geometry: LocationGeometry | null;
-	address: Address | null;
-	timezone?: string;
+    venueId: string | null;
+    placeId: string | null;
+    name: string;
+    geometry: LocationGeometry | null;
+    address: Address | null;
+    timezone?: string;
 }
 interface VenueBase {
-	id: string;
-	name: string;
-	formattedAddress: string;
-	placeId?: string | null;
-	tz: string;
-	logo: Photo | null;
-	public: boolean;
-	address: Address | null;
-	slug: string | null;
+    id: string;
+    name: string;
+    formattedAddress: string;
+    placeId?: string | null;
+    tz: string;
+    logo: Photo | null;
+    public: boolean;
+    address: Address | null;
+    slug: string | null;
+}
+interface Venue extends VenueBase {
+    claimed: boolean;
+    refId?: string;
+    description?: MultipartText;
+    capacity?: number | null;
+    types: string[];
+    photos?: Photo[];
+    hoursOfOperation: string[];
+    phoneNumber?: string | null;
+    priceLevel: number | null;
+    rating: {
+        google: number | null;
+    };
+    [key: string]: any;
 }
 /**
  * @description Status of the event lifecycle.
@@ -603,80 +641,80 @@ interface VenueBase {
  * - `canceled`: The event was canceled and is no longer active.
  */
 type EventStatus = "archived" | "draft" | "live" | "started" | "ended" | "completed" | "canceled";
-interface EventBase {
-	id: string;
-	/**
-	 * @example "Spring Concert"
-	 * @faker name.firstName
-	 * @x-faker name.firstName
-	 */
-	name: string;
-	summary: string;
-	companyId: string;
-	/**
-	 * @description The timezone in which the event is taking place.
-	 * @example "America/New_York"
-	 * @example "Europe/London"
-	 * @example "Asia/Tokyo"
-	 */
-	tz: string;
-	/**
-	 * @description The start date and time of the event in ISO 8601 format.
-	 * @example "2023-10-01T12:00:00Z"
-	 */
-	start: string;
-	/**
-	 * @description The end date and time of the event in ISO 8601 format.
-	 * @example "2023-10-01T14:00:00Z"
-	 */
-	end: string;
-	isSeries?: boolean;
-	/**
-	 * @description The status of the event in its lifecycle.
-	 * @example "draft"
-	 * @example "live"
-	 * @example "ended"
-	 */
-	status: EventStatus;
-	/**
-	 * @x-faker { url: faker.image.imageUrl() }
-	 */
-	flyer?: Photo | null;
-	venue?: VenueBase | null;
-	/**
-	 * @description Curerncy used for the event.
-	 * @example "USD"
-	 */
-	currency: string;
-	/**
-	 * @description Is the event public?
-	 * @example true
-	 */
-	public: boolean;
-	location?: Location;
+interface EventBase extends DataRecord {
+    /**
+     * @example "Spring Concert"
+     * @faker name.firstName
+     * @x-faker name.firstName
+     */
+    name: string;
+    summary: string;
+    companyId: string;
+    /**
+     * @description The timezone in which the event is taking place.
+     * @example "America/New_York"
+     * @example "Europe/London"
+     * @example "Asia/Tokyo"
+     */
+    tz: string;
+    /**
+     * @description The start date and time of the event in ISO 8601 format.
+     * @example "2023-10-01T12:00:00Z"
+     */
+    start: string;
+    /**
+     * @description The end date and time of the event in ISO 8601 format.
+     * @example "2023-10-01T14:00:00Z"
+     */
+    end: string;
+    isSeries?: boolean;
+    /**
+     * @description The status of the event in its lifecycle.
+     * @example "draft"
+     * @example "live"
+     * @example "ended"
+     */
+    status: EventStatus;
+    /**
+     * @x-faker { url: faker.image.imageUrl() }
+     */
+    flyer?: Photo | null;
+    venue?: VenueBase | null;
+    /**
+     * @description Curerncy used for the event.
+     * @example "USD"
+     */
+    currency: string;
+    /**
+     * @description Is the event public?
+     * @example true
+     */
+    public: boolean;
+    location?: Location;
+    organizerId: string;
 }
 /**
  * @openapi
  * @description EventProfile respresent a public view of an event
  */
 interface EventProfile extends EventBase {
-	meta?: any;
-	organizer: any;
-	url?: string;
-	slug: string;
-	channels: string[];
-	description: MultipartText;
-	widgets: EventFeature[];
-	ticketPrices: string[];
-	buzzBuilder?: BuzzBuilder | null;
-	venue?: VenueBase | null;
-	tags: string[];
-	searchTags: string[];
-	sections: string[];
-	priceRange?: {
-		min?: string;
-		max?: string;
-	};
+    meta?: any;
+    organizer: any;
+    url?: string;
+    slug: string;
+    channels: string[];
+    description: MultipartText;
+    widgets: EventFeature[];
+    ticketPrices: string[];
+    buzzBuilder?: BuzzBuilder | null;
+    venue?: VenueBase | null;
+    tags: string[];
+    searchTags: string[];
+    sections: string[];
+    priceRange?: {
+        min?: string;
+        max?: string;
+    };
 }
 /**
  * Represents a discount coupon that can be applied to one or more offerings in an event platform.
@@ -684,152 +722,98 @@ interface EventProfile extends EventBase {
  * @export
  */
 interface Coupon extends VersionedDataRecord {
-	/**
-	 * ID of the company that issued this coupon.
-	 * @example "company_123abc"
-	 */
-	companyId: string;
-	/**
-	 * Internal description for the coupon.
-	 * This is not necessarily visible to users.
-	 * @example "Early bird discount for spring events"
-	 */
-	description: string;
-	/**
-	 * The code used to redeem this coupon during checkout.
-	 * For public or coded discounts.
-	 * @example "SPRING2025"
-	 */
-	code: string;
-	/**
-	 * Type of coupon — determines how it's distributed or applied.
-	 * @example "coded"
-	 */
-	type: "access" | "coded" | "public" | "hold";
-	/**
-	 * Fixed amount to deduct from the order total.
-	 * This is a currency-less value that matches the event or order currency.
-	 * Example: `10.00` = $10.00 off.
-	 * @minimum 0
-	 * @maximum 99999
-	 * @example 10.0
-	 */
-	amountOff: number;
-	/**
-	 * Percentage to deduct from the item or order total.
-	 * Range is 0–100. Use 0 for no percentage-based discount.
-	 * @minimum 0
-	 * @maximum 100
-	 * @example 20.0
-	 */
-	percentOff: number;
-	/**
-	 * Total number of times this coupon can be used.
-	 * A value of `0` means unlimited usage.
-	 * @example 100
-	 */
-	limit: number;
-	/**
-	 * Number of times this coupon has been redeemed.
-	 * Read-only field.
-	 * @readonly
-	 * @example 42
-	 */
-	quantitySold: number;
-	/**
-	 * List of offering IDs (e.g., ticket classes) this coupon applies to.
-	 * If empty, the coupon applies to all eligible offerings in its context.
-	 * @example ["off_123abc", "off_456def"]
-	 */
-	offeringIds: string[];
-	/**
-	 * List of context IDs (e.g., event, venue, or organizer) this coupon is valid for.
-	 * Follows the format: "evt_xxx", "org_xxx", etc.
-	 * @example ["evt_abc123", "org_def456"]
-	 */
-	contextIds: ContextId[];
-	/**
-	 * Time-based constraints that control when the coupon is active and when it expires.
-	 * Supports absolute dates or relative time offsets (in seconds) from event start.
-	 *
-	 * - If `start` is omitted, the coupon is valid immediately.
-	 * - If `end` is omitted, the coupon remains valid until the event ends.
-	 *
-	 * @example {
-	 *   start: { date: "2025-04-01T00:00:00" },
-	 *   end: { secondsBefore: 3600 }
-	 * }
-	 */
-	constraints: {
-		start?: TimeOrOffset;
-		end?: TimeOrOffset;
-	};
-	/**
-	 * Current status of the coupon for administrative purposes.
-	 * Determines whether it can be redeemed at checkout.
-	 * @example "active"
-	 */
-	status: "active" | "expired" | "disabled" | "sold_out";
-	/**
-	 * Schema version identifier.
-	 * Used to ensure compatibility between coupon formats.
-	 * @example "2025-01-10"
-	 */
-	version: ApiVersion;
-}
-/**
- * Captures metadata and request/session context at the time the cart is created.
- * Supports fraud detection, attribution, analytics, and partner session tracking.
- *
- * This interface is extensible — additional custom fields may be included as needed.
- *
- * @export
- */
-interface OrderContext {
-	/**
-	 * IP addresses associated with the user request.
-	 * Typically includes forwarded IPs and direct client IP.
-	 * @example ["203.0.113.1", "10.0.0.1"]
-	 */
-	ipAddresses: string[];
-	/**
-	 * Raw User-Agent header from the client request.
-	 * @example "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)..."
-	 */
-	userAgent: string;
-	/**
-	 * The referring URL from which the cart or checkout was initiated.
-	 * May be a partner site, marketing page, or event listing.
-	 * @example "https://partner.example.com/tickets/event123"
-	 */
-	referrer: string;
-	/**
-	 * Authenticated user ID, or null for anonymous guests.
-	 * @example "uid_456def"
-	 */
-	uid: string | null;
-	/**
-	 * The unique cart session ID assigned at the time the cart was created.
-	 * Helps track cart attribution across systems.
-	 * @example "cart_sess_abc123"
-	 */
-	cartSessionId: string;
-	/**
-	 * (Optional) Origin domain name if embedded or white-labeled.
-	 * Can help identify partner portals or iframe referrers.
-	 * @example "examplepartner.com"
-	 */
-	originDomain?: string;
-	/**
-	 * (Optional) Campaign ID, UTM source, or tracking label.
-	 * Useful for affiliate and analytics systems.
-	 * @example "utm_campaign=spring_launch"
-	 */
-	trackingId?: string;
-	/**
-	 * Allows custom fields for analytics, partners, or experiment data.
-	 */
-	[custom: string]: unknown;
+    /**
+     * ID of the company that issued this coupon.
+     * @example "company_123abc"
+     */
+    companyId: string;
+    /**
+     * Internal description for the coupon.
+     * This is not necessarily visible to users.
+     * @example "Early bird discount for spring events"
+     */
+    description: string;
+    /**
+     * The code used to redeem this coupon during checkout.
+     * For public or coded discounts.
+     * @example "SPRING2025"
+     */
+    code: string;
+    /**
+     * Type of coupon — determines how it's distributed or applied.
+     * @example "coded"
+     */
+    type: "access" | "coded" | "public" | "hold";
+    /**
+     * Fixed amount to deduct from the order total.
+     * This is a currency-less value that matches the event or order currency.
+     * Example: `10.00` = $10.00 off.
+     * @minimum 0
+     * @maximum 99999
+     * @example 10.0
+     */
+    amountOff: number;
+    /**
+     * Percentage to deduct from the item or order total.
+     * Range is 0–100. Use 0 for no percentage-based discount.
+     * @minimum 0
+     * @maximum 100
+     * @example 20.0
+     */
+    percentOff: number;
+    /**
+     * Total number of times this coupon can be used.
+     * A value of `0` means unlimited usage.
+     * @example 100
+     */
+    limit: number;
+    /**
+     * Number of times this coupon has been redeemed.
+     * Read-only field.
+     * @readonly
+     * @example 42
+     */
+    quantitySold: number;
+    /**
+     * List of offering IDs (e.g., ticket classes) this coupon applies to.
+     * If empty, the coupon applies to all eligible offerings in its context.
+     * @example ["off_123abc", "off_456def"]
+     */
+    offeringIds: string[];
+    /**
+     * List of context IDs (e.g., event, venue, or organizer) this coupon is valid for.
+     * Follows the format: "evt_xxx", "org_xxx", etc.
+     * @example ["evt_abc123", "org_def456"]
+     */
+    contextIds: ContextId[];
+    /**
+     * Time-based constraints that control when the coupon is active and when it expires.
+     * Supports absolute dates or relative time offsets (in seconds) from event start.
+     *
+     * - If `start` is omitted, the coupon is valid immediately.
+     * - If `end` is omitted, the coupon remains valid until the event ends.
+     *
+     * @example {
+     *   start: { date: "2025-04-01T00:00:00" },
+     *   end: { secondsBefore: 3600 }
+     * }
+     */
+    constraints: {
+        start?: TimeOrOffset;
+        end?: TimeOrOffset;
+    };
+    /**
+     * Current status of the coupon for administrative purposes.
+     * Determines whether it can be redeemed at checkout.
+     * @example "active"
+     */
+    status: "active" | "expired" | "disabled" | "sold_out";
+    /**
+     * Schema version identifier.
+     * Used to ensure compatibility between coupon formats.
+     * @example "2025-01-10"
+     */
+    version: ApiVersion;
 }
 /**
  * Cost breakdown for a specific item in the order.
@@ -838,22 +822,22 @@ interface OrderContext {
  * @export
  */
 interface OrderItemCosts extends OfferingCosts {
-	/**
-	 * Total cost of tickets before taxes, fees, and discounts.
-	 * @example { amount: 5000, currency: "USD" }
-	 */
-	subtotal: CurrencyAmount;
-	/**
-	 * Total discount amount applied to this item.
-	 * @example { amount: 1000, currency: "USD" }
-	 */
-	discount: CurrencyAmount;
-	/**
-	 * Total price before discounts.
-	 * Equal to subtotal + fee, before subtracting discount.
-	 * @example { amount: 6000, currency: "USD" }
-	 */
-	preDiscount: CurrencyAmount;
+    /**
+     * Total cost of tickets before taxes, fees, and discounts.
+     * @example { amount: 5000, currency: "USD" }
+     */
+    subtotal: CurrencyAmount;
+    /**
+     * Total discount amount applied to this item.
+     * @example { amount: 1000, currency: "USD" }
+     */
+    discount: CurrencyAmount;
+    /**
+     * Total price before discounts.
+     * Equal to subtotal + fee, before subtracting discount.
+     * @example { amount: 6000, currency: "USD" }
+     */
+    preDiscount: CurrencyAmount;
 }
 /**
  * Represents an individual item within an order.
@@ -861,87 +845,126 @@ interface OrderItemCosts extends OfferingCosts {
  * @export
  */
 interface OrderItem {
-	/**
-	 * Unique ID for this order item.
-	 * @example "item_abc123"
-	 */
-	id: string;
-	/**
-	 * Type of offering (e.g., ticket, package, merch).
-	 * @example "ticket"
-	 */
-	offeringType: OfferingType;
-	/**
-	 * ID of the offering purchased.
-	 * @example "evt_abc123_off_001"
-	 */
-	offeringId: string;
-	/**
-	 * Quantity purchased of this item.
-	 * @example 2
-	 */
-	quantity: number;
-	/**
-	 * Full cost breakdown for this item.
-	 */
-	costs: OrderItemCosts;
-	/**
-	 * If this item is included as part of a package, this is the ID of the parent item.
-	 * Otherwise, null.
-	 * @example null
-	 */
-	includedWithItemId: string | null;
-	/**
-	 * Breakdown of cost components (e.g., base, service fee, delivery).
-	 */
-	costComponents: CalculatedCostComponent[];
-	/**
-	 * Any relevant metadata associated with this item.
-	 * This can include custom fields or additional information.
-	 * @example { "customField": "value" }
-	 */
-	meta: any;
-	offering: OrderItemOffering;
+    /**
+     * Unique ID for this order item.
+     * @example "item_abc123"
+     */
+    id: string;
+    /**
+     * Type of offering (e.g., ticket, package, merch).
+     * @example "ticket"
+     */
+    offeringType: OfferingType;
+    /**
+     * ID of the offering purchased.
+     * @example "evt_abc123_off_001"
+     */
+    offeringId: string;
+    /**
+     * Quantity purchased of this item.
+     * @example 2
+     */
+    quantity: number;
+    /**
+     * Full cost breakdown for this item.
+     */
+    costs: OrderItemCosts;
+    /**
+     * If this item is included as part of a package, this is the ID of the parent item.
+     * Otherwise, null.
+     * @example null
+     */
+    includedWithItemId: string | null;
+    /**
+     * Breakdown of cost components (e.g., base, service fee, delivery).
+     */
+    costComponents: CalculatedCostComponent[];
+    /**
+     * Any relevant metadata associated with this item.
+     * This can include custom fields or additional information.
+     * @example { "customField": "value" }
+     */
+    meta: any;
+    offering: OrderItemOffering;
 }
 interface OrderItemOffering extends Pick<Offering, "name" | "costs" | "type"> {
-	/**
-	 * doc assicated with this offering in the DB.
-	 *
-	 * @example "events/1234567890/tickets/0987654321"
-	 */
-	docPath: string;
+    /**
+     * doc assicated with this offering in the DB.
+     *
+     * @example "events/1234567890/tickets/0987654321"
+     */
+    docPath: string;
 }
 /**
- * Person interface
+ * Represents the resolved context associated with a cart session.
+ * This may be an event, venue, or organizer, and is used to enrich the cart with metadata
+ * needed for UI rendering and pricing logic without requiring repeated DB lookups.
+ *
+ * Typically stored in `cart.meta.resolvedContext`.
+ *
+ * @export
  */
-interface Person {
-	name: string;
-	photoURL?: string | null;
-	displayName: string;
-	first: string;
-	last: string;
-	gender: null | string | "male" | "female" | "other";
-	birthdate?: string | null;
-	age?: number;
+interface ResolvedCartContext {
+    /**
+     * Unique identifier of the context entity.
+     * Typically matches the cart's `contextId` (e.g., "evt_abc123").
+     * @example "evt_abc123"
+     */
+    id: string;
+    /**
+     * Human-readable title or name of the context entity.
+     * Used for display in headers, summaries, and confirmations.
+     * @example "Downtown Comedy Night"
+     */
+    title: string;
+    /**
+     * Optional physical or virtual location of the event or venue.
+     * Can include address, coordinates, or virtual link.
+     */
+    location?: Location;
+    /**
+     * Optional logo, banner, or primary image representing the context.
+     * Used in UI to visually identify the entity during checkout.
+     */
+    logo?: Photo;
+    /**
+     * Optional description or summary of the context entity.
+     * Provides additional information to the customer during checkout.
+     * @example "Join us for a night of laughter with top comedians!"
+     */
+    start: string;
+    /**
+     * Optional end date or time of the event or context entity.
+     * Useful for events with a specific duration or schedule.
+     * @example "2023-10-15T22:00:00Z"
+     */
+    end?: string;
+    /**
+     * A map of offerings relevant to this context (e.g., ticket types, merch).
+     * Stored as a record keyed by offering ID to allow fast lookup.
+     * Each value is a partial offering object, intended for display, validation, or pricing.
+     * @example {
+     *   "off_123abc": { path: "events/ev_1234/tickets/tkt_567", offering: { name: "VIP Ticket", price: 3000 }),
+     *   "off_456def": { path: "events/ev_1234/tickets/tkt_567", offering: { name: "T-Shirt", price: 2000 }}
+     * }
+     */
+    offerings?: Record<string, ResolvedCartContextOffering>;
 }
-interface PersonContact {
-	email: string | null;
-	phone: string | null;
+interface ResolvedCartContextOffering {
+    path: string;
+    offering: Offering;
 }
-type Customer = Person & PersonContact & {
-	uid: string | null;
-};
 type CouponSummary = Pick<Coupon, "id" | "code" | "amountOff" | "percentOff" | "offeringIds">;
 type OrderStatus = "placed" | "completed" | "attending" | "cancelled" | "refunded" | "started" | "pending" | "abandoned";
 interface OrderCosts {
-	subtotal: CurrencyAmount;
-	fee: CurrencyAmount;
-	tax: CurrencyAmount;
-	discount: CurrencyAmount;
-	delivery: CurrencyAmount;
-	gross: CurrencyAmount;
-	preDiscount: CurrencyAmount;
-	total: CurrencyAmount;
+    subtotal: CurrencyAmount;
+    fee: CurrencyAmount;
+    tax: CurrencyAmount;
+    discount: CurrencyAmount;
+    delivery: CurrencyAmount;
+    gross: CurrencyAmount;
+    preDiscount: CurrencyAmount;
+    total: CurrencyAmount;
 }
 /**
  * Represents an order in the system.
@@ -949,145 +972,178 @@ interface OrderCosts {
  * @export
  */
 interface Order extends VCDataRecord {
-	/**
-	 * Human-readable order number for customer reference.
-	 * Often used in emails and receipts.
-	 * @example "GW-12345679"
-	 */
-	orderNumber: string;
-	/**
-	 * @description The currency code used for this order in ISO 4217 format.
-	 * @example "USD"
-	 *
-	 * @pattern ^[A-Z]{3}$
-	 */
-	currency: string;
-	/**
-	 * List of applied coupons used in the order.
-	 * Supports multiple entries based on organizer preferences.
-	 */
-	coupons?: CouponSummary[];
-	/**
-	 * Namespaced identifier indicating what the order is associated with.
-	 * Format: "{type}_{id}", where type is "evt", "ven", or "org".
-	 * @example "evt_56k2cf348"
-	 * @example "org_9912ff8"
-	 */
-	contextId: ContextId;
-	/**
-	 * Detailed cost breakdown for this order.
-	 */
-	costs: OrderCosts;
-	/**
-	 * Customer information related to this order.
-	 */
-	customer: Customer;
-	/**
-	 * The current status of the order.
-	 * @example "paid"
-	 */
-	status: OrderStatus;
-	/**
-	 * A list of individual items included in the order.
-	 */
-	items: OrderItem[];
-	/**
-	 * Agreement flags for terms and marketing opt-ins.
-	 */
-	agreements: {
-		/**
-		 * Whether the customer accepted the organizer’s custom terms.
-		 * @example true
-		 */
-		agreedToOrganizerTerms?: boolean;
-		/**
-		 * Whether the customer accepted the platform-wide terms of service.
-		 * @example true
-		 */
-		agreedToTerms?: boolean;
-		/**
-		 * Whether the customer opted in to receive marketing emails.
-		 * @example false
-		 */
-		emailOptIn?: boolean;
-		/**
-		 * Whether the customer opted in to receive marketing SMS messages.
-		 * @example false
-		 */
-		textOptIn?: boolean;
-	};
-	/**
-	 * Responses to dynamic questions during checkout (e.g. survey or registration).
-	 * @example { "tshirtSize": "M", "vipNewsletter": true }
-	 */
-	answers: {
-		[questionId: string]: string | boolean;
-	};
-	/**
-	 * Freeform object containing metadata forwarded from the partner site
-	 * or embedding context. Can include UTM tags, user traits, campaign IDs, etc.
-	 * @example { utm_campaign: "spring_launch", partner: "venue_123" }
-	 */
-	forwarded: any;
-	/**
-	 * Internal or computed metadata associated with the order.
-	 * May include fulfillment flags, debugging info, or derived calculations.
-	 * @example { preview: true, manuallyAdjusted: true }
-	 */
-	meta: any;
-	/**
-	 * Session and request context captured at the time of order creation.
-	 * Includes IPs, referrer, user agent, cart session ID, and tracking info.
-	 */
-	context: OrderContext;
-	version: ApiVersion;
-}
-/**
- * Represents the resolved context associated with a cart session.
- * This may be an event, venue, or organizer, and is used to enrich the cart with metadata
- * needed for UI rendering and pricing logic without requiring repeated DB lookups.
- *
- * Typically stored in `cart.meta.resolvedContext`.
- *
- * @export
- */
-interface ResolvedCartContext {
-	/**
-	 * Unique identifier of the context entity.
-	 * Typically matches the cart's `contextId` (e.g., "evt_abc123").
-	 * @example "evt_abc123"
-	 */
-	id: string;
-	/**
-	 * Human-readable title or name of the context entity.
-	 * Used for display in headers, summaries, and confirmations.
-	 * @example "Downtown Comedy Night"
-	 */
-	title: string;
-	/**
-	 * Optional physical or virtual location of the event or venue.
-	 * Can include address, coordinates, or virtual link.
-	 */
-	location?: Location;
-	/**
-	 * Optional logo, banner, or primary image representing the context.
-	 * Used in UI to visually identify the entity during checkout.
-	 */
-	logo?: Photo;
-	/**
-	 * A map of offerings relevant to this context (e.g., ticket types, merch).
-	 * Stored as a record keyed by offering ID to allow fast lookup.
-	 * Each value is a partial offering object, intended for display, validation, or pricing.
-	 * @example {
-	 *   "off_123abc": { path: "events/ev_1234/tickets/tkt_567", offering: { name: "VIP Ticket", price: 3000 }),
-	 *   "off_456def": { path: "events/ev_1234/tickets/tkt_567", offering: { name: "T-Shirt", price: 2000 }}
-	 * }
-	 */
-	offerings?: Record<string, ResolvedCartContextOffering>;
+    /**
+     * Human-readable order number for customer reference.
+     * Often used in emails and receipts.
+     * @example "GW-12345679"
+     */
+    orderNumber: string;
+    /**
+     * @description The currency code used for this order in ISO 4217 format.
+     * @example "USD"
+     *
+     * @pattern ^[A-Z]{3}$
+     */
+    currency: string;
+    /**
+     * List of applied coupons used in the order.
+     * Supports multiple entries based on organizer preferences.
+     */
+    coupons?: CouponSummary[];
+    organizerId: string;
+    /**
+     * Namespaced identifier indicating what the order is associated with.
+     * Format: "{type}_{id}", where type is "evt", "ven", or "org".
+     * @example "evt_56k2cf348"
+     * @example "org_9912ff8"
+     */
+    contextId: ContextId;
+    /**
+     * Detailed cost breakdown for this order.
+     */
+    costs: OrderCosts;
+    /**
+     * Customer information related to this order.
+     */
+    customer: Customer;
+    /**
+     * The current status of the order.
+     * @example "paid"
+     */
+    status: OrderStatus;
+    /**
+     * A list of individual items included in the order.
+     */
+    items: OrderItem[];
+    /**
+     * Agreement flags for terms and marketing opt-ins.
+     */
+    agreements: {
+        /**
+         * Whether the customer accepted the organizer’s custom terms.
+         * @example true
+         */
+        agreedToOrganizerTerms?: boolean;
+        /**
+         * Whether the customer accepted the platform-wide terms of service.
+         * @example true
+         */
+        agreedToTerms?: boolean;
+        /**
+         * Whether the customer opted in to receive marketing emails.
+         * @example false
+         */
+        emailOptIn?: boolean;
+        /**
+         * Whether the customer opted in to receive marketing SMS messages.
+         * @example false
+         */
+        textOptIn?: boolean;
+    };
+    /**
+     * Responses to dynamic questions during checkout (e.g. survey or registration).
+     * @example { "tshirtSize": "M", "vipNewsletter": true }
+     */
+    answers: {
+        [questionId: string]: string | boolean;
+    };
+    /**
+     * Freeform object containing metadata forwarded from the partner site
+     * or embedding context. Can include UTM tags, user traits, campaign IDs, etc.
+     * @example { utm_campaign: "spring_launch", partner: "venue_123" }
+     */
+    forwarded: any;
+    /**
+     * Internal or computed metadata associated with the order.
+     * May include fulfillment flags, debugging info, or derived calculations.
+     * @example { preview: true, manuallyAdjusted: true }
+     */
+    meta: {
+        /**
+         * Display context (event, venue, organizer) for rendering and logic.
+         */
+        resolvedContext?: ResolvedCartContext;
+        /**
+         * Cost components to calculate the cart costs.
+         *
+         * @ignore
+         */
+        costComponents?: CostComponent[];
+        /**
+         * Snapshot of when pricing was calculated and locked.
+         * Useful for honoring totals during a grace window.
+         */
+        priceLock?: {
+            lockedAt: string;
+            ttl?: number;
+        };
+        /**
+         * Any additional internal system flags, A/B test conditions, or
+         * non-critical partner payloads.
+         */
+        [key: string]: any;
+    };
+    /**
+     * Session and request context captured at the time of order creation.
+     * Includes IPs, referrer, user agent, cart session ID, and tracking info.
+     */
+    context: OrderContext;
+    version: ApiVersion;
 }
-interface ResolvedCartContextOffering {
-	path: string;
-	offering: Offering;
+type OrderContext = {
+    type: "event";
+    event: EventProfile;
+    venue?: Venue;
+} | {
+    type: "venue";
+    event?: EventProfile;
+    venue: Venue;
+};
+interface OrderContext$1 {
+    /**
+     * IP addresses associated with the user request.
+     * Typically includes forwarded IPs and direct client IP.
+     * @example ["203.0.113.1", "10.0.0.1"]
+     */
+    ipAddresses: string[];
+    /**
+     * Raw User-Agent header from the client request.
+     * @example "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)..."
+     */
+    userAgent: string;
+    /**
+     * The referring URL from which the cart or checkout was initiated.
+     * May be a partner site, marketing page, or event listing.
+     * @example "https://partner.example.com/tickets/event123"
+     */
+    referrer: string;
+    /**
+     * Authenticated user ID, or null for anonymous guests.
+     * @example "uid_456def"
+     */
+    uid: string | null;
+    /**
+     * The unique cart session ID assigned at the time the cart was created.
+     * Helps track cart attribution across systems.
+     * @example "cart_sess_abc123"
+     */
+    cartSessionId: string;
+    /**
+     * (Optional) Origin domain name if embedded or white-labeled.
+     * Can help identify partner portals or iframe referrers.
+     * @example "examplepartner.com"
+     */
+    originDomain?: string;
+    /**
+     * (Optional) Campaign ID, UTM source, or tracking label.
+     * Useful for affiliate and analytics systems.
+     * @example "utm_campaign=spring_launch"
+     */
+    trackingId?: string;
+    /**
+     * Allows custom fields for analytics, partners, or experiment data.
+     */
+    [custom: string]: unknown;
 }
 /**
  * Represents a temporary or persisted cart before order placement.
@@ -1095,87 +1151,118 @@ interface ResolvedCartContextOffering {
  *
  * @export
  */
-interface CartSession extends DataRecord, Pick<Order, "currency" | "contextId" | "version" | "coupons"> {
-	/**
-	 * Authenticated user ID, if available.
-	 * @example "uid_123abc"
-	 */
-	uid: string | null;
-	/**
-	 * Optional snapshot of customer info entered during cart fill.
-	 * Not required and not final.
-	 *
-	 * @schema lazy(() => customerSchema).optional()
-	 */
-	customer?: Partial<Customer>;
-	/**
-	 * @schema lazy(() => orderContextSchema).optional()
-	 */
-	context: Partial<OrderContext>;
-	/**
-	 * Items the user has added to their cart.
-	 */
-	items: Partial<OrderItem>[];
-	/**
-	 * Estimated totals based on current cart state.
-	 * These values are subject to recalculation before checkout.
-	 */
-	costs?: {
-		subtotal: CurrencyAmount;
-		discount: CurrencyAmount;
-		tax: CurrencyAmount;
-		fee: CurrencyAmount;
-		delivery: CurrencyAmount;
-		total: CurrencyAmount;
-	};
-	/**
-	 * Stripe PaymentIntent ID linked to this cart, if created.
-	 * Used for confirming payment on the backend.
-	 * @example "pi_1ABCXYZ..."
-	 */
-	paymentIntentId?: string;
-	/**
-	 * Stripe PaymentIntent client secret, used by frontend (e.g. Stripe.js).
-	 * Required for completing the payment flow.
-	 * @example "pi_1ABCXYZ..._secret_456"
-	 */
-	paymentIntentClientSecret?: string;
-	/**
-	 * Partner-forwarded data (e.g. utm, session metadata).
-	 */
-	forwarded?: any;
-	/**
-	 * Internal metadata, flags, debug hints, or experimental context.
-	 */
-	meta: {
-		/**
-		 * Display context (event, venue, organizer) for rendering and logic.
-		 */
-		resolvedContext?: ResolvedCartContext;
-		/**
-		 * Cost components to calculate the cart costs.
-		 *
-		 * @ignore
-		 */
-		costComponents?: CostComponent[];
-		/**
-		 * Snapshot of when pricing was calculated and locked.
-		 * Useful for honoring totals during a grace window.
-		 */
-		priceLock?: {
-			lockedAt: string;
-			ttl?: number;
-		};
-		/**
-		 * Any additional internal system flags, A/B test conditions, or
-		 * non-critical partner payloads.
-		 */
-		[key: string]: any;
-	};
-	status: "started" | "completed" | "abandoned" | "cancelled";
+interface CartSession extends DataRecord, Pick<Order, "currency" | "contextId" | "version" | "coupons" | "companyId" | "organizerId" | "meta"> {
+    orderId?: string;
+    /**
+     * Authenticated user ID, if available.
+     * @example "uid_123abc"
+     */
+    uid: string | null;
+    /**
+     * Optional snapshot of customer info entered during cart fill.
+     * Not required and not final.
+     *
+     * @schema lazy(() => customerSchema).optional()
+     */
+    customer?: Partial<Customer>;
+    /**
+     * @schema lazy(() => orderContextSchema).optional()
+     */
+    context: Partial<OrderContext$1>;
+    /**
+     * Items the user has added to their cart.
+     */
+    items: Partial<OrderItem>[];
+    /**
+     * Estimated totals based on current cart state.
+     * These values are subject to recalculation before checkout.
+     */
+    costs?: {
+        subtotal: CurrencyAmount;
+        discount: CurrencyAmount;
+        tax: CurrencyAmount;
+        fee: CurrencyAmount;
+        delivery: CurrencyAmount;
+        total: CurrencyAmount;
+    };
+    paymentStatus: "pending" | "confirmed" | "failed" | "refunded";
+    /**
+     * Stripe PaymentIntent ID linked to this cart, if created.
+     * Used for confirming payment on the backend.
+     * @example "pi_1ABCXYZ..."
+     */
+    paymentIntentId?: string;
+    /**
+     * Stripe PaymentIntent client secret, used by frontend (e.g. Stripe.js).
+     * Required for completing the payment flow.
+     * @example "pi_1ABCXYZ..._secret_456"
+     */
+    paymentIntentClientSecret?: string;
+    /**
+     * Partner-forwarded data (e.g. utm, session metadata).
+     */
+    forwarded?: any;
+    status: "started" | "completed" | "abandoned" | "cancelled";
 }
 type UpdatableCartSession = Pick<CartSession, "customer" | "items">;
 
+/**
+ * Pagination parameters for a paginated API request.
+ */
+interface Pagination {
+    /** Number of results per page. */
+    size: number;
+    /** Page number (starting from 1). */
+    page: number;
+    /** Continuation */
+    continuation?: string;
+}
+
+/**
+ * Supported HTTP methods.
+ */
+type RequestMethod = "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+type RequestOptions = {
+    method?: RequestMethod;
+    data?: any;
+    query?: Record<string, string | number | boolean | undefined>;
+    headers?: Record<string, string>;
+    pagination?: Pagination;
+};
+/**
+ * A function that performs a request to the Cohost API.
+ * The generic <T> allows you to specify the expected response type.
+ */
+type RequestFn = <T = any>(path: string, options?: RequestOptions) => Promise<T>;
+
+/**
+ * Optional settings for customizing the behavior of the CohostClient.
+ */
+interface CohostClientSettings {
+    /** Enable verbose debug output for all API requests. */
+    debug?: boolean;
+    /** Override the default API base URL (defaults to apiBaseUrl). */
+    apiUrl?: string;
+}
+
+/**
+ * Base class for all API endpoint groups within the Cohost SDK.
+ * Provides shared access to the configured request function and settings.
+ */
+declare class CohostEndpoint {
+    /** Shared request function injected from the client */
+    protected request: RequestFn;
+    /** Client settings passed during instantiation */
+    protected settings: CohostClientSettings;
+    /**
+     * Constructs a new endpoint group.
+     *
+     * @param request - The shared request function for performing API calls
+     * @param settings - The client-wide settings passed from the parent client
+     */
+    constructor(request: RequestFn, settings: CohostClientSettings);
+}
+
 /**
  * Provides methods to interact with the Cohost Events API.
  *
@@ -1213,6 +1300,15 @@ declare class EventsAPI extends CohostEndpoint {
      * @throws Will throw an error if the request fails or the event does not exist
      */
     tickets(id: string): Promise<Ticket[]>;
+    /**
+     * List attendees in the event.
+     *
+     * Requires: valid authentication token. This endpoint is not public.
+     *
+     * @param id - The ID of the event.
+     * @returns List of tickets (attendees) for the event.
+     */
+    attendees(id: string, filters?: PaginatedRequest<any>): Promise<PaginatedResponse<Attendee3>>;
 }
 
 /**
@@ -1280,7 +1376,7 @@ declare class SessionsAPI extends CohostEndpoint {
      *
      * @throws Will throw an error if the update fails
      */
-    update(id: string, input: UpdatableCartSession): Promise<CartSession>;
+    update(id: string, input: Partial<UpdatableCartSession>): Promise<CartSession>;
     /**
      * Cancel (soft delete) a cart session.
      *
@@ -1302,6 +1398,21 @@ declare class SessionsAPI extends CohostEndpoint {
         offeringId: string;
         quantity: number;
     }): Promise<CartSession>;
+    /**
+     * Pre-validate and prepare the cart session for checkout.
+     * @param sessionId
+     */
+    preValidate(sessionId: string, data: any): Promise<CartSession>;
+    /**
+     * Close the cart session, and place the order.
+     *
+     * @param sessionId - The ID of the session
+     * @param data - Data to place the order
+     * @returns {CartSession} The latest cart session
+     *
+     * @throws Will throw an error if the order placement fails
+     */
+    placeOrder(sessionId: string, data: any): Promise<CartSession>;
     /**
      * Remove an item from the cart session.
      * The same as setting the quantity to 0.