@commercejs/types 0.1.0

package/dist/payment-provider.d.ts

@@ -0,0 +1,117 @@
+import type { Maybe } from './common.js';
+/** Status of a payment session through its lifecycle */
+export type PaymentSessionStatus = 'pending' | 'requires_action' | 'processing' | 'authorized' | 'captured' | 'failed' | 'cancelled' | 'refunded' | 'partially_refunded';
+/**
+ * A payment session — the unit of work for a payment.
+ *
+ * Created by `PaymentProvider.createSession()`, progressed through
+ * confirm → capture, and optionally refunded.
+ */
+export interface PaymentSession {
+    /** Unique session identifier (provider-scoped) */
+    id: string;
+    /** Which provider created this session */
+    providerId: string;
+    /** Current status */
+    status: PaymentSessionStatus;
+    /** Payment amount (in major currency units, e.g., 99.99) */
+    amount: number;
+    /** ISO 4217 currency code */
+    currency: string;
+    /** Provider-specific data (e.g., Stripe PaymentIntent ID, Tap charge ID) */
+    providerData: Maybe<Record<string, unknown>>;
+    /** URL to redirect customer for 3DS / authentication / hosted page */
+    redirectUrl: Maybe<string>;
+    /** When the session was created */
+    createdAt: string;
+}
+/** Input to create a payment session */
+export interface CreatePaymentSessionInput {
+    /** Payment amount (major currency units) */
+    amount: number;
+    /** ISO 4217 currency code (e.g., 'SAR', 'USD') */
+    currency: string;
+    /** Client-side token from gateway SDK (e.g., Tap tok_xxx, Stripe pm_xxx) */
+    sourceToken?: string;
+    /** Order ID to associate with this payment */
+    orderId?: string;
+    /** Customer ID (if authenticated) */
+    customerId?: string;
+    /** Customer details — required by Tap and most gateways */
+    customer?: {
+        email?: string;
+        firstName?: string;
+        lastName?: string;
+        phone?: string;
+    };
+    /** Where to redirect after 3DS / hosted payment page */
+    returnUrl?: string;
+    /** Cancel URL for hosted payment pages */
+    cancelUrl?: string;
+    /** Per-transaction webhook URL — Tap sends charge events to this URL as `post.url` */
+    webhookUrl?: string;
+    /** Idempotency key to prevent duplicate charges on retries */
+    idempotencyKey?: string;
+    /** Arbitrary metadata passed to the gateway */
+    metadata?: Record<string, unknown>;
+}
+/** Input for refunds */
+export interface RefundInput {
+    /** Session ID of the payment to refund */
+    sessionId: string;
+    /** Partial refund amount; omit for full refund */
+    amount?: number;
+    /** Reason for the refund */
+    reason?: string;
+}
+/** Parsed webhook event from a payment provider */
+export interface PaymentWebhookEvent {
+    /** Event type (e.g., 'payment.captured', 'refund.created') */
+    type: string;
+    /** Related payment session ID */
+    sessionId: string;
+    /** Raw event data from the provider */
+    data: Record<string, unknown>;
+}
+/**
+ * Pluggable payment gateway interface.
+ *
+ * Each gateway (Stripe, Tap, SoftPOS) implements this interface.
+ * The core lifecycle is: `create → confirm → refund`.
+ * Optional methods (`captureSession`, `cancelSession`, `verifyWebhook`)
+ * support auth+capture gateways and webhook-driven flows.
+ *
+ * @example
+ * ```ts
+ * const tap = new TapPaymentProvider({ secretKey: 'sk_test_...' })
+ * const session = await tap.createSession({
+ *   amount: 99.99,
+ *   currency: 'SAR',
+ *   sourceToken: 'tok_xxx', // from goSell.js
+ *   returnUrl: 'https://store.com/checkout/confirm',
+ * })
+ * // redirect customer to session.redirectUrl for 3DS...
+ * const confirmed = await tap.confirmSession(session.id)
+ * ```
+ */
+export interface PaymentProvider {
+    /** Unique provider identifier (e.g., 'stripe', 'tap') */
+    readonly id: string;
+    /** Human-readable provider name (e.g., 'Stripe', 'Tap Payments') */
+    readonly name: string;
+    /** Create a payment session (charge or redirect) */
+    createSession(input: CreatePaymentSessionInput): Promise<PaymentSession>;
+    /** Confirm a payment after customer action (3DS redirect, OTP) */
+    confirmSession(sessionId: string, data?: Record<string, unknown>): Promise<PaymentSession>;
+    /** Get current status of a payment session */
+    getSession(sessionId: string): Promise<PaymentSession>;
+    /** Refund a captured payment (full or partial) */
+    refund(input: RefundInput): Promise<PaymentSession>;
+    /** Capture an authorized payment — only for auth+capture gateways */
+    captureSession?(sessionId: string, amount?: number): Promise<PaymentSession>;
+    /** Cancel/void a pending or authorized session */
+    cancelSession?(sessionId: string): Promise<PaymentSession>;
+    /** Verify webhook signature and parse event (server-side only) */
+    verifyWebhook?(payload: string | Uint8Array, signature: string): Promise<PaymentWebhookEvent>;
+}
+//# sourceMappingURL=payment-provider.d.ts.map

package/dist/payment-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-provider.d.ts","sourceRoot":"","sources":["../src/payment-provider.ts"],"names":[],"mappings":"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"}

package/dist/payment-provider.js

@@ -0,0 +1,10 @@
+// ---------------------------------------------------------------------------
+// PaymentProvider — pluggable gateway interface (Strategy pattern)
+// ---------------------------------------------------------------------------
+//
+// Each payment gateway (Stripe, Tap, Salla, SoftPOS) implements this
+// interface. The Universal Checkout engine will use a PaymentProviderRegistry
+// to select the right provider at runtime.
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=payment-provider.js.map

package/dist/payment-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-provider.js","sourceRoot":"","sources":["../src/payment-provider.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,mEAAmE;AACnE,8EAA8E;AAC9E,EAAE;AACF,qEAAqE;AACrE,8EAA8E;AAC9E,2CAA2C;AAC3C,8EAA8E"}

package/dist/payment.d.ts

@@ -0,0 +1,22 @@
+import type { Id, LocalizedString, Maybe } from './common.js';
+/** Known GCC and international payment types */
+export type PaymentType = 'card' | 'mada' | 'apple_pay' | 'google_pay' | 'stc_pay' | 'tamara' | 'tabby' | 'tap' | 'cash_on_delivery' | 'bank_transfer' | 'sadad' | 'paypal' | 'custom';
+/** Buy Now Pay Later installment details */
+export interface Installment {
+    count: number;
+    /** Amount per installment in smallest currency unit */
+    amount: number;
+    currency: string;
+}
+/** Payment method option */
+export interface PaymentMethod {
+    id: Id;
+    type: PaymentType | string;
+    name: LocalizedString;
+    provider: string;
+    /** BNPL installment info (for Tamara, Tabby, etc.) */
+    installments: Maybe<Installment>;
+    /** Icon/logo URL */
+    icon: Maybe<string>;
+}
+//# sourceMappingURL=payment.d.ts.map

package/dist/payment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment.d.ts","sourceRoot":"","sources":["../src/payment.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAE7D,gDAAgD;AAChD,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,MAAM,GACN,WAAW,GACX,YAAY,GACZ,SAAS,GACT,QAAQ,GACR,OAAO,GACP,KAAK,GACL,kBAAkB,GAClB,eAAe,GACf,OAAO,GACP,QAAQ,GACR,QAAQ,CAAA;AAEZ,4CAA4C;AAC5C,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,4BAA4B;AAC5B,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,EAAE,CAAA;IACN,IAAI,EAAE,WAAW,GAAG,MAAM,CAAA;IAC1B,IAAI,EAAE,eAAe,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,sDAAsD;IACtD,YAAY,EAAE,KAAK,CAAC,WAAW,CAAC,CAAA;IAChC,oBAAoB;IACpB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;CACpB"}

package/dist/payment.js

@@ -0,0 +1,5 @@
+// ---------------------------------------------------------------------------
+// Payment domain types
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=payment.js.map

package/dist/payment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment.js","sourceRoot":"","sources":["../src/payment.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E"}

package/dist/product.d.ts

@@ -0,0 +1,162 @@
+import type { DiscountablePrice, Id, Image, LocalizedString, Maybe, Price } from './common.js';
+import type { Category } from './category.js';
+import type { PriceTier, CustomerGroupPrice } from './wholesale.js';
+import type { AuctionProductMeta } from './auction.js';
+import type { RentalProductMeta } from './rental.js';
+/** Product attribute (e.g., color, size, material) */
+export interface Attribute {
+    /** Machine-readable code (e.g., "color") */
+    code: string;
+    /** Human-readable name */
+    name: LocalizedString;
+    /** Display value */
+    value: LocalizedString;
+}
+/** A selectable product option group (e.g. Size, Color) */
+export interface ProductOption {
+    /** Machine-readable identifier */
+    id: Id;
+    /** Human-readable option name (e.g. "Size", "Color") */
+    name: LocalizedString;
+    /** Possible values for this option */
+    values: {
+        id: Id;
+        name: LocalizedString;
+    }[];
+}
+/** A specific variant of a product (e.g., "Red / XL") */
+export interface ProductVariant {
+    id: Id;
+    sku: Maybe<string>;
+    name: Maybe<LocalizedString>;
+    price: Maybe<DiscountablePrice>;
+    attributes: Attribute[];
+    inStock: boolean;
+    inventoryQuantity: Maybe<number>;
+}
+/** Classifies the product for fulfillment logic and UI rendering */
+export type ProductType = 'physical' | 'digital' | 'service' | 'event' | 'subscription' | 'auction' | 'rental' | 'gift_card';
+/** Metadata for digital products (ebooks, software, courses, etc.) */
+export interface DigitalProductMeta {
+    /** Download URL (populated after purchase) */
+    downloadUrl: Maybe<string>;
+    /** File size in bytes (for display) */
+    fileSize: Maybe<number>;
+    /** File format / MIME type (e.g., "application/pdf") */
+    fileType: Maybe<string>;
+    /** License key (populated after purchase) */
+    licenseKey: Maybe<string>;
+    /** Maximum number of downloads allowed (null = unlimited) */
+    maxDownloads: Maybe<number>;
+    /** Download link expiry duration in hours (null = never) */
+    expiresInHours: Maybe<number>;
+}
+/** Metadata for service products (consulting, repairs, bookings) */
+export interface ServiceProductMeta {
+    /** Estimated duration in minutes */
+    durationMinutes: Maybe<number>;
+    /** Whether the service requires scheduling / booking */
+    requiresBooking: boolean;
+    /** Service delivery mode */
+    deliveryMode: 'in_person' | 'remote' | 'hybrid';
+}
+/** Metadata for event/ticket products (concerts, conferences, classes) */
+export interface EventProductMeta {
+    /** Event start date/time (ISO 8601) */
+    startDate: string;
+    /** Event end date/time (ISO 8601) */
+    endDate: Maybe<string>;
+    /** Venue name */
+    venue: Maybe<LocalizedString>;
+    /** Venue address or online meeting URL */
+    location: Maybe<string>;
+    /** Whether the event is virtual / online */
+    isVirtual: boolean;
+    /** Seat or section information */
+    seatInfo: Maybe<string>;
+    /** Total available seats / capacity (null = unlimited) */
+    capacity: Maybe<number>;
+}
+/** Metadata for subscription products (recurring billing) */
+export interface SubscriptionProductMeta {
+    /** Billing interval */
+    interval: 'daily' | 'weekly' | 'monthly' | 'quarterly' | 'yearly';
+    /** Number of intervals between billings (e.g., 2 = every 2 months) */
+    intervalCount: number;
+    /** Free trial period in days (0 = no trial) */
+    trialDays: number;
+    /** Price per billing cycle (may differ from product.price for introductory offers) */
+    recurringPrice: Price;
+}
+/** Pre-order availability information */
+export interface PreOrderMeta {
+    /** Whether this product is available for pre-order */
+    enabled: boolean;
+    /** Expected release / availability date (ISO 8601) */
+    releaseDate: Maybe<string>;
+    /** Optional deposit amount (null = full price required) */
+    depositAmount: Maybe<Price>;
+    /** Pre-order message to display (e.g., "Ships by March 2026") */
+    message: Maybe<LocalizedString>;
+}
+/** Core product entity */
+export interface Product {
+    id: Id;
+    sku: Maybe<string>;
+    /** Bilingual product name */
+    name: LocalizedString;
+    slug: string;
+    /** Bilingual product description (may contain HTML) */
+    description: Maybe<LocalizedString>;
+    /** Short description for listings */
+    shortDescription: Maybe<LocalizedString>;
+    price: Maybe<DiscountablePrice>;
+    primaryImage: Maybe<Image>;
+    gallery: Image[];
+    rating: Maybe<{
+        average: number;
+        count: number;
+    }>;
+    variants: ProductVariant[];
+    /** Selectable option groups (Size, Color, etc.) */
+    options: ProductOption[];
+    attributes: Attribute[];
+    /** Maximum purchasable quantity (null = unlimited) */
+    quantityLimit: Maybe<number>;
+    categories: Category[];
+    inStock: boolean;
+    /** Whether the displayed price includes VAT */
+    vatIncluded: boolean;
+    /** VAT rate as a decimal (e.g., 0.15 for KSA 15%) */
+    vatRate: Maybe<number>;
+    tags: string[];
+    createdAt: string;
+    updatedAt: string;
+    /** Product classification — drives fulfillment logic and UI. Defaults to 'physical' */
+    productType: ProductType;
+    /** Digital product metadata (present when productType === 'digital') */
+    digital: Maybe<DigitalProductMeta>;
+    /** Service product metadata (present when productType === 'service') */
+    service: Maybe<ServiceProductMeta>;
+    /** Event/ticket metadata (present when productType === 'event') */
+    event: Maybe<EventProductMeta>;
+    /** Subscription metadata (present when productType === 'subscription') */
+    subscription: Maybe<SubscriptionProductMeta>;
+    /** Auction metadata (present when productType === 'auction') */
+    auction: Maybe<AuctionProductMeta>;
+    /** Rental metadata (present when productType === 'rental') */
+    rental: Maybe<RentalProductMeta>;
+    /** Pre-order information (present on any productType) */
+    preOrder: Maybe<PreOrderMeta>;
+    /** Whether this product requires shipping (false for digital, services, events) */
+    requiresShipping: boolean;
+    /** Minimum order quantity for this product (null = 1) */
+    minOrderQuantity: Maybe<number>;
+    /** Volume-based pricing tiers (null = single price) */
+    priceTiers: Maybe<PriceTier[]>;
+    /** Per-customer-group price overrides */
+    customerGroupPricing: Maybe<CustomerGroupPrice[]>;
+    /** Whether this product is fulfilled by a third-party / dropshipper */
+    isDropshipped: boolean;
+}
+//# sourceMappingURL=product.d.ts.map

package/dist/product.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product.d.ts","sourceRoot":"","sources":["../src/product.ts"],"names":[],"mappings":"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"}

package/dist/product.js

@@ -0,0 +1,5 @@
+// ---------------------------------------------------------------------------
+// Product domain types
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=product.js.map

package/dist/product.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product.js","sourceRoot":"","sources":["../src/product.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E"}

package/dist/promotion.d.ts

@@ -0,0 +1,65 @@
+import type { Id, LocalizedString, Maybe, Price } from './common.js';
+/** How the discount value is applied */
+export type DiscountType = 'percentage' | 'fixed_amount' | 'free_shipping' | 'buy_x_get_y' | 'bundle';
+/** What the promotion applies to */
+export type PromotionTarget = 'order' | 'product' | 'category' | 'shipping' | 'customer';
+/** Minimum requirements to qualify for a promotion */
+export interface PromotionCondition {
+    /** Minimum order subtotal */
+    minPurchaseAmount: Maybe<Price>;
+    /** Minimum item count in cart */
+    minItemCount: Maybe<number>;
+    /** Required product IDs (for product-specific promos) */
+    productIds: Maybe<string[]>;
+    /** Required category IDs (for category-specific promos) */
+    categoryIds: Maybe<string[]>;
+    /** First-time customer only */
+    firstOrderOnly: boolean;
+}
+/** A promotion / discount campaign */
+export interface Promotion {
+    id: Id;
+    /** Display name */
+    name: LocalizedString;
+    /** Description / terms */
+    description: Maybe<LocalizedString>;
+    /** Discount mechanism */
+    discountType: DiscountType;
+    /** Discount value — percentage (0–100) or fixed amount */
+    discountValue: number;
+    /** Currency for fixed_amount discounts */
+    currency: Maybe<string>;
+    /** Maximum discount cap for percentage discounts (null = uncapped) */
+    maxDiscount: Maybe<Price>;
+    /** What does this promotion apply to */
+    target: PromotionTarget;
+    /** Conditions that must be met */
+    conditions: PromotionCondition;
+    /** Start date (ISO 8601) */
+    startsAt: string;
+    /** End date (ISO 8601, null = no end) */
+    endsAt: Maybe<string>;
+    /** Whether this promotion is currently active */
+    isActive: boolean;
+    /** Whether a coupon code is required to activate */
+    requiresCoupon: boolean;
+    /** Usage limit per customer (null = unlimited) */
+    usageLimitPerCustomer: Maybe<number>;
+    /** Total usage limit (null = unlimited) */
+    usageLimitTotal: Maybe<number>;
+}
+/** A redeemable coupon code */
+export interface Coupon {
+    id: Id;
+    /** The code the customer enters (e.g., "SAVE20") */
+    code: string;
+    /** Associated promotion */
+    promotion: Promotion;
+    /** Whether this coupon is still valid */
+    isValid: boolean;
+    /** Reason if invalid (e.g., "expired", "usage_limit_reached") */
+    invalidReason: Maybe<string>;
+    /** Number of times this coupon has been used */
+    timesUsed: number;
+}
+//# sourceMappingURL=promotion.d.ts.map

package/dist/promotion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promotion.d.ts","sourceRoot":"","sources":["../src/promotion.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAEpE,wCAAwC;AACxC,MAAM,MAAM,YAAY,GACpB,YAAY,GACZ,cAAc,GACd,eAAe,GACf,aAAa,GACb,QAAQ,CAAA;AAEZ,oCAAoC;AACpC,MAAM,MAAM,eAAe,GACvB,OAAO,GACP,SAAS,GACT,UAAU,GACV,UAAU,GACV,UAAU,CAAA;AAEd,sDAAsD;AACtD,MAAM,WAAW,kBAAkB;IACjC,6BAA6B;IAC7B,iBAAiB,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IAC/B,iCAAiC;IACjC,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IAC3B,yDAAyD;IACzD,UAAU,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;IAC3B,2DAA2D;IAC3D,WAAW,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;IAC5B,+BAA+B;IAC/B,cAAc,EAAE,OAAO,CAAA;CACxB;AAED,sCAAsC;AACtC,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,EAAE,CAAA;IACN,mBAAmB;IACnB,IAAI,EAAE,eAAe,CAAA;IACrB,0BAA0B;IAC1B,WAAW,EAAE,KAAK,CAAC,eAAe,CAAC,CAAA;IACnC,yBAAyB;IACzB,YAAY,EAAE,YAAY,CAAA;IAC1B,0DAA0D;IAC1D,aAAa,EAAE,MAAM,CAAA;IACrB,0CAA0C;IAC1C,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IACvB,sEAAsE;IACtE,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IACzB,wCAAwC;IACxC,MAAM,EAAE,eAAe,CAAA;IACvB,kCAAkC;IAClC,UAAU,EAAE,kBAAkB,CAAA;IAC9B,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAA;IAChB,yCAAyC;IACzC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IACrB,iDAAiD;IACjD,QAAQ,EAAE,OAAO,CAAA;IACjB,oDAAoD;IACpD,cAAc,EAAE,OAAO,CAAA;IACvB,kDAAkD;IAClD,qBAAqB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IACpC,2CAA2C;IAC3C,eAAe,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;CAC/B;AAED,+BAA+B;AAC/B,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,EAAE,CAAA;IACN,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAA;IACZ,2BAA2B;IAC3B,SAAS,EAAE,SAAS,CAAA;IACpB,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAA;IAChB,iEAAiE;IACjE,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IAC5B,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAA;CAClB"}

package/dist/promotion.js

@@ -0,0 +1,5 @@
+// ---------------------------------------------------------------------------
+// Promotion & discount types
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=promotion.js.map

package/dist/promotion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promotion.js","sourceRoot":"","sources":["../src/promotion.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,6BAA6B;AAC7B,8EAA8E"}

package/dist/rental.d.ts

@@ -0,0 +1,84 @@
+import type { Id, LocalizedString, Maybe, Price } from './common.js';
+/** Rental pricing unit */
+export type RentalPricingUnit = 'hourly' | 'daily' | 'weekly' | 'monthly';
+/** Rental product metadata */
+export interface RentalProductMeta {
+    /** Primary pricing unit */
+    pricingUnit: RentalPricingUnit;
+    /** Price per unit */
+    pricePerUnit: Price;
+    /** Discounted pricing for longer durations */
+    pricingTiers: Maybe<RentalPricingTier[]>;
+    /** Security deposit amount (null = no deposit) */
+    securityDeposit: Maybe<Price>;
+    /** Minimum rental duration (in pricingUnit units) */
+    minDuration: number;
+    /** Maximum rental duration (null = unlimited) */
+    maxDuration: Maybe<number>;
+    /** Whether pickup/delivery is required (vs. fully digital) */
+    requiresPickup: boolean;
+    /** Pickup / return location */
+    location: Maybe<LocalizedString>;
+    /** Late return fee per unit */
+    lateFeePerUnit: Maybe<Price>;
+    /** Preparation time before item is available (hours) */
+    preparationTime: Maybe<number>;
+}
+/** Pricing tier for longer rental durations */
+export interface RentalPricingTier {
+    /** Minimum # of units to qualify */
+    minUnits: number;
+    /** Price per unit at this tier */
+    pricePerUnit: Price;
+    /** Optional label (e.g., "Weekly Rate") */
+    label: Maybe<LocalizedString>;
+}
+/** A time slot for availability */
+export interface AvailabilitySlot {
+    /** Start time (ISO 8601) */
+    startDate: string;
+    /** End time (ISO 8601) */
+    endDate: string;
+    /** Number of units available in this slot */
+    availableQuantity: number;
+    /** Whether this slot is fully booked */
+    isBooked: boolean;
+}
+/** Rental booking status */
+export type RentalBookingStatus = 'pending' | 'confirmed' | 'active' | 'returned' | 'overdue' | 'cancelled';
+/** A rental booking entity */
+export interface RentalBooking {
+    id: Id;
+    productId: Id;
+    customerId: Id;
+    status: RentalBookingStatus;
+    /** Rental start (ISO 8601) */
+    startDate: string;
+    /** Rental end (ISO 8601) */
+    endDate: string;
+    /** Actual return date (ISO 8601, null if not yet returned) */
+    returnedAt: Maybe<string>;
+    /** Pricing unit used */
+    pricingUnit: RentalPricingUnit;
+    /** Number of pricing units */
+    duration: number;
+    /** Total rental cost */
+    totalPrice: Price;
+    /** Security deposit amount held */
+    depositAmount: Maybe<Price>;
+    /** Whether deposit has been refunded */
+    depositRefunded: boolean;
+    /** Late fees accrued */
+    lateFees: Maybe<Price>;
+    /** Related order ID */
+    orderId: Maybe<Id>;
+    createdAt: string;
+}
+/** Input for creating a rental booking */
+export interface CreateRentalBookingInput {
+    productId: string;
+    startDate: string;
+    endDate: string;
+    quantity?: number;
+}
+//# sourceMappingURL=rental.d.ts.map

package/dist/rental.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rental.d.ts","sourceRoot":"","sources":["../src/rental.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAEpE,0BAA0B;AAC1B,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAA;AAEzE,8BAA8B;AAC9B,MAAM,WAAW,iBAAiB;IAChC,2BAA2B;IAC3B,WAAW,EAAE,iBAAiB,CAAA;IAC9B,qBAAqB;IACrB,YAAY,EAAE,KAAK,CAAA;IACnB,8CAA8C;IAC9C,YAAY,EAAE,KAAK,CAAC,iBAAiB,EAAE,CAAC,CAAA;IACxC,kDAAkD;IAClD,eAAe,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IAC7B,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAA;IACnB,iDAAiD;IACjD,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IAC1B,8DAA8D;IAC9D,cAAc,EAAE,OAAO,CAAA;IACvB,+BAA+B;IAC/B,QAAQ,EAAE,KAAK,CAAC,eAAe,CAAC,CAAA;IAChC,+BAA+B;IAC/B,cAAc,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IAC5B,wDAAwD;IACxD,eAAe,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;CAC/B;AAED,+CAA+C;AAC/C,MAAM,WAAW,iBAAiB;IAChC,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAA;IAChB,kCAAkC;IAClC,YAAY,EAAE,KAAK,CAAA;IACnB,2CAA2C;IAC3C,KAAK,EAAE,KAAK,CAAC,eAAe,CAAC,CAAA;CAC9B;AAED,mCAAmC;AACnC,MAAM,WAAW,gBAAgB;IAC/B,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,6CAA6C;IAC7C,iBAAiB,EAAE,MAAM,CAAA;IACzB,wCAAwC;IACxC,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,4BAA4B;AAC5B,MAAM,MAAM,mBAAmB,GAC3B,SAAS,GACT,WAAW,GACX,QAAQ,GACR,UAAU,GACV,SAAS,GACT,WAAW,CAAA;AAEf,8BAA8B;AAC9B,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,EAAE,CAAA;IACN,SAAS,EAAE,EAAE,CAAA;IACb,UAAU,EAAE,EAAE,CAAA;IACd,MAAM,EAAE,mBAAmB,CAAA;IAC3B,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,8DAA8D;IAC9D,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IACzB,wBAAwB;IACxB,WAAW,EAAE,iBAAiB,CAAA;IAC9B,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,wBAAwB;IACxB,UAAU,EAAE,KAAK,CAAA;IACjB,mCAAmC;IACnC,aAAa,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IAC3B,wCAAwC;IACxC,eAAe,EAAE,OAAO,CAAA;IACxB,wBAAwB;IACxB,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IACtB,uBAAuB;IACvB,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,0CAA0C;AAC1C,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB"}

package/dist/rental.js

@@ -0,0 +1,5 @@
+// ---------------------------------------------------------------------------
+// Rental / booking types
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=rental.js.map

package/dist/rental.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rental.js","sourceRoot":"","sources":["../src/rental.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E"}

package/dist/return.d.ts

@@ -0,0 +1,64 @@
+import type { Id, Image, LocalizedString, Maybe, Price } from './common.js';
+/** Reason for returning an item */
+export type ReturnReason = 'defective' | 'wrong_item' | 'not_as_described' | 'changed_mind' | 'size_fit' | 'arrived_late' | 'damaged_in_shipping' | 'other';
+/** Return request status lifecycle */
+export type ReturnStatus = 'requested' | 'approved' | 'rejected' | 'shipped' | 'received' | 'refunded' | 'cancelled';
+/** Refund method — how the money is returned */
+export type RefundMethod = 'original_payment' | 'store_credit' | 'bank_transfer' | 'wallet';
+/** A single item within a return request */
+export interface ReturnItem {
+    id: Id;
+    /** Original order item ID */
+    orderItemId: Id;
+    productId: Id;
+    variantId: Maybe<Id>;
+    name: LocalizedString;
+    image: Maybe<Image>;
+    /** Quantity being returned */
+    quantity: number;
+    /** Reason for this item's return */
+    reason: ReturnReason;
+    /** Customer's description of the issue */
+    reasonNote: Maybe<string>;
+    /** Photos of damage / issue (customer-uploaded) */
+    evidenceImages: Image[];
+}
+/** Input for creating a return request */
+export interface CreateReturnInput {
+    /** Order ID to return items from */
+    orderId: string;
+    /** Items to return */
+    items: Array<{
+        orderItemId: string;
+        quantity: number;
+        reason: ReturnReason;
+        reasonNote?: string;
+    }>;
+    /** Preferred refund method */
+    preferredRefundMethod?: RefundMethod;
+}
+/** A return request entity */
+export interface ReturnRequest {
+    id: Id;
+    /** Original order ID */
+    orderId: Id;
+    /** Original order number (for display) */
+    orderNumber: string;
+    status: ReturnStatus;
+    items: ReturnItem[];
+    /** Total refund amount */
+    refundAmount: Maybe<Price>;
+    /** How the refund will be processed */
+    refundMethod: Maybe<RefundMethod>;
+    /** Return shipping label URL (provided by merchant) */
+    returnShippingLabel: Maybe<string>;
+    /** Tracking number for return shipment */
+    returnTrackingNumber: Maybe<string>;
+    /** Merchant notes (e.g., rejection reason) */
+    merchantNote: Maybe<string>;
+    /** Customer notes */
+    customerNote: Maybe<string>;
+    createdAt: string;
+    updatedAt: string;
+}
+//# sourceMappingURL=return.d.ts.map

package/dist/return.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"return.d.ts","sourceRoot":"","sources":["../src/return.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAE3E,mCAAmC;AACnC,MAAM,MAAM,YAAY,GACpB,WAAW,GACX,YAAY,GACZ,kBAAkB,GAClB,cAAc,GACd,UAAU,GACV,cAAc,GACd,qBAAqB,GACrB,OAAO,CAAA;AAEX,sCAAsC;AACtC,MAAM,MAAM,YAAY,GACpB,WAAW,GACX,UAAU,GACV,UAAU,GACV,SAAS,GACT,UAAU,GACV,UAAU,GACV,WAAW,CAAA;AAEf,gDAAgD;AAChD,MAAM,MAAM,YAAY,GACpB,kBAAkB,GAClB,cAAc,GACd,eAAe,GACf,QAAQ,CAAA;AAEZ,4CAA4C;AAC5C,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,EAAE,CAAA;IACN,6BAA6B;IAC7B,WAAW,EAAE,EAAE,CAAA;IACf,SAAS,EAAE,EAAE,CAAA;IACb,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,CAAA;IACpB,IAAI,EAAE,eAAe,CAAA;IACrB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IACnB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,oCAAoC;IACpC,MAAM,EAAE,YAAY,CAAA;IACpB,0CAA0C;IAC1C,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IACzB,mDAAmD;IACnD,cAAc,EAAE,KAAK,EAAE,CAAA;CACxB;AAED,0CAA0C;AAC1C,MAAM,WAAW,iBAAiB;IAChC,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAA;IACf,sBAAsB;IACtB,KAAK,EAAE,KAAK,CAAC;QACX,WAAW,EAAE,MAAM,CAAA;QACnB,QAAQ,EAAE,MAAM,CAAA;QAChB,MAAM,EAAE,YAAY,CAAA;QACpB,UAAU,CAAC,EAAE,MAAM,CAAA;KACpB,CAAC,CAAA;IACF,8BAA8B;IAC9B,qBAAqB,CAAC,EAAE,YAAY,CAAA;CACrC;AAED,8BAA8B;AAC9B,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,EAAE,CAAA;IACN,wBAAwB;IACxB,OAAO,EAAE,EAAE,CAAA;IACX,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,YAAY,CAAA;IACpB,KAAK,EAAE,UAAU,EAAE,CAAA;IACnB,0BAA0B;IAC1B,YAAY,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IAC1B,uCAAuC;IACvC,YAAY,EAAE,KAAK,CAAC,YAAY,CAAC,CAAA;IACjC,uDAAuD;IACvD,mBAAmB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IAClC,0CAA0C;IAC1C,oBAAoB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IACnC,8CAA8C;IAC9C,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IAC3B,qBAAqB;IACrB,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IAC3B,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB"}

package/dist/return.js

@@ -0,0 +1,5 @@
+// ---------------------------------------------------------------------------
+// Return & refund types
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=return.js.map

package/dist/return.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"return.js","sourceRoot":"","sources":["../src/return.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E"}