@skalpgg/sdk 1.1.0 → 1.4.0

package/dist/esm/types.d.ts

@@ -1,16 +1,23 @@
 export type Currency = 'EUR' | 'USD' | 'PLN' | (string & {});
-export type FulfillmentType = 'FILE' | 'SERIAL' | 'GAME' | 'SERVICE';
+export type FulfillmentType = 'FILE' | 'SERIAL' | 'GAME' | 'SERVICE' | 'DYNAMIC' | 'LICENSE';
+export type ProductStatus = 'DRAFT' | 'PENDING_REVIEW' | 'PROCESSING' | 'PROCESSING_FAILED' | 'ACTIVE' | 'REJECTED' | 'ARCHIVED';
 export type ProductType = 'ONE_TIME' | 'RECURRING' | 'COINS';
 export type BillingInterval = 'WEEK' | 'MONTH' | 'YEAR';
-export type OrderStatus = 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'REFUNDED' | 'DISPUTED';
+export type OrderStatus = 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'REFUNDED' | 'DISPUTED' | 'CANCELED';
+export type PaymentProvider = 'STRIPE' | 'NOWPAYMENTS' | 'PAYPAL';
+export type DeliveryStatus = 'PENDING' | 'PROCESSING' | 'DELIVERED' | 'FAILED';
 export type SubscriptionStatus = 'ACTIVE' | 'CANCELED' | 'PAST_DUE' | 'UNPAID' | 'INCOMPLETE' | 'INCOMPLETE_EXPIRED' | 'TRIALING' | 'PAUSED';
 export type Metadata = Record<string, string>;
 export interface CreateCheckoutParams {
     productId: string;
+    /** Units to sell, within the product's minQuantity and maxQuantity. Defaults to minQuantity. */
+    quantity?: number;
     customerEmail?: string;
     metadata?: Metadata;
     couponCode?: string;
     returnUrl?: string;
+    /** Answers you already have, by field key; the buyer adds the rest on the pay page. */
+    customFields?: Record<string, string>;
 }
 export interface CheckoutSession {
     id: string;
@@ -34,28 +41,534 @@ export interface Order {
     amount: number;
     netAmount: number | null;
     vatAmount: number | null;
+    vatRate: number | null;
     currency: Currency;
+    discountAmount: number;
+    couponCode: string | null;
     productId: string;
     productName: string;
     productSlug: string;
+    /** Units of productId. */
+    quantity: number;
     fulfillmentType: FulfillmentType;
+    bundleId: string | null;
     buyerEmail: string;
+    buyerCountry: string | null;
+    paymentProvider: PaymentProvider | null;
+    isGift: boolean;
+    granted?: boolean;
+    deliveryStatus: DeliveryStatus | null;
     serialsCount?: number;
+    serialsReplaced?: number;
+    /** Delivered and replaced keys by id, never their values. Only orders.get and orders.cancel fill it in. */
+    serials?: Array<OrderSerial>;
     createdAt: string;
+    updatedAt: string;
     completedAt: string | null;
     metadata: Metadata;
+    /** One entry per product: a bundle or a cart order has several. */
+    items?: Array<OrderItem>;
+    replacements?: Array<OrderReplacement>;
+}
+export interface OrderSerial {
+    id: string;
+    productId: string;
+    status: 'DELIVERED' | 'REPLACED';
+    deliveredAt: string | null;
+    /** The serial that took this one's place, once replaced. */
+    replacedById: string | null;
+}
+export interface OrderReplacement {
+    id: string;
+    productId: string;
+    oldSerialId: string | null;
+    newSerialId: string | null;
+    reason: string | null;
+    source: string;
+    createdAt: string;
+}
+export interface ListOrdersParams {
+    status?: OrderStatus;
+    productId?: string;
+    email?: string;
+    createdAfter?: string | Date;
+    createdBefore?: string | Date;
+    updatedSince?: string | Date;
+    limit?: number;
+    offset?: number;
+}
+export interface OrderList {
+    data: Array<Order>;
+    total: number;
+    limit: number;
+    offset: number;
+}
+export interface ReplaceOrderKeysParams {
+    serialIds?: Array<string>;
+    values?: Array<string>;
+    reason?: string;
+}
+export interface OrderKeyReplacement {
+    productId: string;
+    productName: string;
+    oldSerialId: string;
+    newSerialId: string;
+    value: string;
+}
+export interface OrderKeysReplaced {
+    orderId: string;
+    replacements: Array<OrderKeyReplacement>;
+}
+export interface OrderItem {
+    productId: string;
+    name: string;
+    /** Per unit, after every discount. */
+    price: number | null;
+    quantity: number;
+    /** The buyer's answers to the product's custom fields. */
+    customFields: Record<string, string>;
+}
+/** Another product of the store, discountPercent off when bought with this one. */
+export interface ProductSale {
+    title: string | null;
+    discountPercent: number;
+    price: number;
+    endsAt: string;
+    remaining: number | null;
+}
+export interface ProductUpsell {
+    productId: string;
+    discountPercent: number;
+}
+export interface ProductUpsellInput {
+    productId: string;
+    /** 0 to 90; defaults to 0. */
+    discountPercent?: number;
+}
+/** An order of at least quantity units costs percent less. */
+export interface VolumeDiscount {
+    quantity: number;
+    percent: number;
+}
+export type CustomFieldType = 'text' | 'textarea' | 'number' | 'email' | 'checkbox' | 'select' | 'hidden';
+/** A question the buyer answers at checkout. */
+export interface CustomField {
+    key: string;
+    label: string;
+    type: CustomFieldType;
+    required: boolean;
+    placeholder: string | null;
+    options: Array<string>;
 }
+export interface CustomFieldInput {
+    /** Lowercase letters, digits and underscores, starting with a letter. */
+    key: string;
+    label: string;
+    type: CustomFieldType;
+    required?: boolean;
+    placeholder?: string | null;
+    /** For select: up to 20 choices. */
+    options?: Array<string>;
+}
+export type DeliveryType = 'COMMAND' | 'SQL';
+/**
+ * PUBLIC is listed and buyable, UNLISTED is buyable from its link only,
+ * ON_HOLD is listed but not buyable, PRIVATE sells only through the API.
+ */
+export type ProductVisibility = 'PUBLIC' | 'UNLISTED' | 'ON_HOLD' | 'PRIVATE';
 export interface Product {
     id: string;
+    storeId: string;
     name: string;
     slug: string;
+    description: string;
+    shortDescription: string | null;
     price: number;
+    comparePrice: number | null;
     currency: Currency;
-    fulfillmentType: FulfillmentType;
+    status: ProductStatus;
+    rejectionReason: string | null;
     productType: ProductType;
     billingInterval: BillingInterval | null;
     trialPeriodDays: number;
-    stock?: number;
+    fulfillmentType: FulfillmentType | null;
+    category: string;
+    categoryId: string | null;
+    storeCategoryId: string | null;
+    tags: Array<string>;
+    images: Array<string>;
+    videoUrl: string | null;
+    licenseDeviceLimit: number;
+    licenseDurationDays: number | null;
+    dynamicUrl: string | null;
+    /** Server stores: COMMAND or SQL. */
+    deliveryType: DeliveryType | null;
+    /** Server stores: what the game server runs after payment. */
+    deliveryPayload: string | null;
+    visibility: ProductVisibility;
+    /** Higher comes first on the store page. */
+    sortPriority: number;
+    /** Shown to the buyer after paying. */
+    deliveryNote: string | null;
+    /** The buyer accepts them before paying. */
+    termsOfService: string | null;
+    warrantyDays: number | null;
+    warrantyText: string | null;
+    blockVpn: boolean;
+    maxRiskScore: number | null;
+    customFields: Array<CustomField>;
+    minQuantity: number;
+    /** null allows up to 1000. */
+    maxQuantity: number | null;
+    volumeDiscounts: Array<VolumeDiscount>;
+    /** Products offered on this product's checkout page. */
+    upsells: Array<ProductUpsell>;
+    stock: number | null;
+    sale: ProductSale | null;
+    salesCount: number;
+    rating: number | null;
+    reviewCount: number;
+    url: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ListProductsParams {
+    status?: ProductStatus | 'all';
+}
+interface ProductFields {
+    slug?: string;
+    description?: string;
+    shortDescription?: string;
+    category?: string;
+    categoryId?: string;
+    storeCategoryId?: string | null;
+    tags?: Array<string>;
+    images?: Array<string>;
+    videoUrl?: string;
+    fulfillmentType?: FulfillmentType;
+    billingInterval?: BillingInterval;
+    trialPeriodDays?: number;
+    dynamicUrl?: string | null;
+    licenseDeviceLimit?: number;
+    licenseDurationDays?: number | null;
+    /** Required for a server store, refused for the others. */
+    deliveryType?: DeliveryType;
+    /** Required for a server store; needs a placeholder such as {steamhex}. */
+    deliveryPayload?: string;
+    visibility?: ProductVisibility;
+    sortPriority?: number;
+    /** null or an empty string clears it. */
+    deliveryNote?: string | null;
+    /** null or an empty string clears it. */
+    termsOfService?: string | null;
+    warrantyDays?: number | null;
+    warrantyText?: string | null;
+    blockVpn?: boolean;
+    maxRiskScore?: number | null;
+    /** Up to 10 questions; the list replaces the old one, [] or null removes them all. */
+    customFields?: Array<CustomFieldInput> | null;
+    /** SERIAL, LICENSE, SERVICE and GAME one-time products only. */
+    minQuantity?: number;
+    maxQuantity?: number | null;
+    /** Up to 10 tiers; the list replaces the old one, [] or null removes them all. */
+    volumeDiscounts?: Array<VolumeDiscount> | null;
+    /** Up to 3 one-time products of the store; the list replaces the old one, [] or null removes them all. */
+    upsells?: Array<ProductUpsellInput> | null;
+}
+export interface CreateProductParams extends ProductFields {
+    name: string;
+    price: number;
+    comparePrice?: number;
+    productType?: 'ONE_TIME' | 'RECURRING';
+    submit?: boolean;
+}
+export interface UpdateProductParams extends ProductFields {
+    name?: string;
+    price?: number;
+    comparePrice?: number | null;
+    status?: 'DRAFT' | 'ARCHIVED';
+}
+export interface ProductStock {
+    productId: string;
+    available: number;
+    delivered: number;
+    revoked: number;
+    total: number;
+}
+export type SerialStatus = 'AVAILABLE' | 'DELIVERED' | 'REVOKED';
+export type SerialSource = 'POOL' | 'DYNAMIC' | 'MANUAL';
+export interface Serial {
+    id: string;
+    value: string;
+    status: SerialStatus | 'REPLACED';
+    source: SerialSource;
+    orderId: string | null;
+    createdAt: string;
+    deliveredAt: string | null;
+}
+export interface ListSerialsParams {
+    status?: SerialStatus;
+    limit?: number;
+    offset?: number;
+}
+export interface SerialList {
+    data: Array<Serial>;
+    total: number;
+    limit: number;
+    offset: number;
+}
+export interface AddSerialsParams {
+    serials?: Array<string>;
+    text?: string;
+    delimiter?: 'newline' | 'comma' | 'semicolon' | (string & {});
+}
+export interface AddSerialsResult {
+    added: number;
+    skipped: number;
+    stock: number;
+}
+export interface Deleted {
+    id: string;
+    deleted: true;
+}
+export interface StoreCategory {
+    id: string;
+    name: string;
+    sortOrder: number;
+    createdAt: string;
+}
+export interface StoreCategoryWithCount extends StoreCategory {
+    activeProducts: number;
+}
+export interface CreateStoreCategoryParams {
+    name: string;
+}
+export interface UpdateStoreCategoryParams {
+    name?: string;
+    sortOrder?: number;
+}
+export interface ProductGroupItem {
+    id: string;
+    name: string;
+    slug: string;
+    status: ProductStatus;
+    price: number;
+}
+export interface ProductGroup {
+    id: string;
+    storeId: string;
+    title: string;
+    description: string | null;
+    image: string | null;
+    sortPriority: number;
+    unlisted: boolean;
+    productIds: Array<string>;
+    products: Array<ProductGroupItem>;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateProductGroupParams {
+    title: string;
+    productIds: Array<string>;
+    description?: string | null;
+    image?: string | null;
+    sortPriority?: number;
+    unlisted?: boolean;
+}
+export interface UpdateProductGroupParams {
+    title?: string;
+    productIds?: Array<string>;
+    description?: string | null;
+    image?: string | null;
+    sortPriority?: number;
+    unlisted?: boolean;
+}
+export type CouponDiscountType = 'PERCENT' | 'FIXED';
+export interface Coupon {
+    id: string;
+    code: string;
+    description: string | null;
+    discountType: CouponDiscountType;
+    discountPercent: number | null;
+    discountAmount: number | null;
+    productIds: Array<string>;
+    disabledWithVolumeDiscounts: boolean;
+    validFrom: string;
+    validTo: string | null;
+    maxUses: number | null;
+    usedCount: number;
+    minPurchaseAmount: number | null;
+    oneTimePerUser: boolean;
+    isActive: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateCouponParams {
+    code: string;
+    discountType?: CouponDiscountType;
+    discountPercent?: number;
+    discountAmount?: number;
+    productIds?: Array<string>;
+    disabledWithVolumeDiscounts?: boolean;
+    description?: string;
+    validFrom?: string | Date;
+    validTo?: string | Date;
+    maxUses?: number;
+    minPurchaseAmount?: number;
+    oneTimePerUser?: boolean;
+}
+export interface UpdateCouponParams {
+    discountType?: CouponDiscountType;
+    discountPercent?: number;
+    discountAmount?: number;
+    productIds?: Array<string>;
+    disabledWithVolumeDiscounts?: boolean;
+    description?: string | null;
+    validFrom?: string | Date;
+    validTo?: string | Date | null;
+    maxUses?: number | null;
+    minPurchaseAmount?: number | null;
+    oneTimePerUser?: boolean;
+    isActive?: boolean;
+}
+export interface Customer {
+    id: string;
+    email: string;
+    name: string | null;
+    note: string | null;
+    country: string | null;
+    ordersCount: number;
+    totalSpent: number;
+    currency: Currency;
+    firstOrderAt: string | null;
+    lastOrderAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CustomerDetails extends Customer {
+    recentOrders: Array<Order>;
+}
+export interface ListCustomersParams {
+    search?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface CustomerList {
+    data: Array<Customer>;
+    total: number;
+    limit: number;
+    offset: number;
+}
+export interface CreateCustomerParams {
+    email: string;
+    name?: string;
+    note?: string;
+}
+export interface UpdateCustomerParams {
+    name?: string | null;
+    note?: string | null;
+}
+export interface FeedbackReply {
+    id: string;
+    content: string;
+    createdAt: string;
+}
+export type FeedbackAppealStatus = 'PENDING' | 'ACCEPTED' | 'REJECTED';
+export interface FeedbackAppeal {
+    id: string;
+    status: FeedbackAppealStatus;
+    reason: string;
+    adminNote: string | null;
+    createdAt: string;
+    resolvedAt: string | null;
+}
+export interface Feedback {
+    id: string;
+    productId: string;
+    productName: string;
+    rating: number;
+    title: string | null;
+    content: string | null;
+    customerName: string | null;
+    verified: boolean;
+    helpfulCount: number;
+    replies: Array<FeedbackReply>;
+    appeal: FeedbackAppeal | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ListFeedbackParams {
+    productId?: string;
+    rating?: number;
+    limit?: number;
+    offset?: number;
+}
+export interface FeedbackList {
+    data: Array<Feedback>;
+    total: number;
+    limit: number;
+    offset: number;
+}
+export interface ReplyParams {
+    message: string;
+}
+export interface AppealFeedbackParams {
+    reason: string;
+}
+export type QueryStatus = 'PENDING' | 'SHOP_REPLY' | 'CUSTOMER_REPLY' | 'CLOSED';
+export interface QueryMessage {
+    id: string;
+    content: string;
+    from: 'customer' | 'shop';
+    createdAt: string;
+}
+export interface SupportQuery {
+    id: string;
+    title: string | null;
+    status: QueryStatus;
+    customerEmail: string;
+    customerName: string | null;
+    productId: string | null;
+    productName: string | null;
+    orderId: string | null;
+    orderNumber: string | null;
+    messageCount: number;
+    lastMessage: QueryMessage | null;
+    closedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface SupportQueryDetails extends SupportQuery {
+    messages: Array<QueryMessage>;
+}
+export interface ListQueriesParams {
+    status?: QueryStatus;
+    limit?: number;
+    offset?: number;
+}
+export interface SupportQueryList {
+    data: Array<SupportQuery>;
+    total: number;
+    limit: number;
+    offset: number;
+}
+export type AccessList = 'BLACKLIST' | 'WHITELIST';
+export type AccessRuleType = 'EMAIL' | 'IP' | 'COUNTRY' | 'ISP' | 'ASN' | 'HOST';
+export interface AccessRule {
+    id: string;
+    list: AccessList;
+    type: AccessRuleType;
+    value: string;
+    note: string | null;
+    createdAt: string;
+}
+export interface ListAccessRulesParams {
+    type?: AccessRuleType;
+}
+export interface AddAccessRuleParams {
+    type: AccessRuleType;
+    value: string;
+    note?: string;
 }
 export interface CreateSubscriptionCheckoutParams {
     productId?: string;
@@ -118,6 +631,14 @@ export interface SubscriptionList {
     limit: number;
     offset: number;
 }
+export interface InvoiceLine {
+    description: string | null;
+    amount: number;
+    currency: Currency;
+    periodStart: string;
+    periodEnd: string;
+    usageChargeId?: string;
+}
 export interface Invoice {
     id: string;
     number: string | null;
@@ -128,6 +649,46 @@ export interface Invoice {
     status: string | null;
     hostedUrl: string | null;
     pdfUrl: string | null;
+    lines: Array<InvoiceLine>;
+}
+export interface CreateUsageChargeParams {
+    amount: number;
+    currency: 'EUR' | 'USD' | 'PLN';
+    description: string;
+    idempotencyKey: string;
+    periodStart: string | Date;
+    periodEnd: string | Date;
+}
+export interface UsageCharge {
+    id: string;
+    invoiceId: string | null;
+    hostedUrl: string | null;
+    amount: number;
+    currency: Currency;
+    status: 'paid' | 'open' | 'pending';
+}
+export interface CreateCoinCheckoutParams {
+    steamHex: string;
+    coins: number;
+    idempotencyKey?: string;
+    returnUrl?: string;
+}
+export interface CoinCheckout {
+    checkoutUrl: string;
+    reference: string;
+    coins: number;
+    baseCoins: number;
+    bonusCoins: number;
+    amount: number;
+    amountIsNet: boolean;
+    currency: Currency;
+    expiresAt: string;
+}
+export interface CoinCheckoutStatus {
+    status: 'pending' | 'paid' | 'failed' | 'refunded';
+    coins: number;
+    deliveryStatus: DeliveryStatus | null;
+    paidAt: string | null;
 }
 export interface VerifyLicenseParams {
     licenseKey: string;
@@ -136,6 +697,36 @@ export interface VerifyLicenseParams {
     serverPort?: number;
 }
 export type LicenseError = 'INVALID_FORMAT' | 'INVALID_LICENSE' | 'LICENSE_INACTIVE' | 'LICENSE_EXPIRED' | 'PRODUCT_INACTIVE' | 'SERVER_NOT_ACTIVATED' | 'SERVER_KEY_REQUIRED' | 'SERVER_KEY_MISMATCH' | 'RATE_LIMITED' | 'REPLAY_DETECTED' | (string & {});
+export interface ValidateLicenseParams {
+    key: string;
+    productId?: string;
+    hardwareId?: string;
+}
+export interface ResetLicenseDevicesParams {
+    key: string;
+    hardwareId?: string;
+}
+export type LicenseCheckCode = 'VALID' | 'NOT_FOUND' | 'PRODUCT_MISMATCH' | 'LICENSING_DISABLED' | 'REVOKED' | 'SUSPENDED' | 'EXPIRED' | 'SUBSCRIPTION_INACTIVE' | 'DEVICE_LIMIT_REACHED';
+export interface LicenseKeyInfo {
+    key: string;
+    status: 'ACTIVE' | 'SUSPENDED' | 'REVOKED' | 'EXPIRED';
+    productId: string;
+    productName: string;
+    orderId: string | null;
+    subscriptionId: string | null;
+    createdAt: string;
+    expiresAt: string | null;
+    devices: {
+        used: number;
+        limit: number | null;
+    };
+}
+export interface LicenseValidation {
+    valid: boolean;
+    code: LicenseCheckCode;
+    message: string;
+    license?: LicenseKeyInfo;
+}
 export interface LicenseVerification {
     valid: boolean;
     error?: LicenseError;
@@ -182,6 +773,7 @@ export interface OrderPaidData {
     amount: number;
     currency: Currency;
     quantity: number;
+    granted?: boolean;
     coins?: number;
     baseCoins?: number;
     bonusCoins?: number;
@@ -189,19 +781,24 @@ export interface OrderPaidData {
     steamhex: string | null;
     identifier: string | null;
     metadata: Metadata;
+    /** The buyer's answers to the product's custom fields. */
+    customFields: Record<string, string>;
     deliveryType?: string;
     deliveryCommand?: string;
 }
 export interface OrderRefundedData {
     orderId: string;
     orderNumber: string;
-    refundId: string;
+    refundId: string | null;
     amount: number;
     reason: string | null;
     identifier: string | null;
     steamHex: string | null;
     coins?: number;
     giftRecipient: boolean;
+    granted?: boolean;
+    fullRefund: boolean;
+    licenses: Array<WebhookLicense>;
 }
 export interface OrderDisputedData {
     orderId: string;
@@ -210,8 +807,9 @@ export interface OrderDisputedData {
     reason: string;
     steamHex: string | null;
     identifier: string | null;
-    coins?: number;
+    coins: number;
     banned: boolean;
+    licenses: Array<WebhookLicense>;
 }
 export interface AccountRestoreData {
     identifier: string;
@@ -237,14 +835,75 @@ export interface SubscriptionEventData {
     canceledAt: string | null;
     trialEnd: string | null;
     metadata: Metadata;
+    identifier: string | null;
+    steamhex: string | null;
     idempotencyKey: string;
+    licenseId: string | null;
+    licenseKey: string | null;
+    licenseStatus: string | null;
+    licenseExpiresAt: string | null;
+}
+export interface ProductEventData {
+    productId: string;
+    productName: string;
+    productSlug: string;
+    status: ProductStatus;
+    price: number;
+    fulfillmentType: FulfillmentType | null;
+    productType: ProductType;
+}
+export interface ProductStockData {
+    productId: string;
+    productName: string;
+    productSlug: string;
+    stock: number;
+    previousStock: number;
+    change: number;
 }
 export interface WebhookTestData {
     message: string;
     webhookId: string;
     sample: Partial<OrderPaidData>;
 }
-export type SkalpEvent = Envelope<'order.paid' | 'purchase.completed', OrderPaidData> | Envelope<'order.refunded', OrderRefundedData> | Envelope<'order.disputed' | 'account.suspend', OrderDisputedData> | Envelope<'account.restore', AccountRestoreData> | Envelope<'subscription.created' | 'subscription.updated', SubscriptionEventData> | Envelope<'subscription.renewed', SubscriptionEventData & {
+export type OrderEventData = Omit<Order, 'serialsCount' | 'serialsReplaced' | 'serials' | 'replacements'> & {
+    previousStatus: OrderStatus | null;
+    /** Dedupe key: `order.created:<orderId>`, `order.updated:<orderId>:<transition>` or `order.canceled:<orderId>`. */
+    idempotencyKey: string;
+};
+export interface OrderReplacedData extends Omit<Order, 'serialsCount' | 'serialsReplaced' | 'serials' | 'replacements'> {
+    /** Dedupe key: `order.replaced:<orderId>:<first new serial id>`. */
+    idempotencyKey: string;
+    reason: string | null;
+    replacements: Array<OrderKeyReplacement>;
+}
+export interface QueryEventData {
+    /** Dedupe key: `query.created:<queryId>` or `query.replied:<messageId>`. */
+    idempotencyKey: string;
+    queryId: string;
+    title: string;
+    status: QueryStatus;
+    customerEmail: string;
+    productId: string | null;
+    orderId: string | null;
+    message: {
+        id: string;
+        content: string;
+        createdAt: string;
+    };
+}
+export interface FeedbackReceivedData {
+    /** Dedupe key: `feedback.received:<feedbackId>`. */
+    idempotencyKey: string;
+    feedbackId: string;
+    productId: string;
+    productName: string;
+    rating: number;
+    title: string | null;
+    content: string | null;
+    customerName: string | null;
+    createdAt: string;
+}
+export type SkalpEvent = Envelope<'order.created' | 'order.updated' | 'order.canceled', OrderEventData> | Envelope<'order.replaced', OrderReplacedData> | Envelope<'order.paid' | 'purchase.completed', OrderPaidData> | Envelope<'order.refunded', OrderRefundedData> | Envelope<'order.disputed' | 'account.suspend', OrderDisputedData> | Envelope<'account.restore', AccountRestoreData> | Envelope<'subscription.created' | 'subscription.updated' | 'subscription.trial_started' | 'subscription.trial_ended' | 'subscription.upcoming', SubscriptionEventData> | Envelope<'subscription.renewed', SubscriptionEventData & {
     invoiceId: string;
     amountPaid: number;
     periodExtendedTo: string;
@@ -254,7 +913,16 @@ export type SkalpEvent = Envelope<'order.paid' | 'purchase.completed', OrderPaid
     nextPaymentAttempt: string | null;
 }> | Envelope<'subscription.canceled', SubscriptionEventData & {
     endedAt: string | null;
-    cancelReason: 'requested' | 'payment_failure' | 'stripe';
-}> | Envelope<'webhook.test', WebhookTestData>;
+    cancelReason: 'requested' | 'payment_failure' | 'dispute' | 'stripe';
+}> | Envelope<'subscription.refunded', SubscriptionEventData & {
+    invoiceId: string;
+    amountRefunded: number;
+    fullyRefunded: boolean;
+}> | Envelope<'subscription.disputed', SubscriptionEventData & {
+    invoiceId: string;
+    disputeId: string;
+    disputeStatus: 'open' | 'won' | 'lost';
+    disputeReason: string | null;
+}> | Envelope<'product.created' | 'product.updated', ProductEventData> | Envelope<'product.stock', ProductStockData> | Envelope<'query.created' | 'query.replied', QueryEventData> | Envelope<'feedback.received', FeedbackReceivedData> | Envelope<'webhook.test', WebhookTestData>;
 export type SkalpEventType = SkalpEvent['type'];
 export {};